Show the history of a file or component.
Purpose
The scm history subcommand
displays the change history of the specified file or component.
Synopsis
- To run scm history after you have used scm login to
create stored credentials:
scm history { [ -d | --dir ] workspace-path [ -v | --verbose ] [ -c | --component ] [ -m | --maxresults ] } selector
- To run scm history supplying credentials
on the command line:
scm history { [ -u | --username ] user ID in repository [ -P | --password ] password for user ID in repository [ -d | --dir ] workspace-path [ -v | --verbose ] [ -c | --component ] [ -m | --maxresults ] } selector
Options and arguments
- [ -c | --component ]
- Indicates that selector specifies a component.
- [ -d | --dir ] workspace-path
- The path name of a local workspace created
by scm load or scm share.
This subcommand runs with workspace-path set as
the current working directory. You can omit this option if the current
working directory is in a local workspace.
- [ -m | --maxresults ]
- Maximum number of history entries to display. Defaults to 100.
Use 0 for unlimited.
- [ -P | --password ] password for user ID in repository
- The password for the specified user ID in
the named repository. If this option is not included on the command
line, you are prompted for a password. If you specified a repository
URI or nickname for which you have stored credentials using the scm
login command, this option is ignored.
- [ -u | --username ] user ID in repository
- Specifies a user ID that exists in the named
repository. If you specified a repository URI or nickname for which
you have stored credentials using the scm login command,
this option is ignored.
- [ -v | --verbose ]
- Provide additional informational messages
while operating.
- selector
- Path name of a file or, if used with -c,
the name, alias, or UUID of a component.
Examples
Working in a local workspace, list
the history of the file
com.example.hellojazz.rcp.ui\src\
com\example\hellojazz\rcp\ui\actions\HelloJazzAction.java.
Limit the output to the three most recent changes:
C:\local-workspaces\HelloJazz>scm history -m 3 com.example.hellojazz.rcp.ui\src\com\example\hellojazz\rcp\ui\actions\HelloJazzAction.java
(1107) $ <No comment>
(1106) $ 57286 "bogus repository error when accepting team invitation" - "fix "bad URI" message"
(1105) $ <No comment>
There may be additional history before this point.