File Annotation Pane

The File Annotation pane shows historical information about changes made to any text file in StarTeam.

Using the File Annotation Pane

To open and use the File Annotation pane, do the following:

  1. Choose Tools > File Annotation.

    The File Annotation pane opens. It will be enabled for every view window opened in the current session.

  2. Select a text file from the File tab to view the tip revision’s complete annotation information, or from the History tab to view changes made to a specific revision of the file.

    Note: Annotation information can also be viewed from the Link tab if the item is a text file.

Like the File Compare tool, the File Annotation tool displays the contents of the selected file in an embedded pane at the bottom of the main window. If you resize the pane, the client will automatically display the split pane bars in the same position in every open view window.

Line by line, annotation information shown in this initial view of the file includes:

  • The name of the user who made each change.
  • A link to each process item linked to the revision.
  • The dot notation of the file revision in which each change was made, which is linked to a view of the actual changes that were made to the content in that revision.
  • An Info icon that provides more details about the file revision and linked process items, such as the modified time or any comments.

Back to top

Reviewing a Previous Version of a File

To review a previous version of a file in the File Annotation pane, do the following:

  1. Click the dot notation link of the file revision you wish to review.

    A new page will open that shows, line by line, the changes that occurred in the selected revision of the file.

  2. Use the icons described below to navigate the changes made to each version of the selected file you review.

    Go to the previous page.

    Go to the next page.

    Go to the end of the file.

    Go to the beginning of the file.

    Go to the first changed line in the file.

    Go to the last changed line in the file.

    Go to the next changed line in the file.

    Go to the previous changed line in the file.

    Denotes a line that has been added to the file. The text of added lines is green.

    Denotes each line that has been revised. The text of revised lines is blue, with additions highlighted in green and deletions highlighted in red with a strikethrough effect.

    Denotes each line that has been deleted from the file. The text of deleted lines is red with a strikethrough effect.

    Back to top