Node:ecb-directories, Next:ecb-sources, Previous:ecb-tree-buffer, Up:Customizable options
This group contains settings for the directories-buffer in the ECB:
add-path-for-not-matching-files | User Option |
Add path of a file to ecb-source-path if not already contained.
This is done during the auto. windows synchronization which happens if
a file is opened not via the file/directory-browser of ECB. In such a
situation ECB adds the path of the new file auto. to
ecb-source-path at least temporally for the current Emacs
session. This option defines two things:
The value of this option is a cons-cell where the car is a boolean for 1. and the cdr is a boolean for 2. A value of not nil for the car (1.) is reasonably if a user often
opens files not via the ECB-browser which are not located in any of
the paths of |
auto-expand-directory-tree | User Option |
Automatically expand the directory tree to the current source file.
There are three options:
|
cache-directory-contents | User Option |
Cache contents of directories.
This can be useful if The value of this option is a list where each element is a cons-cell
and looks like:
(<dir-regexp> . <filenumber threshold>) with
A directory will only be cached if and only if the directory-name
matches at least one rexexp of this option and its content-number
exceeds the related threshold AND the directory-name matches NOT any
regexp of The cache entry for a certain directory will be refreshed and
actualized only by using the POWER-click (see
Examples: A value of A value of A value of Please note: If you want your home-dir being cached then you MUST NOT use "~" because ECB tries always to match full path-names! |
cache-directory-contents-not | User Option |
Do not cache the contents of certain directories. The value of this
option is a list where the each element is a regular expression a
directory must match if it should not being cached.
If a directory-name matches at least one of the regexps of this option
the directory-contents will never being cached. See
This option can be useful when normally all directories with a certain amount of content (files and subdirs) should be cached but some special directories not. This can be achieved by:
Please note: If you want your home-dir exclude from being cached then you MUST NOT use "~" because ECB tries always to match full path-names! |
directories-buffer-after-create-hook | User Option |
Local hook running after the creation of the directories-buffer. Every
function of this hook is called once without arguments direct after
creating the directories-buffer of ECB and it's local key-map. So for
example a function could be added which performs calls of
local-set-key to define new keybindings only for the
directories-buffer of ECB.
The following keys must not be rebind in the directories-buffer: F2, F3 and F4 |
directories-buffer-name | User Option |
Name of the ECB directory buffer. Because it is not a normal buffer
for editing you should enclose the name with stars, e.g. " *ECB
Directories*".
If it is necessary for you you can get emacs-lisp access to the buffer-object of
the ECB-directory-buffer by this name, e.g. by a call of Changes for this option at runtime will take affect only after deactivating and then activating ECB again! |
directories-menu-sorter | User Option |
Function which re-sorts the menu-entries of the directories buffer.
If a function then this function is called to re-arrange the
menu-entries of the combined menu-entries of the user-menu-extensions
of The function get one argument, a list of menu-entries. For the format
of this argument see |
directories-menu-user-extension | User Option |
Static user extensions for the popup-menu of the directories buffer.
Value is a list of elements of the following type: Each element
defines a new menu-entry and is either:
The function of a menu-command must follow the following guidelines:
Such a function must be defined with the macro
Example for the definition of such a menu-function:
(tree-buffer-defpopup-command ecb-my-special-dir-popup-function "Prints the name of the directory of the node under point." (let ((node-data=dir (tree-node-get-data node))) (message ``Dir under node: %s'' node-data=dir))) Per default the static user-extensions are added at the beginning of
the built-in menu-entries of These menu-extensions are static. A dynamic menu-extension can be
achieved via |
directories-menu-user-extension-function | User Option |
Dynamic user extensions for the popup-menu of the directories buffer.
A function which has to return a list in the same format like the
option ecb-directories-menu-user-extension . This function is
called when the user opens the popup-menu for the directories buffer.
Per default the dynamic user-extensions are added in front of the
static extensions of |
display-default-dir-after-start | User Option |
Automatically display current default-directory after activating ECB.
If a file-buffer is displayed in the current active edit-window then
ECB synchronizes its tree-buffers to this file-buffer - at least if
the option If true then ECB selects autom. the current default-directory after activation even if no file-buffer is displayed in the current active edit-window. This is useful if ECB is autom. activated after startup of Emacs and Emacs is started without a file-argument. So the directory from which the startup has performed is auto. selected in the ECB-directories buffer and the ECB-sources buffer displays the contents of this directory. |
excluded-directories-regexp | User Option |
Directories that should not be included in the directories list. The value of this variable should be a regular expression. |
show-sources-in-directories-buffer | User Option |
Show source files in directories buffer. |
source-path | User Option |
Paths where to find code sources. Each path can have an optional alias that is used as it's display name. If no alias is set, the path is used as display name. |
use-speedbar-instead-native-tree-buffer | User Option |
If true then uses speedbar for directories, sources or methods. This
means that speedbar is integrated in the ECB-frame and is displayed in
that window normally displaying the standard ECB-directories-buffer,
ECB-sources-buffer or ECB-methods-buffer.
This option takes effect in all layouts which contain either a directory window, a sources window or a method window. This option can have four valid values:
Note: For directories and sources a similar effect and usability is
available by setting this option to
|