Node:General aspects, Next:Most important options, 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
ecb-compile-window-width

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-variables¹! 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!

Footnotes

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