History (Command Line)

See Also

Shows the history of a file or project in VSS.

Syntax

ss History VSS items [-B] [-D] [-F-] [-H] [-I-] [-L] [-N] [-O] [-R] [-U[username]] [-V] [-Y] [-#] [-?]

Examples

Displays the history of the file TEST.C:

ss History TEST.C

Displays the history of the project $/WORD:

ss History $/WORD

Displays the last three items in the history list for the current project, or for file TEST.C, respectively:

ss history . -#3
ss history TEST.C -#3

The following table describes the command-line options available with this command.

Option Description
-O Paginate or redirect the command output.
-V Display only versions that fall within specified range.
-R Display the history of an entire project list.
-L Display only versions that have labels.
-F- Do not display individual file updates in the project history.
-B Display a brief history.
-U Display only changes made by a particular user.
-D Display line-by-line file changes.
-#<#> Display the specified number of history entries for the selected file or project.
-I- Ignore: Do not ask for input under any circumstances.
-N Change between long and short file name mode.
-Y Specify a username and/or password.
-?, -H Request online Help on a command.

Access Rights

You must have Read access right to use this command.

Remarks

The History command has a number of options that can be used to customize its display. For example, -L shows only the versions that have labels; because these versions tend to be the major release milestones, the -L option can help generate a general overview of the history of an item.

The -B option shows a brief history only enough information about a version to fit on one line.

The -U option shows only changes that were made by a particular user (the current user if none is specified on the command line).

The -D option shows all the changes actually made with each file update.

The -V option specifies a range: -V5 starts with version 5, and goes back to version 1. A tilde (~) is used to specify both sides of a range, so -V5~3 gives the history of versions 5, 4, and 3. The range must be specified beginning with the later version, as in the example.

The -R option indicates that you want to see all the changes made to every subproject under the project, and the files and subprojects under those, and so on.

By default, the history of a project includes the histories of all its files, but does not include subprojects.