annotate
Annotate text files to determine new or changed lines between versions. This is helpful for performing code reviews and determining when changes were introduced in the code.
When you annotate a file, Surround SCM compares the selected version to previous versions based on options you select. Any lines added or changed between versions are displayed, including the user who made the change, when the change was made, and the event that changed the file version, such as Check In.
sscm annotate Filename [-bBranch] [-pRepository] [-h] [-o] [-a[V|L|T|S]:VersionToAnnotate] [-c[V|L|T|S]:ShowChangesSince] [-y[Username:Password|+|=]] [-zSCMServerAddr:PortNum|zPath]
| Option | Description |
|---|---|
| Filename | Name of the file to annotate. |
| -a | VersionToAnnotate is the version of the file to display:
V: Annotate by specified version L: Annotate by specified label name T: Annotate by specified timestamp (format: yyyymmddhh:mm:ss) S: Annotate by latest version in specified state ID If not specified, the latest version is used. |
| -b | Branch that contains the file. If not specified, default working directory branch is used. |
| -c | Only changes that occurred since ShowChangesSince will have annotation:
V: Show changes since the specified version L: Show changes since the latest version with the specified label T: Show changes since the specified timestamp (format: yyyymmddhh:mm:ss) S: Show changes since the latest version in the specified state ID If not specified, all changes are shown. |
| -h | Display online help for the command. |
| -o | Output all the columns instead of only the default columns (User, Version, Content). |
| -p | Full path to the repository, including parent repositories. If not specified, default working directory repository is used. |
| -y | Enter a Surround SCM username and password if you do not want to use the default value. To use single sign-on, enter -y+. If you use an identity provider to authenticate, the provider web page opens if you have not yet authenticated. Authenticate with the provider and then return to the CLI. |
| -z | Enter the Surround SCM Server host computer address and port number if you do not want to use the default value. IPv6 addresses must be in square brackets. If you received a server settings file from your Surround SCM administrator, enter the path to the XML file instead of entering the server connection information. |
| +u | Display output in Unicode (Windows only). Output cannot be sent to a file. If output is enabled for all commands, enter +u- to disable it for this command. |