Next: ecb-winman, Previous: ecb-speedbar, Up: Customizable options
This group contains settings for parsing and displaying non-semantic files:
Automatic saving of current buffer before rebuilding its methods.
This option is only relevant for sources which are supported and parsed by etags (see
ecb-process-non-semantic-files
). Because etags is an external tool a source-buffer can only be reparsed if the buffer is saved to disk. So the commandecb-rebuild-methods-buffer
checks for sources which are not supported by semantic or imenu if either this option is t or if the major-mode of the source-buffer is contained in this list: In both cases ECB saves the current source-buffer before it re-runs etags for reparsing the source. If nil or if the major-mode is not contained then no automatic saving will be done!For all source supported by semantic or by imenu this option takes no effect.
Exclude modes from parsing with imenu or etags. Per default, ECB tries to parse all file-types not supported by semantic with imenu or etags or some other method (for details see the option
ecb-non-semantic-parsing-function
). If a file-type can not be parsed by semantic, imenu or etags than this simply results in an empty method-buffer for this file. But nevertheless you will get a message “Sorry, no support for a file of that extension” which comes from the speedbar-library and can not switched off. Therefore if amajor-mode
is known as not parse-able by semantic, imenu or etags it can be added to this option and then it will be excluded from being tried to parsed.
Initially expand all tags for not by semantic supported sources. This option can be customized on a major-mode basis, i.e. if a
major-mode
is contained in this option then all tags for this modes will be initially expanded - otherwise not.
Define mode-dependent parsing functions for non-semantic files. This is an alist where the car is a major-mode symbol and the cdr is a function-symbol of a function which should be used for parsing a non-semantic buffer, i.h. a buffer for which no semantic grammar exists. Such a function gets one argument - the filename of current buffer - and has to generate and return a tag/tag list which is understandable by
speedbar-insert-generic-list
. speedbar has already included two functionsspeedbar-fetch-dynamic-imenu
andspeedbar-fetch-dynamic-etags
which can be used for parsing buffers with imenu rsp. etags.This option takes only effect if
ecb-process-non-semantic-files
is not nil: Then ECB checks for non-semantic buffers if currentmajor-mode
is contained in this option and if yes, then the specified parsing function is called; if not then the cars of the elements ofspeedbar-dynamic-tags-function-list
are called in that sequence they are listed in this variable. See optionspeedbar-dynamic-tags-function-list
for further details.In most cases imenu-parsing is preferable over etags-parsing because imenu operates on Emacs-buffers and needs no external tool and therefore parsing works also if current contents of a buffer are not saved to disk. But maybe sometimes etags may return better parsing results
IMPORTANT: if imenu-parsing should be used then the option
speedbar-use-imenu-flag
must be set to not nil!
Display content of non-semantic-files in the ECB-methods-buffer. See also
ecb-non-semantic-parsing-function
.
Hook running at beginning of the function
ecb-rebuild-methods-buffer-for-non-semantic
. This function is always called by the commandecb-rebuild-methods-buffer
for not semantic supported source-types.Every function of this hook gets one argument: The complete filename of the current source-buffer in the edit-window. The Method-buffer is only rebuild by
ecb-rebuild-methods-buffer-for-non-semantic
if either the hook contains no function (the default) or if no function of this hook returns nil! Seerun-hook-with-args-until-failure
for description how these function are processed.