blob: c37f9a2412f1598f4bb4b955f7d70cd78b5a444d [file]
<!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=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>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 &gt; 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>
<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>
</body>
</html>