Node:ecb-layout, Next:ecb-compilation-content, Previous:ecb-history, Up:Customizable options
This group contains the following options:
activate-before-new-frame-created-hook | User Option |
Normal hook run before the new ECB-frame is created if
ecb-new-ecb-frame is not nil (otherwise this hook is not
evaluated).
|
advice-window-functions | User Option |
Use the intelligent windows functions of ECB instead of the standard
Emacs functions. You can choose the following functions to be adviced
by ECB so they behave as if the edit-window(s) of ECB would be the
only windows(s) of the ECB-frame:
For working most conveniantly with ECB it is the best to advice all these functions, because then all the standard shortcuts of these functions are also usable with ECB without doing anything else. Also other packages can interact best with ECB if these functions are all adviced. If these adviced functions are called in another frame than the ECB-frame they behave all exactly like the not adviced versions! But please read also the following: Normally all packages should work correct with ECB and itīs adviced functions but if there occur problems with a package cause of some of these adviced functions ECB offers the following fall-back solution:
Here is an example: Suppose you must deactivating the advice for
|
compile-window-enlarge-by-select | User Option |
The compile-window is auto. enlarged after selecting it. If not nil
then selecting the ecb-compile-window auto. enlarges it and
deselecting (means selecting another window after point was in
ecb-compile-window ) auto. shrinks it. Enlarging and shrinking
the ecb-compile-window is done with
ecb-toggle-enlarged-compilation-window . See also the
documentation of this function!
|
compile-window-height | User Option |
If you want a compilation window shown at the bottom of the ECB-layout
then set here the height of it (Default is a height of 5). If you
redraw the current layout with ecb-redraw-layout then the
compilation window (if any) has the heigth you set here. If the number
is less than 1.0 the height is a fraction of the frame height.
If you do not set a durable compilation window then doing a compilation splits temporally the edit window vertically if the edit window is not splitted already or uses the "other" edit window temporally for comilation output if the edit window is already splitted. This is the recommended value for this option! Beware: If you set a durable compilation window then ECB can not guarantee always behaving like a standard Emacs concerning displaying temp-buffers and compilation-buffers. It should work in most cases but maybe not in all. Just try it out. See also the option See Temp- and compile-buffers. Regardless of the settings you define here: If you have destroyed or
changed the ECB-screen-layout by any action you can always go back to
this layout with |
compile-window-temporally-enlarge | User Option |
Let Emacs temporally enlarge the compile-window of the ECB-layout.
This option has only an effect if The following values are possible:
To restore the ECB-layout after such a buffer-enlarge just call
|
enlarged-compilation-window-max-height | User Option |
The max height of the compilation window after enlarging it by
ecb-toggle-enlarged-compilation-window . The following values
are allowed:
|
fix-window-size | User Option |
Fix size of the ECB-windows/buffers even after frame-resizing. The fix
type (valid values are nil, t, width and height) can either be set on
a layout-basis (means a different value for each layout) or one value
can be set for all layouts.
For a detailed description of the valid values see description of
Note1: The description of Note2: With current Emacs 21.2.X there seems to be no distinction
between Per default no window-size fixing has been done. |
hide-ecb-windows-after-hook | User Option |
Hooks run direct after the ECB windows have been hidden
either by ecb-toggle-ecb-windows or ecb-hide-ecb-windows .
|
hide-ecb-windows-before-hook | User Option |
Hooks run direct before the ECB windows will be hidden either by
ecb-toggle-ecb-windows or ecb-hide-ecb-windows . This means that at runtime
of this hook all the ECB-tree-windows of current layout are visible.
|
layout-always-operate-in-edit-window | User Option |
Adviced window functions work always in the edit-window. If we are in
an ECB special buffer (methods, directories, etc), and any of the
adviced windowing functions is called (see
ecb-advice-window-functions ), we will select the
ecb-edit-window first. This is useful if you have any functions
that use such functions and you don't want them to just error with a
method complaining that the current buffer can not be split, or
something similar.
Because this may not be desirable in all situations and all adviced
functions this can be enabled separately for every advisable function
(see also For Per default this is enabled for |
layout-name | User Option |
Select a window layout of ECB. Value is any arbitary string. There are
four different types of layouts: left, right, top and left-right,
which means the location of the ECB-tree-windows in the ECB-frame.
Currently there are 20 predefined layouts; names see below. You can
savely try out any of them by changing this value and saving it only
for the current session. If you are sure which layout you want you can
save it for future sessions. To get a picture of the layout for name
<name> call `ecb-show-layout-help'. ecb-layout-function-9 .
Currently available layouts:
Regardless of the settings you define here: If you have destroyed or
changed the ECB-screen-layout by any action you can always go back to
this layout with |
layout-switch-to-compilation-window | User Option |
Switch-to-buffer...-functions switch to ecb-compile-window . If
the buffer argument of switch-to-buffer or
switch-to-buffer-other-window is an compilation buffer as
defined with ecb-compilation-buffer-p we will select the
ecb-compile-window first. This is useful if you always want
your compilation buffers within the compilation window and now within
the edit window.
Note the difference between
Per default this is only enabled for |
layout-window-sizes | User Option |
Specifies the sizes of the ECB windows for each layout. The easiest
way (and also the strongly recommended way) to change this variable is
to change the window sizes by dragging the window borders using the
mouse and then store the window sizes by calling the command
ecb-store-window-sizes . Next time the layout is redrawn the
values stored in this option will be used.
If If this option is set "by hand" (i.e. not by
|
new-ecb-frame | User Option |
Create a new frame at activation time of ECB. |
other-window-jump-behavior | User Option |
Which windows of ECB should be accessible by the ECB-adviced function
other-window , an intelligent replacement for the Emacs standard
version of other-window . The following settings are possible:
|
redraw-layout-after-hook | User Option |
Hooks run direct before the ECB windows will be shown either by
ecb-toggle-ecb-windows or ecb-show-ecb-windows . This
means that at runtime of this hook the ECB-windows are already
visible.
|
redraw-layout-before-hook | User Option |
Hooks run direct before the ECB-layout will be redrawn by either
ecb-redraw-layout .
|
redraw-layout-quickly | User Option |
If non-nil, we will attempt to redraw the layout quickly. Please read
also carefully the documentation of ecb-redraw-layout .
|
select-edit-window-on-redraw | User Option |
Select the first edit window on ecb-redraw-layout .
|
show-ecb-windows-after-hook | User Option |
Hooks run direct before the ECB windows will be shown either by
ecb-toggle-ecb-windows or ecb-show-ecb-windows . This
means that at runtime of this hook the ECB-windows are already
visible.
IMPORTANT: Showing the hidden ECB-windows is internally done by
calling
|
show-ecb-windows-before-hook | User Option |
Hooks run direct before the ECB windows will be shown either by
ecb-toggle-ecb-windows or ecb-show-ecb-windows . This
means that at runtime of this hook the ECB-windows are still hidden.
IMPORTANT: Showing the hidden ECB-windows is internally done by
calling
|
split-edit-window | User Option |
Sets how and if the edit window should be splitted. But be aware: This option determines only if the edit-window should be splitted at start-time of ECB. |
toggle-layout-sequence | User Option |
Toggle sequence for layout toggling with ecb-toggle-layout .
Every element of this list has to be a valid layout-name i.e. either
one of the predefined layouts or one of the user-defined layouts.
You can add here as many layouts as you want but to use this option
most effective you should not add more than 2 or 3 layouts so every
layout can be accessed very fast by toggling with
Recommended values are for example:
See also option This option makes only sense if the value is a list with more than 1 element! |
windows-height | User Option |
The height of the ECB windows in lines when they are placed above or below the edit window. If the number is less than 1.0 the width is a fraction of the frame height. |
windows-width | User Option |
The width of the ECB windows in columns when they are placed to the left or right of the edit window. If the number is less than 1.0 the width is a fraction of the frame width. |