Node:General aspects, Next:, Previous:Customizing, Up:Customizing

General aspects for customizing ECB

The best way to customize all the options of ECB is via the customize-feature of (X)Emacs, i.e. means calling the commands customize-option or customize-group etc. This is also the strongly recommended way!

But of course you can also use setq or some Elisp-code to change the values of many but not all of the options. The values of the following options MUST NOT be changed via setq or Elisp-code but only with the customize-feature!

ecb-advice-window-functions ecb-bucket-token-display
ecb-compile-window-height ecb-compile-window-temporally-enlarge
ecb-exclude-parents-regexp ecb-font-lock-tokens
ecb-highlight-token-with-point-delay ecb-key-map
ecb-layout-name ecb-layout-window-sizes
ecb-mode-line-prefixes ecb-show-node-info-in-minibuffer
ecb-show-tokens ecb-source-path
ecb-token-display-function ecb-tree-RET-selects-edit-window
ecb-type-token-display ecb-windows-height
ecb-window-sync-delay ecb-windows-width
ecb-use-speedbar-instead-native-tree-buffer ecb-toggle-layout-sequence
ecb-mode-line-data ecb-mode-line-display-window-number

IMPORTANT: If you are the administrator for an Emacs-site, means you are responsible for the basic customization of a lot of Emacs users, then you maybe need a way to customize Emacs and ECB without changing everyones .emacs-file and normally you will do this with the file site-start.el. You can customize all options of ECB in a central site-start.el (even the options mentioned above!) but you MUST NOT do this via setq but you have to use custom-set-variables1! Here is a short example how this can be done:

(custom-set-variables '(ecb-show-tokens ((include collapsed nil)
                                         (parent collapsed nil)
                                         (type flattened nil)
                                         (variable collapsed name)
                                         (function flattened name)
                                         (rule flattened name)
                                         (section flattened nil)
                                         (def collapsed name)
                                         (t collapsed name)))
                      '(ecb-font-lock-tokens t)
                      ;; add here more options of ECB it you want

But ensure that you customize the options with the correct lisp format. Read carefully the docstrings of the options you want to customize from within Elisp-code!


  1. At least for the options for which setq is explicitly forbidden, but it is recommended to use always custom-set-variables!