GNU Info

(reftex)Options (Finding Files)

---

Next: Options (Optimizations) Prev: Options (Viewing Cross-References) Up: Options

---

Enter node , (file) or (file)node

Finding Files
=============

 - User Option: reftex-texpath-environment-variables
     List of specifications how to retrieve the search path for TeX
     files.  Several entries are possible.
        - If an element is the name of an environment variable, its
          content is used.

        - If an element starts with an exclamation mark, it is used as
          a command to retrieve the path.  A typical command with the
          kpathsearch library would be `"!kpsewhich -show-path=.tex"'.

        - Otherwise the element itself is interpreted as a path.
     Multiple directories can be separated by the system dependent
     `path-separator'.  Directories ending in `//' or `!!' will be
     expanded recursively.  See also `reftex-use-external-file-finders'.

 - User Option: reftex-bibpath-environment-variables
     List of specifications how to retrieve the search path for BibTeX
     files.  Several entries are possible.
        - If an element is the name of an environment variable, its
          content is used.

        - If an element starts with an exclamation mark, it is used as
          a command to retrieve the path.  A typical command with the
          kpathsearch library would be `"!kpsewhich -show-path=.bib"'.

        - Otherwise the element itself is interpreted as a path.
     Multiple directories can be separated by the system dependent
     `path-separator'.  Directories ending in `//' or `!!' will be
     expanded recursively.  See also `reftex-use-external-file-finders'.

 - User Option: reftex-file-extensions
     Association list with file extensions for different file types.
     This is a list of items, each item is like: `(TYPE . (DEF-EXT
     OTHER-EXT ...))'
          TYPE:       File type like `"bib"' or `"tex"'.
          DEF-EXT:    The default extension for that file type, like `".tex"' or `".bib"'.
          OTHER-EXT:  Any number of other legal extensions for this file type.
     When a files is searched and it does not have any of the legal
     extensions, we try the default extension first, and then the naked
     file name.

 - User Option: reftex-search-unrecursed-path-first
     Non-`nil' means, search all specified directories before trying
     recursion.  Thus, in a path `.//:/tex/', search first `./', then
     `/tex/', and then all subdirectories of `./'.  If this option is
     `nil', the subdirectories of `./' are searched before `/tex/'.
     This is mainly for speed - most of the time the recursive path is
     for the system files and not for the user files.  Set this to
     `nil' if the default makes RefTeX finding files with equal names
     in wrong sequence.

 - User Option: reftex-use-external-file-finders
     Non-`nil' means, use external programs to find files.  Normally,
     RefTeX searches the paths given in the environment variables
     `TEXINPUTS' and `BIBINPUTS' to find TeX files and BibTeX database
     files.  With this option turned on, it calls an external program
     specified in the option `reftex-external-file-finders' instead.
     As a side effect, the variables
     `reftex-texpath-environment-variables' and
     `reftex-bibpath-environment-variables' will be ignored.

 - User Option: reftex-external-file-finders
     Association list with external programs to call for finding files.
     Each entry is a cons cell `(TYPE . PROGRAM)'.  TYPE is either
     `"tex"' or `"bib"'.  PROGRAM is a string containing the external
     program to use with any arguments.  `%f' will be replaced by the
     name of the file to be found.  Note that these commands will be
     executed directly, not via a shell.  Only relevant when
     `reftex-use-external-file-finders' is non-`nil'.