Next: Options - Fontification, Previous: Options - Finding Files, Up: Options [Contents][Index]

### 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`.

Next: Options - Fontification, Previous: Options - Finding Files, Up: Options [Contents][Index]