lsvtree

Lists version tree of an element

APPLICABILITY

SYNOPSIS

• ClearCase and ClearCase LT on UNIX only-Display the version tree in graphical form:

lsvtree -g·raphical [ -a·ll ] [ -nme·rge ] [ -nco ]

[ -opt·ions pass-through-opts ] pname ...

• Windows only-Display the version tree in graphical form:

lsvtree -g·raphical [ -a·ll ] [ -nme·rge ] [ -nco ] pname ...

• 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 (in Attache, a Version Tree Browser window) 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 pathnames. 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 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 with 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 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 shell or Windows command interpreter prompt, followed by the cleartool command. In cleartool interactive mode, cmd-context represents the interactive cleartool prompt. In Attache, cmd-context represents the workspace 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

SEE ALSO

describe, ls, lshistory