6. Tags-like Functions

Ebrowse provides tags functions similar to those of the standard Emacs Tags facility, but better suited to the needs of C++ programmers.

6.1 Finding and Viewing Members		Going to a member declaration/definition
6.2 The Position Stack		Moving to previous locations
6.3 Searching and Replacing		Searching and replacing over class tree files
6.4 Members in Files		Listing all members in a given file
6.5 Member Apropos		Listing members matching a regular expression
6.6 Symbol Completion		Completing names while editing
6.7 Quick Member Display		Quickly display a member buffer for some identifier

6.1 Finding and Viewing Members

The functions in this section are similar to those described in 4.1 Viewing and Finding Class Declarations, and also in 5.2 Finding and Viewing Member Source, except that they work in a C++ source buffer, not in member and tree buffers created by Ebrowse.

C-c b f

Find the definition of the member around point. If you invoke this function with a prefix argument, the declaration is searched.

If more than one class contains a member with the given name you can select the class with completion. If there is a scope declaration in front of the member name, this class name is used as initial input for the completion.

C-c b F

Find the declaration of the member around point.

C-c b v

View the definition of the member around point.

C-c b V

View the declaration of the member around point.

C-c b 4 f

Find a member's definition in another window.

C-c b 4 F

Find a member's declaration in another window.

C-c b 4 v

View a member's definition in another window.

C-c b 4 V

View a member's declaration in another window.

C-c b 5 f

Find a member's definition in another frame.

C-c b 5 F

Find a member's declaration in another frame.

C-c b 5 v

View a member's definition in another frame.

C-c b 5 V

View a member's declaration in another frame.

6.2 The Position Stack

When jumping to a member declaration or definition with one of Ebrowse's commands, the position from where you performed the jump and the position where you jumped to are recorded in a position stack. There are several ways in which you can quickly move to positions in the stack:

C-c b -

This command sets point to the previous position in the position stack. Directly after you performed a jump, this will put you back to the position where you came from.

The stack is not popped, i.e. you can always switch back and forth between positions in the stack. To avoid letting the stack grow to infinite size there is a maximum number of positions defined. When this number is reached, older positions are discarded when new positions are pushed on the stack.

C-c b +

This command moves forward in the position stack, setting point to the next position stored in the position stack.

C-c b p

Displays an electric buffer showing all positions saved in the stack. You can select a position by pressing SPC in a line. You can view a position with v.

6.3 Searching and Replacing

Ebrowse allows you to perform operations on all or a subset of the files mentioned in a class tree. When you invoke one of the following functions and more than one class tree is loaded, you must choose a class tree to use from an electric tree menu. If the selected tree contains marked classes, the following commands operate on the files mentioned in the marked classes only. Otherwise all files in the class tree are used.

C-c b s

This function performs a regular expression search in the chosen set of files.

C-c b u

This command performs a search for calls of a given member which is selected in the usual way with completion.

C-c b %

Perform a query replace over the set of files.

C-c b ,

All three operations above stop when finding a match. You can restart the operation with this command.

C-c b n

This restarts the last tags operation with the next file in the list.

6.4 Members in Files

The command C-c b l, lists all members in a given file. The file name is read from the minibuffer with completion.

6.5 Member Apropos

The command C-c b a can be used to display all members matching a given regular expression. This command can be very useful if you remember only part of a member name, and not its beginning.

A special buffer is popped up containing all identifiers matching the regular expression, and what kind of symbol it is (e.g. a member function, or a type). You can then switch to this buffer, and use the command C-c b f, for example, to jump to a specific member.

6.6 Symbol Completion

The command C-c b TAB completes the symbol in front of point.

6.7 Quick Member Display

You can quickly display a member buffer containing the member the cursor in on with the command C-c b m.