blob: 3d7ce269b527b9122b17f2304ecd64fd75a5c1f7 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<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>Compare editor</title>
</head>
<body bgcolor="#ffffff">
<h1 class="Head"> Compare editor</h1>
<p class="Para"> You can view the differences between two files by comparing
them. You can compare different files, you can compare versions in
the Workbench with versions in the repository, or with the local edit history.&nbsp;
In some cases you can compare three files (when a common ancestor exists).
</p>
<p class="Para"> After a comparison is carried out, the compare editor opens
in the editor area. In the compare editor, you can&nbsp; browse through
all the differences and copy highlighted differences between the compared
resources. You can save changes to resources that are made in the comparison
editor. </p>
<p class="Para">Here is how the compare editor looks when you synchronize
with a CVS repository. The compare editor is the bottom portion of the
view (whose titlebar is Text Compare).</p>
<p class="Para"><img
src="../images/Image245_sync_view.gif"
alt=" Picture of 3-paned editor. Top pane compares project structure; bottom 2 panes (side by side) compare lines of source." width="674" height="321" border="0" align="top">
</p>
<div class="Topic">
<div class="Subtopic">
<h2>Toolbar</h2>
<p>The toolbar of the Compare editor includes the following buttons:</p>
<dl>
<dt>Control Visibility of Ancestor Pane</dt>
<dd>There are two conditions under which a three way compare will occur,
both when using the Team version management support: when comparing
a file that is in conflict, and when comparing a file being merged
from a branch. In both cases, the system will determine a common
ancestor in the repository to compare the conflict or merge against.
This button determines the visibility of the third editor. By default,
the ancestor pane is not visible.</dd>
<dt>Perform Three way/Two way Compare</dt>
<dd>The compare editor can be toggled between performing a three way compare
or a two way compare which ignores the common ancestor.</dd>
<dt>Copy Whole Document from Left to Right</dt>
<dd>Copies the entire contents of the file in the left pane into the file
in the right pane, making the contents of the two files identical.&nbsp;</dd>
<dt>Copy Whole Document from Right to Left</dt>
<dd>Does the opposite of the one just described.</dd>
<dt>Copy Current Change from Left to Right</dt>
<dd>Merges changes in two files by copying the highlighted change in the
left pane into the highlighted fragment on the right.&nbsp; This
will overwrite the highlighted fragment in the right pane.</dd>
<dt>Copy Current Change from Right to Left</dt>
<dd>Does the opposite of the one just described.</dd>
<dt>Select Next Difference</dt>
<dd>Highlights the next difference that is found between the compared resources.</dd>
<dt>Select Previous Difference</dt>
<dd>Highlights the previous difference that is found between the compared
resources.</dd>
</dl>
<p><img border="0" src="../images/ngrelc.gif" alt="Related concepts"
width="159" height="27">
<br>
<a href="../concepts/concepts-30.htm">Synchronizing with a CVS
repository</a> <br>
<a href="../concepts/concepts-29.htm">Three way comparisons</a></p>
<p><img border="0" src="../images/ngrelt.gif" alt="Related tasks"
width="159" height="27">
<br>
<a href="../tasks/tasks-68.htm">Comparing resources</a><br>
<a href="../tasks/tasks-115.htm">Synchronizing with the repository</a><br>
<a href="../tasks/tasks-68dg.htm">Merging changes in the compare editor</a><br>
<a href="../tasks/tasks-113b.htm">Resolving conflicts</a><br>
<a href="../tasks/tasks-68b.htm">Setting preferences for comparing files</a><br>
<a href="../tasks/tasks-101.htm">Comparing resources with repository
versions</a> </p>
</div>
</div>
<p>&nbsp;<br>
<a href="../hglegal2003.htm"><img src="../images/ngibmcpy2003.gif"
alt="Copyright IBM Corporation and others 2000, 2003" border="0"
width="324" height="14">
</a> </p>
</body>
</html>