ECB Sources window - ecb-home/ecb GitHub Wiki

ECB Sources-Window

ECB offers an ECB-window for displaying source-file-names of a certain directory: The sources-window. It displays all source-file names of the currently selected directory of the directories-ECB-window (see ECB Directories-window).

The history-tree-buffer is a “flat” tree-buffers means all nodes are direct children of the invisible root-node and can not be expanded.

Usage of the ECB-Sources-Window

  • Source files can be selected by clicking with the primary mouse button (see Using the mouse) or hitting RETURN (see Using the keyboard) on the source row in the -ECB-Sources-window-. The buffer of the selected source-file will be displayed in an edit-window - which one depends on the setting in ecb-mouse-click-destination.

    IMPORTANT: If you use the POWER-click (i.e. hold down the SHIFT-key while clicking with the primary mouse button (see Using the mouse) or RETURN (see Using the keyboard)) on a source row in the ECB-Sources-windows then the source will not be displayed in an edit-window but it will be scanned in the background and all its contents (e.g. methods and variables) are listed in the ECB-Methods-window (see ECB Methods-window) so you can get an overlook over the source without changing the buffer in the edit-window.

  • Clicking on the source file with the secondary mouse button or C-RETURN (see Usage of ECB) will open the source file in another edit window - which one depends on the setting in ecb-mouse-click-destination.

  • Right clicking on a source file (mouse-button 3) will open a popup menu where different operation on the item under the mouse cursor can be performed. This popup-menu offers operations for version-control, dired, grep, filtering the file-names and some file-operations like deleting the related file from disk. In addition the ECB-Sources-window can be maximized via the popup-menu.

Activating/Displaying the ECB-Sources-Window

Either use one of the predefined layouts which contain the sources ECB-window (see Changing the ECB-layout) (e.g. via C-c . l c) or create a new ecb-layout via the command eco-create-new-layout and add a buffer of type “sources” into this new layout (see Creating a new ECB-layout).

Customizing the ECB-Sources-Window

See ecb-sources for a list of all options currently available for customizing this ECB-window to your needs.