DSEE Version Specifiers
A version_specifier identifies a version of a DSEE element.
Formats
[branch_path/]"["[number]"]"
"["name"]"
Description
A number of commands that operate on elements take the version_specifier
argument. Version_specifier indicates a particular version of an element or
branch, and is expressed as one of the following:
o A version number enclosed in square brackets and appended to the
element name, such as [5] in sqrt.ftn[5].
o A branch path and a version number (version number enclosed in square
brackets) appended to the element name; for example, branch_1[5], as
in sqrt.ftn/branch_1[5].
Whenever a version number is called for, you may use empty square
brackets, or you may omit the square brackets and version number
entirely to denote the most recent version in a line of descent.
o A version name enclosed in square brackets and appended to the element
name; for example, [sr5] as in sqrt.ftn[sr5]. The name must be a name
previously assigned by the name version command.
All DSEE commands that accept a version number will accept a legally assigned
version name instead. For example, the following commands are both legal:
DSEE> compare alpha[4] alpha[5]
DSEE> compare alpha[sr5] alpha[sr6]
Do not append a version name to a branch. For example, if alpha/branch1[5] was
named sr5, refer to it as alpha[sr5], not as alpha/branch1[sr5]. The branch name
is unnecessary because the version name stands for both the branch name and the
version number.
Wildcard Version Specifiers:
A wildcard_version_specifier identifies a particular version of one or more elements.
Formats
wildcard_element_name[/branch_path]["["version_number"]"]
wildcard_element_name"["version_name"]"
Description
Some commands, such as name version, show version, and set environment, accept a
wildcard_version_specifier; that is, a text string that matches a particular
version of more than one element. Use one of the following forms for a
wildcard_version_specifier:
o Wildcard_element_name, for example ?*.pas, to indicate the most recent
versions of elements that match the wildcard ?*.pas.
o Wildcard_element_name/branch_path, for example, ?*.pas/branch1, to
indicate the most recent versions on branch paths that match
?*.pas/branch1 (alpha.pas/branch1, beta.pas/branch1, and so on).
o Wildcard_element_name[version_number], for example, ?*.pas[4], to
indicate the fourth generations of elements that match the wildcard
?*.pas. Note that the version number must be enclosed in square
brackets.
o Wildcard_element_name/branch_path[version_number], for example,
?*.pas/branch1[4] to indicate the fourth generation of branch paths
that match ?*.pas/branch1. The version number must be enclosed in
square brackets.
o Wildcard_element_name[version_name], where version_name is a version
name previously assigned by the name version command. The version name
must be enclosed in square brackets. An example is ?*.pas[sr8].
Note that you can only identify multiple element names, not multiple branch
names, in wildcard version specifications. If you use the .../branch_name
syntax for a branch_path in a version specification, the branch_name can match
only one branch leaf name for each element. Use a full branch pathname to
resolve such ambiguities.
The DSEE facility does not generate a warning if the wildcard element name
portion matches one or more elements but the version specifier does not. For
example, show version ?*.pas[sr8] would not generate a warning if element
alpha.pas did not have a version named sr8. Similarly, show environment ?*.pas
would not generate a warning if alpha.pas had no source reference environment
setting. However, the DSEE facility will return a warning if nothing matches the
wildcard.