lsvtree
Lists version tree of an element
SYNOPSIS
- 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.
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
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 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 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.
- List
selected versions from an element's version tree.
- List
all versions and all obsolete branches in an element's version tree.
- List
all versions on the rel2_bugfix branch of an element's
version tree.
- Start
a version tree browser to display all versions in an element's version tree.