| <!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> |