| <!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, 2005. 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>Local history</title> |
| </HEAD> |
| <BODY BGCOLOR="#ffffff"> |
| <H1 CLASS="Head"> |
| Local history</H1> |
| <p>Local history of a file is maintained when you create or modify a file. Each time you edit and save |
| a file, a copy of it is saved. This allows you to compare |
| your current file state to a previous state, or replace the file with a previous |
| state. Each state in the local |
| history is identified by the date and time the file was |
| saved. </p> |
| <p>Neither projects nor folders have local history.</p> |
| <p>Local History is displayed in the History View. Here is a look at what the local history of a Workbench file might look |
| like: </p> |
| <p><img src="../images/Image273_local_hist.png" alt="Local history dialog" border="0" ></p> |
| <P>To view the local history of a file, choose <b>Team > Show Local History</b> from the pop-up |
| menu. This will bring up the History view and populate it with the revisions of the selected |
| file. You can open different revisions from the table (by using <b>Open</b> from the context menu or |
| by double clicking on a revision), compare them against the latest revision or against a |
| previous revisions (by using <b>Compare With Revision</b> from the context menu), and replace the current revision |
| with the contents of a previous revisions (by using <b>Get Contents</b> from the context menu). |
| </P> |
| |
| <p><i>Note</i>: Projects that are managed by CVS now have the local history revisions displayed |
| alongside remote revisions. In order to see the local history for a CVS managed file, select the |
| <b>Team > Show History</b> menu item and make sure that the History View is one of the modes capable |
| of showing local history. </p> |
| |
| <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>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>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> |
| |
| <h2 class="Para">Context menu </h2> |
| |
| <p class="Para">From the context menu of the Local History view you can perform |
| the following 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>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.</p> |
| |
| <p><img border="0" src="../images/ngrelr.png" alt="Related reference" |
| > |
| <br> |
| <a href="ref-32a.htm">CVS History view</a> </p> |
| |
| </BODY> |
| </HTML> |