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. Integrity Lifecycle Manager 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.
See Also
Commands: si archiveinfo, si memberinfo, si mods, si print, si revisioninfo, si rlog, si sandboxinfo, si viewhistory, si viewlabels, si viewprojecthistory, si viewsandbox
Miscellaneous:ACL, diagnostics, options, preferences