18.4 Referencing Labels

User Option: reftex-label-menu-flags

List of flags governing the label menu makeup. The flags are:


Show the labels embedded in a table of context.


Include section numbers (like 4.1.3) in table of contents.


Show counters. This just numbers the labels in the menu.


Non-nil means do not show the short context.


Follow full context in other window.


Show labels from regions which are commented out.


Obsolete flag.


Show begin and end of included files.

Each of these flags can be set to t or nil, or to a string of type letters indicating the label types for which it should be true. These strings work like character classes in regular expressions. Thus, setting one of the flags to ‘"sf"’ makes the flag true for section and figure labels, nil for everything else. Setting it to ‘"^sf"’ makes it the other way round.

The available label types are: s (section), f (figure), t (table), i (item), e (equation), n (footnote), plus any definitions in reftex-label-alist.

Most options can also be switched from the label menu itself, so if you decide here to not have a table of contents in the label menu, you can still get one interactively during selection from the label menu.

User Option: reftex-multiref-punctuation

Punctuation strings for multiple references. When marking is used in the selection buffer to select several references, this variable associates the 3 marking characters ‘,-+’ with prefix strings to be inserted into the buffer before the corresponding \ref macro. This is used to string together whole reference sets, like ‘eqs. 1,2,3-5,6 and 7’ in a single call to reftex-reference.

User Option: reftex-ref-style-alist

Alist of reference styles. Each element is a list of the style name, the name of the LaTeX package associated with the style or t for any package, and an alist of macros where the first entry of each item is the reference macro and the second a key for selecting the macro when the macro type is being prompted for. (See also reftex-ref-macro-prompt.) The keys, represented as characters, have to be unique.

User Option: reftex-ref-style-default-list

List of reference styles to be activated by default. The order is significant and controls the order in which macros can be cycled in the buffer for selecting a label. The entries in the list have to match the respective reference style names used in the variable reftex-ref-style-alist.

User Option: reftex-ref-macro-prompt

Controls if reftex-reference prompts for the reference macro.

Hook: reftex-format-ref-function

If non-nil, should be a function which produces the string to insert as a reference. Note that the insertion format can also be changed with reftex-label-alist. This hook also is used by the special commands to insert, e.g., \vref and \fref references, so even if you set this, your setting will be ignored by the special commands. The function will be called with three arguments, the label, the default format which normally is ‘~\ref{%s}’ and the reference style. The function should return the string to insert into the buffer.

User Option: reftex-level-indent

Number of spaces to be used for indentation per section level.

User Option: reftex-guess-label-type

Non-nil means, reftex-reference will try to guess the label type. To do that, RefTeX will look at the word before the cursor and compare it with the magic words given in reftex-label-alist. When it finds a match, RefTeX will immediately offer the correct label menu; otherwise it will prompt you for a label type. If you set this variable to nil, RefTeX will always prompt for a label type.

Normal Hook: reftex-display-copied-context-hook

Normal Hook which is run before context is displayed anywhere. Designed for X-Symbol, but may have other uses as well.

Hook: reftex-pre-refontification-functions

X-Symbol specific hook. Probably not useful for other purposes. The functions get two arguments, the buffer from where the command started and a symbol indicating in what context the hook is called.

Normal Hook: reftex-select-label-mode-hook

Normal hook which is run when a selection buffer enters reftex-select-label-mode.

Keymap: reftex-select-label-mode-map

The keymap which is active in the labels selection process (see Referencing Labels).