lsvtree
Applicability
Product |
Command type |
---|---|
ClearCase® |
cleartool subcommand |
ClearCase Remote Client |
rcleartool subcommand |
Platform |
---|
UNIX |
Linux |
Windows |
Synopsis
- ClearCase on UNIX and Linux only—Display the version tree in graphical form:
- ClearCase on Windows only—Display the version tree in graphical form:
- ClearCase and ClearCase Remote Client–list the version tree in the command window:
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.
Options and arguments
Displaying the version tree graphically
Listing subbranches
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
Graphical options
- Default
- None.
- –opt/ions pass-through-options
- Specifies one or more xclearcase command options that are not directly supported on the lsvtree command line. In particular, xclearcase 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
Examples
The UNIX system and Linux examples in this section are written for use in csh. If you use another shell, you might 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 might 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