Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought


DSEE Branch Syntax:


branch_name

Identifies a branch by leaf name.

Format

name

Description

Some   commands   that  operate  on  elements  take  the  branch_name  argument.
Branch_name is the name you assign to a branch, or alternate line of descent for
an element. For example,

DSEE> create branch ucr27 trig.pas

creates  a  branch  called  ucr27  off  of  the  most  recent version of element
trig.pas.

The branch_name argument differs from the branch_path argument.   A  branch_path
argument is the naming path of a branch, from the element's main line of descent
down to the leaf branch.  A branch_name is simply the leaf name of the branch.


branch_path

Identifies a branch by pathname.

Formats

name[/name...]

.../branch_name

/

Description

Some commands that operate  on  elements  take  the  branch_path  argument.    A
branch_path  consists  of  one or more branch names, where multiple branch names
are separated by slashes; for example, br1, br1/br2.  The command

DSEE> reserve alpha/fix22

reserves fix22, which is a branch off of alpha.  Similarly,

DSEE> reserve alpha/br1/br2

reserves br2, a branch off br1, which is, in turn, a branch off of alpha.

You can also use a shorthand notation for a branch_path;  the  format  for  this
notation  is  .../branch_name.   This type of branch_path specification is handy
because  you  only  have  to  remember  a  branch  leaf  name,  not  the  entire
branch_path.   When you use the shorthand notation, the DSEE facility reports an
error if more than one full branch pathname has the specified leaf branch_name.

For certain commands that accept a branch_path argument that is not preceded  by
an  element  name (such as show elements with its -missing -merge -with syntax),
you can use a slash (/) to identify an element's main  line  of  descent.    For
example,  to determine which elements in the current library possessing branches
named bugfix have not had the most recent versions of  bugfix  merged  into  the
main line of descent, you would issue the following command:

DSEE> show elements -missing -merge /bugfix -with /


wildcard_branch_name

Identifies one or more branch leaf names.

Format

wildcard_specification

Description

Some  commands  that operate on elements take the wildcard_branch_name argument.
A wildcard_branch_name is a wildcard  version  of  a  branch  leaf  name.    For
example, If you issue the command

DSEE> show branches ?*bugfix

the  DSEE  facility  tells  you  about  all  the branches off of elements in the
current library that have leaf  names  matching  the  wildcard  ?*bugfix  (e.g.,
arg.pas/V2_bugfix and amt.ftn/V5.1_bugfix).



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026