thread_syntax — Apollo


DSEE CONFIGURATION THREAD RULE SYNTAX
(see also SET THREAD and EDIT THREAD)

Name            Syntax

comment         "#"text *

configuration_thread_rule **

                [rule_qualifier] {version_rule | build_option_rule}
                | [rule_qualifier] version_rule build_option_rule
                | [rule_qualifier] build_id_based_rule

rule_qualifier ***
                [-UNDER build_unit_specifier [-CONTEXT context]]
                [-FOR { wildcard_name | "'"wildcard_name @ library_id"'"}]

version_rule    "["version_name"]" [-WHEN_EXISTS]
                | branch_path [-WHEN_EXISTS | -WHEN_ACTIVE]
                | ".../"branch_name [-WHEN_EXISTS| -WHEN_ACTIVE]
                | [branch_path] "[" [version_number] "]"
                | -FROM pathname
                | -RESERVED

build_option_rule

                [-EXACT] -USE_OPTIONS [o1 o2 ...]
                | [-EXACT] -USE_OPTIONS

build_id_based_rule

                full_build_name {-VERSIONS | -OPTIONS [-EXACT] [-WHEN_EXISTS}
                | full_build_name -VERSIONS -OPTIONS [-EXACT] [-WHEN_EXISTS]

Semantic Notes:

*   The pound sign (#) denoting a comment must be in column one.
    DSEE ignores the entire line of text following the pound sign.

**  Only one configuration thread rule can appear on each line.

*** No -for clause implies "-for ?*"


Examples

   # use reserved copy if reserved, otherwise most recent
   # this is the default thread created by SET THREAD -DEFAULT
   -reserved
   []

   # use reserved copy in debug mode if reserved, otherwise most recent
   -reserved -use -DBS
   []

   # same as above
   -for ?* -reserved -use -DBS
   -for ?* []

   # everything should be compiled with -CONFIG DN660
   # use reserved copy or branch /BUGFIX (if there is one) with -DBS
   # otherwise, use the [SR9_BL16] version
   -for ?*.PAS -use -CONFIG DN660
   -reserved -use -DBS -CONFIG DN660
   /BUGFIX -when_exists -use -DBS -CONFIG DN660
   [SR9_BL16] -when_exists


   # use my reserved copies, Fred's reserved copy of PARSER.PAS,
   # and all other sources of the CALC system from the PROTO1 release-area.
   # Both version specifications and options are taken from PROTO1.
   -reserved -use -DBS
   -for PARSER.PAS -from //ZAPHOD/FRED/PARSER.PAS
   CALC!//ENVY/RELEASES/PROTO1 -versions -options




 DSEE MODEL THREAD SYNTAX
 (SEE ALSO SET THREAD, EDIT THREAD, AND EXAMINE THREAD)

 comment     "#"text *

 model_thread_rule **
        {[rule_qualifier] version_rule | target_rule}

 rule_qualifier ***
        -FOR {wildcard_name | "'"wildcard_name @@ library_pname"'"}

 version_rule
        "["version_name"]" [-WHEN_EXISTS]
        | branch_path [-WHEN_EXISTS]
        | "@b[...]/"branch_name [-WHEN_EXISTS]
        | [branch_path] "[" [version_number] "]"
        | -FROM pathname
        | -RESERVED
        | -release_build_name

 target_rule ****
        -TARGET target_string
        | -TARGET release_build_name>

 Semantic Notes:

 *    The pound sign (#) that denotes a comment must be in column one.
      DSEE does not validate the text following the pound sign.

 **   Only one model thread rule can appear on each line.

 ***  Libraries containing system model elements must be identified
      by pathnames rather than logical names.

 **** A model thread can contain, at most, one target_rule.
Museum
