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 ...
Note: For the graphical invocations of this command, note that if the environment variable CCASE_USE_GUI is set, options other than –graphical are not supported.

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 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