| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> |
| <html lang="en"> |
| <head> |
| |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2011. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| |
| |
| <meta http-equiv="Content-Type" |
| content="text/html; charset=ISO-8859-1"> |
| |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| |
| <link rel="STYLESHEET" href="../book.css" charset="ISO-8859-1" |
| type="text/css"> |
| <title>CVS History View</title> |
| |
| </head> |
| <body style="background-color: rgb(255,255,255);"> |
| |
| <h1 class="Head"> CVS History view</h1> |
| |
| <p class="Intro"> This view provides a list of all the revisions of a resource in the repository as |
| well as all the revisions of a resource in the local history. From this view you can compare revisions, |
| load a revision, revert the corresponding workspace file to a revision, tag |
| with an existing tag, show annotations and open an editor on a revision. </p> |
| |
| <p class="Para">Here is what the CVS History View looks like:</p> |
| |
| <p class="Para"><img |
| src="../images/Image216_history_view.png" |
| alt="CVS Resource History View" border="0" align="top"> </p> |
| |
| <h2>Columns</h2> |
| <p class="Para">The History View is able to display both local and remote revisions. Local History revisions have |
| minimal information associated with them - only a time stamp. As a result, the majority of the column items will appear |
| blank for Local History revisions. Remote revisions, on the other hand, will have a much more complete set |
| of information. Here are the columns: </p> |
| |
| <div class="Topic"> |
| <h3> Revision</h3> |
| <p class="Para"> Since the CVS History view can display both remote and local revisions. |
| For remote revisions: |
| </p> |
| <ul> |
| <li>the column displays the remote revision icon: |
| <img |
| src="../images/remote_history_mode.svg" |
| alt="Remote History Mode icon" border="0" align="top"> </li> |
| <li>the column displays the revision number in the history. </li> |
| </ul> |
| |
| For local history revisions: |
| <ul> |
| <li>the column displays the local history revision icon: |
| <img |
| src="../images/local_history_mode.svg" |
| alt="Local History Mode icon" border="0" align="top"> </li> |
| </ul> |
| |
| </div> |
| |
| <div class="Topic"> |
| <h3>Branches</h3> |
| <p class="Para">This column displays the list of branches on which the revision is available. <i>(Remote revisions only)</i></p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Tags</h3> |
| <p class="Para">The tags that are associated with the revision. Selecting |
| a revision line will list the tags in the lower left pane of the view. <i>(Remote revisions only)</i></p> |
| </div> |
| |
| <div class="Topic"> |
| <h3> Revision Time</h3> |
| <p class="Para"> This column displays the creation date and time of the revision |
| in the history.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3> Author</h3> |
| <p class="Para"> This column displays the name of the person who created and |
| authored the version. <i>(Remote revisions only)</i></p> |
| </div> |
| |
| <div class="Topic"> |
| <h3> Comment</h3> |
| <p class="Para"> This column displays the comment (if any) supplied for this |
| revision at the time it was committed. Selecting a revision line will |
| show the complete comment in the lower right pane of the view. |
| Also, mousing over a dotted comment will result in showing a tooltip with complete comment. <i>(Remote revisions only)</i></p> |
| </div> |
| |
| <h2>Toolbar</h2> |
| |
| <div class="Topic"> |
| <h3>Refresh</h3> |
| <p class="Para">This command refreshes the contents of the view, |
| fetching the latest history information for the resource from the server.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Link with Editor and Selection</h3> |
| <p class="Para">When enabled, the view will display the history for the resource |
| of the active editor or of the active selection.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Pin</h3> |
| <p class="Para">When enabled will pin the view and its contents. Any new requests for history |
| will open a new instance of the History View.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Navigation History</h3> |
| <p class="Para">When enabled will allow you to select from a drop down menu a |
| resource for which a history has been viewed in the past. The action is disabled |
| when the History view is opened for the first time.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Group Revisions by Date</h3> |
| <p class="Para">When enabled, all history items will be sorted into one of the following date |
| categories: </p> |
| <ul> |
| <li>Today</li> |
| <li>Yesterday</li> |
| <li>This Month</li> |
| <li>Previous</li> |
| </ul> |
| |
| </div> |
| |
| <div class="Topic"> |
| <h3>Local and Remote Revisions</h3> |
| <p class="Para">When enabled will display both local and remote revisions of the resource in the |
| History view.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Local Revisions</h3> |
| <p class="Para">When enabled will display only the local revisions of the resource in the |
| History view.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Remote Revisions</h3> |
| <p class="Para">When enabled will display only the remote revisions of the resource in the |
| History view.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Collapse All</h3> |
| <p class="Para">Will the view is in the Group by Date mode, Collapse All will collapse all of the |
| date categories.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Compare Mode</h3> |
| <p class="Para">When enabled, a double click (or a single click depending on your Open Mode strategy set |
| in <b>Preferences>General</b>) will open a compare editor. When it is disabled, clicking on a revision |
| will open that revision.</p> |
| </div> |
| |
| <div class="Topic"> |
| <h3>Drop Down Menu</h3> |
| <p class="Para">The drop down menu contains the following items:</p> |
| <ul> |
| <li><b>Wrap Comments</b>: Will wrap comments in the Comment Viewer.</li> |
| <li><b>Show Comment Viewer</b>: shows the Comment Viewer.</li> |
| <li><b>Show Tag Viewer</b>: shows the Tag Viewer.</li> |
| <li><b>Show Search Field</b>: shows the Search Field.</li> |
| <li><b>Filter....</b>: Opens the Filter Dialog.</li> |
| <li><b>Remove Filters</b>: Removes any filtering from the History View.</li> |
| </ul> |
| </div> |
| |
| <h2 class="Para">Context menu </h2> |
| |
| <p class="Para">From the context menu of the CVS Resource History view you can perform |
| a number of interesting operations.</p> |
| |
| <h3>Open</h3> |
| <p class="Para">This command will open the contents of the selected revision in a read only |
| editor. (The editor used is the one that is registered as the default editor for the file type). |
| <i>Note</i>: If the revision being opened is the current version of the file, then it will be opened |
| in a regular editor.</p> |
| |
| <h3>Open With</h3> |
| <p class="Para">This menu allows choosing an editor to open the contents of the selected revision. |
| <i>Note</i>: If the revision being opened is the current version of the file, then it will be opened |
| in a regular editor, otherwise a read only editor is used.</p> |
| |
| <h3>Compare Current With Revision/Compare With Each Other</h3> |
| <p class="Para">The compare command differs based on the number of revisions selected in the |
| history view. For a single selection, <b>Compare Current With Revision</b> will the compare the |
| current version of the resource with the selected revision. For two selections, <b>Compare with Each |
| Other</b> will compare the selected revisions.</p> |
| |
| <h3>Get Contents</h3> |
| <p class="Para">This command will load the contents of the selected revision |
| into the local copy of the file whose history |
| is displayed in the view. The local file can then be committed to make |
| the contents of latest revision in HEAD (or a branch) match the contents of |
| the selected revision.</p> |
| |
| <h3>Get Sticky Revision</h3> |
| <p class="Para">This command will load the selected revision over the local |
| file whose history is being displayed. This operation is rarely needed and is |
| mainly used to change the tag on one or more resources. The loaded revision |
| cannot be subsequently committed but can be tagged.</p> |
| |
| <h3>Tag with Existing...</h3> |
| <p class="Para">This command allows an existing tag to be moved to the |
| selected file revision.</p> |
| |
| <h3> Show Annotation</h3> |
| <p> This command shows the contents of file with annotations identifying the author |
| of each line of code in the file.</p> |
| |
| <h3>Refresh View</h3> |
| <p> This command refreshes the contents of the view.</p> |
| |
| |
| <h3 class="related">Related reference</h3> |
| <a href="ref-32.htm">CVS Repositories view</a> |
| |
| <h3 class="related">Related concepts</h3> |
| <a href="../concepts/concepts-12.htm">Resources</a> <br> |
| <a href="../concepts/concepts-27c.htm">CVS Repositories</a> <br> |
| <a href="../concepts/concepts-17a.htm">Local history</a> |
| |
| </body> |
| </html> |
