18.9 Optimizations

User Option: reftex-keep-temporary-buffers

Non-nil means, keep buffers created for parsing and lookup. RefTeX sometimes needs to visit files related to the current document. We distinguish files visited for

PARSING

Parts of a multifile document loaded when (re)-parsing the document.

LOOKUP

BibTeX database files and TeX files loaded to find a reference, to display label context, etc.

The created buffers can be kept for later use, or be thrown away immediately after use, depending on the value of this variable:

nil

Throw away as much as possible.

t

Keep everything.

1

Throw away buffers created for parsing, but keep the ones created for lookup.

If a buffer is to be kept, the file is visited normally (which is potentially slow but will happen only once). If a buffer is to be thrown away, the initialization of the buffer depends upon the variable reftex-initialize-temporary-buffers.

User Option: reftex-initialize-temporary-buffers

Non-nil means do initializations even when visiting file temporarily. When nil, RefTeX may turn off find-file hooks and other stuff to briefly visit a file. When t, the full default initializations are done (find-file-hook etc.). Instead of t or nil, this variable may also be a list of hook functions to do a minimal initialization.

User Option: reftex-no-include-regexps

List of regular expressions to exclude certain input files from parsing. If the name of a file included via \include or \input is matched by any of the regular expressions in this list, that file is not parsed by RefTeX.

User Option: reftex-enable-partial-scans

Non-nil means, re-parse only 1 file when asked to re-parse. Re-parsing is normally requested with a C-u prefix to many RefTeX commands, or with the r key in menus. When this option is t in a multifile document, we will only parse the current buffer, or the file associated with the label or section heading near point in a menu. Requesting re-parsing of an entire multifile document then requires a C-u C-u prefix or the capital R key in menus.

User Option: reftex-save-parse-info

Non-nil means, save information gathered with parsing in files. The file MASTER.rel in the same directory as MASTER.tex is used to save the information. When this variable is t,

  • accessing the parsing information for the first time in an editing session will read that file (if available) instead of parsing the document.
  • exiting Emacs or killing a buffer in reftex-mode will cause a new version of the file to be written.
User Option: reftex-parse-file-extension

File extension for the file in which parser information is stored. This extension is added to the base name of the master file.

User Option: reftex-allow-automatic-rescan

Non-nil means, RefTeX may rescan the document when this seems necessary. Applies (currently) only in rare cases, when a new label cannot be placed with certainty into the internal label list.

User Option: reftex-use-multiple-selection-buffers

Non-nil means use a separate selection buffer for each label type. These buffers are kept from one selection to the next and need not be created for each use, so the menu generally comes up faster. The selection buffers will be erased (and therefore updated) automatically when new labels in its category are added. See the variable reftex-auto-update-selection-buffers.

User Option: reftex-auto-update-selection-buffers

Non-nil means, selection buffers will be updated automatically. When a new label is defined with reftex-label, all selection buffers associated with that label category are emptied, in order to force an update upon next use. When nil, the buffers are left alone and have to be updated by hand, with the g key from the label selection process. The value of this variable will only have any effect when reftex-use-multiple-selection-buffers is non-nil.