si annotate

CLI Reference > Configuration Management Commands > si annotate

si annotate

displays an annotated revision.

Synopsis

si annotate [--[no]defaultFormat] [--[no|un]expand] [--fields=field1[:width1],field2[:width2]...] [--guiCharacterEncoding=value] [--height=value] [--width= value] [-x=value] [-y=value] [--[no]failOnAmbiguousProject] [-r|--revision=value] [--devpath=value] [-P|--project=value] [-S|--sandbox=value] [--projectRevision=value] [--hostname=server] [--port=number] [--password=password] [--user=name] [(-?|--usage)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--cwd=directory] [--forceConfirm=[yes|no]] [(-g|--gui)] [--quiet] [--settingsUI=[gui|default]] [--status=[none|gui|default]] member

Description

si annotate displays an annotated revision. For example,

si annotate --project=c:/Aurora_Program/bin/Libra/project.pj cell.c

Use the command when you want to know the reason and circumstances a line was introduced or changed. Rather than viewing the content of each revision in the history one revision at a time, you can see the line by line history that includes information on a per revision basis.

Options

This command takes the universal options available to all si commands, as well as some general options. See the options reference page for descriptions.

• --[no]defaultFormat

specifies if the default format is used to display the output.

• --fields=field1[:width1],field2[:width2]...

The fields available for printing can be one or more of the following:

• author

displays the author of the revision.

• cpid

displays the line's associated change package ID.

• date

displays the date each line in the history was created.

• labels

displays revision labels.

• linenum

displays the line number for each line of text in the revision..

• revision

displays the line's revision number.

• text

displays the text contained in the line.

• --[no|un]expand

specifies if the keywords are expanded in the output.

• --guiCharacterEncoding=value

specifies the character encoding to use for the revision contents in the GUI, and can only be specified with the -g option. PTC RV&S automatically decodes UTF-8 revision contents based on the presence of a byte order mark (BOM) in the file. You can set character encoding preferences for each view and command through your client preferences. The preference setting is used if the character set cannot be determined through the file’s BOM, or if no character set is specified in the command line. By default, the character set in the preferences matches the default character set provided by the client’s operating system locale. The option does not apply to pure CLI output, or third party merge and/or differencing tools. Possible values are:

UTF-8
US-ASCII
windows-1252
ISO-8859 -1
ISO-8859 -15
IBM437
IBM850
IBM863
EUC-JP
Shift_JIS
x-euc-jp-linux
x-eucJP-Open
x-windows-iso2022jp
IBM862 ISO-8859-8
ISO-8859-9

• member

specifies the name of the member to view.

Diagnostics

See the diagnostics reference page for possible exit status values.

Preferences

Using si setprefs or si viewprefs, you are able to set or view the preference keys for this command.