Quick Help Customization Customization Selective Browsing
On a non-windowing display, Ediff sets things up in one frame, splitting it between a small control window and the windows for buffers A, B, and C. The split between these windows can be horizontal or vertical, which can be changed interactively by typing | while the cursor is in the control window.
On a window display, Ediff sets up a dedicated frame for Ediff Control
Panel and then it chooses windows as follows: If one of the buffers
is invisible, it is displayed in the currently selected frame. If
a buffer is visible, it is displayed in the frame where it is visible.
If, according to the above criteria, the two buffers fall into the same
frame, then so be it---the frame will be shared by the two. The same
algorithm works when you type C-l (
The above behavior also depends on whether the current frame is splittable, dedicated, etc. Unfortunately, the margin of this book is too narrow to present the details of this remarkable algorithm.
The upshot of all this is that you can compare buffers in one frame or in different frames. The former is done by default, while the latter can be achieved by arranging buffers A, B (and C, if applicable) to be seen in different frames. Ediff respects these arrangements, automatically adapting itself to the multi-frame mode.
Ediff uses the following variables to set up its control panel (a.k.a. control buffer, a.k.a. quick help window):
You can change or augment this variable including the font, color,
etc. The X resource name of Ediff Control Panel frames is `
In general, any X resource pertaining the control frame can be reached
via the prefix
The preferred way of specifying the position of the control frame is by
setting the variable
The following variables can be used to adjust the location produced by
ediff-make-frame-position and for related customization.
Specifies the number of characters for shifting the control frame from the rightmost edge of frame A when the control frame is displayed as a small window.
Specifies the rightward shift of the control frame from the left edge of frame A when the control frame shows the full menu of options.
Specifies the number of pixels for the upward shift of the control frame.
If this variable is
To start Ediff with an iconified Control Panel, you should set this
To make more creative changes in the way Ediff sets up windows, you can
rewrite the function
ediff-setup-windows. However, we believe
that detaching Ediff Control Panel from the rest and making it into a
separate frame offers an important opportunity by allowing you to
iconify that frame. The icon will usually accept all of the Ediff
commands, but will free up valuable real estate on your screen (this may
depend on your window manager, though).
The following variable controls how windows are set up:
The multiframe setup is done by the
If you don't like any of these setups, write your own function. See the
You can run multiple Ediff sessions at once, by invoking Ediff several times without exiting previous Ediff sessions. Different sessions may even operate on the same pair of files.
Each session has its own Ediff Control Panel and all the regarding a
particular session is local to the associated control panel buffer. You
can switch between sessions by suspending one session and then switching
to another control panel. (Different control panel buffers are
distinguished by a numerical suffix, e.g., `
Ediff Control Panel<3>'.)