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