Version-control support - ECB - the Emacs Code Browser
Description: ECB - the Emacs Code Browser

Next: Using eshell, Previous: Remote directories, Up: Common use-cases

### 10.8 Supporting Version control systems

Beginning with version 2.30 ECB supports Version-control systems (in the following named VC-systems). This means the special tree-buffers of ECB display files managed by a VC-system with an appropriate image-icon1 in front of the filename.

The following four options allow full control over this feature (see also ecb-version-control:

`ecb-vc-enable-support`
  Enable or disable this feature.
`ecb-vc-supported-backends`
  The most important option for this feature. Allows to specify how ECB should test if a directory is managed by a VC-system (how to identify the VC-backend of a directory) and - if yes - how it should check the VC-state of a certain file. The former ones are called identify-backend-functions and the latter ones check-state-functions.
`ecb-vc-directory-exclude-regexps`
  Allows excluding certain directories (on a regexp-basis) from the VC-support even if they are managed by a VC-system.
`ecb-vc-state-mapping`
  Defines the mapping between the state-values returned by a check-state-function (a function set in `ecb-vc-supported-backends` and used for getting the VC-state of a file, e.g. `vc-state`) and the allowed state-values ECB can understand.

Probably the default settings will fit your needs but to get sure you should carefully read the documentation of these options!

The following subsection give you important informations about identify-backend-functions, check-state-functions, about working with remote repositories.

#### Footnotes

[1] Of course only when Emacs is capable to display images; otherwise a suitable ascii-icon will be displayed.