Show TOC

HISTORYLocate this document in the navigation structure

Use

Shows the version history of a specified file or folder. Each version exists on exactly one branch. Each branch is owned by exactly one workspace. Versions on a branch are places in sequential order, called the branch sequence number. The first version on a branch has branch sequence number 1, the second has branch sequence number 2, and so on. The versions in the version history can exist on more than one branch. A version is uniquely identified by its branch and the branch sequence number. A branch is uniquely identified by the workspace that owns this branch. Thus, a version is also uniquely identified by a workspace and branch sequence number.

Syntax

Syntax

HISTORY [-rh] <folderItemPath> [-w "workspacePath"]

Arguments

[-rh]

If this option is specified, then only the revision history of the folder item in the specified workspace is displayed.

<folderItemPath>

[-w "workspacePath"]

Workspace path to specify the workspace for which the revision numbers of versions in the workspace will be shown, in case a version graph is shown. In case a revision history is shown (using the -rh option), this specifies the workspace for which the revision history has to be displayed. If this is not specified, then the workspace of the folder item will be used.

Description

Displays the version graph or revision history of the specified folder item.

Example

To display the version history of file a.java , execute:

history a.java