The Annotate Tab
The Annotate command lists the entire contents of the selected version of a text file, annotating each line with:
The timestamp of the version in which that line was added to the file.
The number of the transaction in which that version was created.
The user who performed that transaction.
A version timeline makes it easy to view the contents of any version of the text file.
In the Details pane of the File Browser, select one text-file element. Then, invoke the command in any of these ways:
Click the Annotate toolbar button.
Right-click the selection to bring up its context menu, then select Annotate.
The contents of a text file are listed as a multiple-column table. Each row represents one line of the text file.
The columns contain:
Date column: the timestamp of the version A particular revision of an element, reflecting a content change (files only) or a namespace change (files and directories). All versions are originally created in workspaces, and can subsequently be promoted to dynamic streams. The original (workspace) version is termed a 'real version'. Each promotion to a dynamic stream creates a 'virtual version', which serves as an alias for (pointer to) the original real version. in which that line was added to the file.
# column: the number of the transaction A record in the AccuRev repository database that indicates a particular change: promoting of a set of versions, changing the name of a stream, modification to an issue record, etc. in which that version was created.
User column: the AccuRev username of the user A person who uses an AccuRev client program to access (read and/or change) the data in the AccuRev repository. Access is granted only to those who login with a "username" that was previously registered in the AccuRev repository. See login. who created that version.
Line column: the line number of the text
Content column: the contents of the text line
In a (modified)-status file, one or more lines have not yet been saved with the Keep command. For such lines, columns 1-3 are empty.
When you click on a cell in the Date, #, or User column, AccuRev highlights all the lines whose value in that column matches the value in the cell. This makes it easy to:
Find all the lines added or changed in a particular version (click in the Date or Transaction # column).
Find all the lines created by a particular user (click in the User column).
A timeline appears at the top of the Annotate tab, with an entry for each version of the text file element.
You can use the timeline's slider control to switch among the file's versions. (Alternatively, just click a timeline entry to jump to that version.) Whenever you switch to a different version, AccuRev automatically highlights the lines that were added or changed in that version.