lsvtree
Lists version tree of an element
Applicability
Product |
Command type |
---|---|
VersionVault |
cleartool subcommand |
VersionVault Remote Client |
rcleartool subcommand |
Platform |
---|
UNIX® |
Linux® |
Windows® |
Synopsis
- VersionVault on UNIX and Linux only—Display the version tree
in graphical form:
- lsvtree –g/raphical [ –a/ll ] [ –nme/rge ] [ –nco ]
- [ –opt/ions pass-through-opts ] pname ...
- VersionVault on Windows only—Display the version tree in
graphical form:
- lsvtree –g/raphical [ –a/ll ] [ –nme/rge ] [ –nco ] pname ...
- VersionVault and VersionVault Remote Client–list the version tree in the
command window:
- lsvtree [ –nr/ecurse ] [ –s/hort ] [ –a/ll ] [ –mer/ge ] [ –nco ]
- [ –obs/olete ] [ –bra/nch branch-pname ] pname ...
Description
The lsvtree command lists part or all of the version tree of one or more elements. By default, the listing includes all branches of an element's version tree except for obsolete branches. The listing excludes certain versions on the included branches. Command options control which branches, how many branches, and which versions are listed. You can also control the way versions are annotated with version labels and merge arrows.
Restrictions
None.
Options and arguments
Displaying the version tree graphically
- Default
- Lists the version tree in nongraphical form.
- –g/raphical
- Starts a Version Tree Browser for each element you specify as an argument.
Listing subbranches
- Default
- Lists the entire subtree of the branch selected as the starting point.
- –nr/ecurse
- Omits all subbranches from the listing, showing only versions on a single branch.
Selecting and annotating versions on a branch
- Default
- For each branch included in the listing, these selected versions
are listed:
- Checked-out versions (annotated with the view name) and their predecessors
- Versions that are the latest on their branches
- Versions with labels
- Versions at which a subbranch was created
- Versions that are hyperlink endpoints.
A version is annotated with up to five of its version labels; an ellipsis ( ... ) indicates that the version has additional labels.
- –s/hort
- Restricts the listing to version-extended path names. Version labels, merge annotations, and checkout annotations are omitted.
- –a/ll
- Lists all versions on a branch, not the selected versions only; annotates each version with all of its version labels.
- –mer/ge
- Includes all versions that are at the from-end of one or more merge arrows (hyperlinks of type Merge). Annotations on each such version indicate the corresponding to-objects.
- –nme/rge
- Excludes versions that have merge arrows.
- –nco
- Excludes checked-out versions from the listing or display. The predecessor of a checked-out version is also excluded, unless there is another reason to include it (for example, it has a version label).
Listing obsolete branches
- Default
- Obsolete branches (locked with the –obsolete option) and instances of obsolete branch types are not listed.
- –obs/olete
- Lists obsolete branches and instances of obsolete branch types.
Graphical options
- Default
- None.
- –opt/ions pass-through-options
- Specifies one or more
xversionvault
command options that are not directly supported on the lsvtree command line. In particular,xversionvault
accepts all the standard X Toolkit command-line options (for example, –display), as described in the X(1) reference page. If the option string includes white space, enclose it in quotes.
Selecting the starting point
- Default
- Starts the version tree listing at an element's main branch.
- –bra/nch branch-pname
- Starts the version tree listing at the specified branch. You can also use an extended name as the pname argument (for example, foo.c@@\main\bug405) to start the listing at a particular branch.
Specifying the elements or branches
- Default
- None. You must specify at least one element.
- pname ...
- One or more pathnames, specifying elements or branches of elements. (Alternatively, use the –branch option to specify a branch of an element.)
Examples
The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you may need to use different quoting and escaping conventions.
The Windows examples that include wildcards or quoting are written for use in cleartool interactive mode. If you use cleartool single-command mode, you may need to change the wildcards and quoting to make your command interpreter process the command appropriately.
In cleartool single-command mode, cmd-context represents the UNIX system and Linux shells or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt.
- List selected versions from an
element's version tree.
cmd-context lsvtree util.c
util.c@@/main
util.c@@/main/1 (REL2)
util.c@@/main/rel2_bugfix
util.c@@/main/rel2_bugfix/1
util.c@@/main/3 (REL3)
util.c@@/main/4 - List all versions and all obsolete
branches in an element's version tree.
cmd-context lsvtree –all –obsolete util.c
util.c@@\main
util.c@@\main\0
util.c@@\main\1 (REL2)
util.c@@\main\rel2_bugfix
util.c@@\main\rel2_bugfix\0
util.c@@\main\rel2_bugfix\1
util.c@@\main\2
util.c@@\main\3 (REL3)
util.c@@\main\rel3_patch
util.c@@\main\rel3_patch\0
util.c@@\main\rel3_patch\1
util.c@@\main\4 - List all versions on the rel2_bugfix branch
of an element's version tree.
cmd-context lsvtree -branch /main/rel2_bugfix -all util.c
util.c@@/main/rel2_bugfix
util.c@@/main/rel2_bugfix/0
util.c@@/main/rel2_bugfix/1 - Start a version tree browser to
display all versions in an element's version tree.
cmd-context lsvtree –graphical –all util.h