Table of Contents
whist - display change history for file or directory
whist
[-AdEHLMOPRTuVwYz] [-CDate] [-jpatternList] [-o/Path] [-r[Rev][:|-][Rev]] [-NWorkspaceName]
[-Wuser[,...]] [-hHost -SSnapshot [-DDir]] name ...
whist displays the
history records for name. If name is a directory, display history for every
item within the directory.
Mapping is consistent across
all workspace commands. See wco(1)
for details.
Default
options can be set on most workspace commands. See wco(1)
for details.
The workspace mapping is automatically looked up in the user's workspace
mapping table for the given files. Override this by specifying an explicit
workspace:
- -NworkspaceName
- Use the named workspace mapping.
Or override
with a temporary workspace mapping with these three options:
- -hHost
- Use
the SnapshotCM server on Host for a workspace mapping.
- -SSnapshotPath
- Use
SnapshotPath for a workspace mapping.
- -DWorkspaceDirectory
- The local destination
directory for a workspace mapping. This can be a relative or absolute path.
If this option is not provided with the other two, the local destination
directory defaults to the current directory where the command is executed.
For more information on workspace mappings, see wmap(1)
.
- -A
- Only
list changes which are ancestors of the current revision. Normally all revisions
are displayed. Use this option to avoid displaying changes from unmerged
parallel branches.
- -cDate
- Only list changes made on or after the given date.
See wco(1)
for supported date formats.
- -d
- If file is a directory, operate
on it only, not the names within it. Combine with -R to operate recursively
only on directories.
- -E
- Operate only on existing local files. A quick way
to see the history on files you have in your workspace.
- -H
- Display only the
history header, not information about individual revisions.
- -jpatternList
- Show history only for files whose base name matches patternList.
PatternList
consists of one or more patterns separated by a '|' (pipe/or) symbol. Each
pattern is a shell wild card pattern as follows:
* - match 0 or more characters
? - match any one character
[set] - match any character in set
Individual patterns ending in a slash
('/') match directories only. Individual patterns not ending in a slash match
only files.
If the list begins with an '!' (exclamation/bang) character, the
list selects items not matching any patterns.
- -L
- Operate only on locally
locked files. A quick way to display history on files you are changing.
- -M
- Print workspace mapping before normal output.
- -o/Path
- Map /Path in the selected
snapshot to the specified (-D) local directory, creating a temporary, partial
workspace mapping for the command. Normally, the root directory of a snapshot
is what is mapped.
- -O
- Map full archive path parameters to the current directory.
Normally, full archive path parameters are mapped to their usual locations
within the workspace. This option creates a temporary, partial workspace
mapping for each full archive path parameter such that the snapshot directory
of the parameter is mapped to the current directory. This behavior is designed
to be consistent with SoftCM, a logical predecessor of SnapshotCM. See also
the -o option which allows use of relative path parameters.
- -P
- Merge changes
for all files and directories into one list, sorted by path.
- -r[Rev]:[Rev]
- -r[Rev]-[Rev]
- -rRev
- List history for the specified revisions. If a ':' or '-' is
given, a range of revisions will be selected. Otherwise, a single revision
will be selected. In a range, the first Rev defaults to the beginning of
the history, while the second defaults to the end of the history. A '-' range
includes the lower Rev, while a ':' range does not. If the lower rev is defaulted,
it is always included. The upper Rev is always included.
Rev can be a number
or a relative or full snapshot path. If a snapshot path is given, the revision
of the item referenced by that snapshot is used.
- -R
- Operate recursively on
all files and directories.
- -T
- Merge changes for all files and directories
into one list, sort by date.
- -u
- Enable showing history for deleted (recoverable)
files and directories.
- -V
- Print internal version and exit.
- -w
- Only list changes
made by the calling user.
- -Wuser,...
- Only list changes made by any of the comma
separated list of users.
- -Y
- Suppress display of snapshots which reference
a revision.
- -z
- Reverse sort the revisions.
Exit status is 0 if
all specified history were successfully retrieved, 1 if a file could not
be accessed, and >1 if there was a bad option or a network error.
wci(1)
,
wco(1)
, wdiff(1)
, wls(1)
, wmap(1)
, wmerge(1)
, wremove(1)
, wrename(1)
, wset(1)
,
wupdate(1)
.
Table of Contents