bundles/org.eclipse.platform.doc.user/reference/ref-6a.htm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"><HTML>
<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,&nbsp;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.&nbsp;Each state in the local
history is identified by the date and time the file was
saved.&nbsp;&nbsp;</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 &gt; Show Local History</b> from the pop-up
menu.&nbsp; 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 &gt; 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&gt;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>