| <!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=utf-8"> |
| <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> |
