reftex: Options - Finding Files

 
 18.8 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 valid extensions for this file type.
      When a files is searched and it does not have any of the valid
      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’.