Jump to: navigation, search

Difference between revisions of "Compare"

(Updated with state as of 3.3 M3)
 
(11 intermediate revisions by the same user not shown)
Line 1: Line 1:
In the 3.3 release, we are planning on working on some of the outstanding defects that have accumulated for the Compare component. Some of the areas we plan on looking at are:
+
This page contains links related to the Eclipse Compare Framework
  
* Asynchronous loading and update of compare editors
+
*[[Compare Word Documents | Comparing Word Documents in Eclipse]]
* Improving the save life-cycling
+
*[http://www.eclipse.org/documentation/ On-line documentation]
* Improving difference and change Navigation
+
*[[Team | Team Wiki Page]]
* Use of text buffers when comparing local content
+
*[[Platform | Platform Wiki Page]]
* Upgrade to use the new Commands/Key bindings framework
+
* Switch to using the History view for local history operations (Compare/Replace/Restore)
+
  
The following sections outline some thoughts on each of these areas.
+
[[Category:Eclipse Project]]
 
+
== Asynchronous Loading ==
+
 
+
Currently, the compare editor input is prepared in the foreground before the editor is opened. Given that this operation may involve server round-trips and difference calculations, it would be bnefitial if it could be done in the background.
+
 
+
== Save Life-cycle ==
+
 
+
Saving properly in the Compare framework has always been a bit of a black art. See bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=125538 125538] for a description of one way of making it work. The reason for this is the layered nature of the Compare framework. For a local file, the layers are:
+
 
+
# The file (instance of IFile)
+
# The ResourceNode (instance of IEditableContent)
+
# The TextMergeViewer
+
# The CompareEditorInput
+
# The CompareEditor or CompareDialog
+
 
+
Assume you have an merge viewer open and edit the left side. A save is triggered by a Save operation or selecting another element to edit. What happens in this case is the following:
+
 
+
# Save is called on ContentMergeViewer
+
# Save obtains the content from the left side of the content merge viewer and passes it to the viewer content provider (instance of MergeViewerContentProvider).
+
# The content provider calls saveContent on the left typed element of the compare input (if the compare input is an IEditableContent).
+
# the ResourceNode updates its buffer to contain the new content and fire a change event
+
# if you want the file to be saved, you need to listen to that event and call commit on the ResourceDiffNode. For Team, we implement the save behavior in a couple of places. In the old-style syncs, it was a subclass of CompareEditorInput (SyncInfoCompareInput) that listened to the contet change and performed the commit (i.e. the method on ResourceNode that saves). For the new-style sync, we have a class associated with the resource (ResourceSaveableComparison) that performs the save.
+
 
+
There are a couple of observations that can be made about this:
+
 
+
* The ContentMergeViewer portion of the above only works with byte oriented content.
+
* Both the document in the TextMergeViewer and the ResourceNode buffer the contents of the file (that means there are at least two in-memory versions of the file for each side (and the ancestor if there is one).
+
** I have entered bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=150526 150526] to request that the use of BufferedContent be avoided for remote files.
+
** I have reopened bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=114 114] to consider linking resource nodes (and also possibly IStorage nodes) with underlying file buffers so that in-memory content is shared between editors.
+
* the save method of ContentMergeViewer is really a flush.
+
** However most client (e.g. Team Synchronize) treat the flush as an indication that a save should occur.
+
 
+
In 3.3 M3, a SaveableCompareEditorInput was released as API. This class has helper methds and special handling for diff nodes that represent a local file. This special handling includes the use of file buffers and a save to disk whenever the viewer is flushed.
+
 
+
=== Saveables ===
+
 
+
There are a few other issues to consider here:
+
 
+
* Implementors of custom ContentMergeViewers need to be able to participate in the saving of ContentMergeViewers (see bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=143852 143852])
+
* The Saveable API was introduced in Eclipse 3.2 and could potentially be used by merge viewers. The new-style model-based sync makes use of this API already.
+
 
+
Here are some thoughts on how this could work.
+
 
+
* Each CompareInput may have one or more Saveables associated with them.
+
* The CompareEditorInput would keep track of what Saveables it contained and would keep the workbench view of them up-to-date.
+
* If the ContentMergeViewer or subclass wants to save, they can flush and then invoke save on the appropriate Saveables (i.e. it may only be a subset of the Saveables in the CompareEditorInput).
+
* If the editor is saved, again, a flush is required before the save is issued to all dirty saveables of the CompareEditorInput.
+
* Of course, backwards compatibility must be maintained.
+
 
+
More invetsigation is required to determine if any work is feasible for 3.3.
+
 
+
== Navigation ==
+
 
+
When opening a Text or Java comparison from the Synchronize view, there are three sets of up/down navigation buttons that will appear: one set in the Synchronize view, one set in the toolbar and one set in the merge viewer. Each set of buttons has slightly different behavior.
+
 
+
* The toolbar buttons will cycle through the differences in the Content Compare pane and then cycle through the entries in the Structure Compare pane.
+
* The viewer buttons will cycle through each individual change in the Content Compare pane.
+
* The Synchronize view buttons will do what the toolbar buttons do but go to the next/previous element in the Synchronize view when the end/beginning is reached.
+
 
+
It would be good if we could condense this into a consistent unified navigation behavior.
+
 
+
There are several bugs on this matter: bugs [https://bugs.eclipse.org/bugs/show_bug.cgi?id=143858 143858], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=36710 36710], [https://bugs.eclipse.org/bugs/show_bug.cgi?id=143855 143855]. This is targetted to be addressed in 3.3 M4.
+
 
+
== ContentMergeViewer Extendability ==
+
 
+
There are several package private methods on ContentMergeViewer that would be helpful for subclasses to be able to override. A case in point is the TextMergeViewer that does this already because it is in the same package (see bug [https://bugs.eclipse.org/bugs/show_bug.cgi?id=144638 144638]). In 3.3 M3, changes were made to ContentMergeViewer to surface as API the methods that were required by TextMergeViewer.
+

Latest revision as of 11:15, 11 June 2008

This page contains links related to the Eclipse Compare Framework