Node:ecb-sources, Next:, Previous:ecb-directories, Up:Customizable options



Group ecb-sources

This group contains the following options:

show-source-file-extension User Option
Show the file extension of source files.

source-file-regexps User Option
Specifies which files are shown as source files.

This is done on directory-base, which means for each directory-regexp the files to display can be specified. If more than one direcory-regexp matches the current selected directory then always the first one (and its related file-exclude/include-regexps) is used! If no directory-regexp matches then all files are displayed for the currently selected directory.

Important note: It is recommended that the *LAST* element of this list should contain an always matching directory-regexp (".*")!

So the value of this option is a list of cons-cells where the car is a directory regexp and the cdr is a 2 element list where the first element is a exclude regexp and the second element is a include regexp. A file is displayed in the source-buffer of ECB iff: The file does not match the exclude regexp OR the file matches the include regexp. There are three predefined and useful combinations of an exclude and include regexp:

  • All files
  • All, but no backup, object, lib or ini-files (except .emacs and .gnus). This means all files except those starting with ".", "#" or ending with "~", ".elc", ".obj", ".o", ".lib", ".dll", ".a", ".so". (but including .emacs and .gnus)
  • Common source file types (.c, .java etc.)

In addition to these predefined values a custom exclude and include combination can be defined.

Tips for the directory- and file-rexexps: "$^" matches no files/directories, ".*" matches all files/directories.

sources-buffer-after-create-hook User Option
Local hook running after the creation of the sources-buffer. Every function of this hook is called once without arguments direct after creating the sources-buffer of ECB and it's local keymap. So for example a function could be added which performs calls of local-set-key to define new keybindings only for the sources-buffer of ECB.

sources-buffer-name User Option
Name of the ECB sources buffer. Because it is not a normal buffer for editing you should enclose the name with stars, e.g. "*ECB Sources*".

If it is necessary for you you can get emacs-lisp access to the buffer-object of the ECB-sources-buffer by this name, e.g. by a call of set-buffer.

Changes for this option at runtime will take affect only after deactivating and then activating ECB again!

sources-sort-method User Option
Defines how the source files are sorted.
  • name: Sorting by name.
  • extension: Sorting first by name and then by extension.
  • nil: No sorting, means source files are displayed in the sequence returned by directory-files (called without sorting).