File: refer.el.html

Functions to look up references in bibliography files given lists of keywords, similar to refer(1). I don't use tags since tags on .bib files only picks up the cite key, where as refer-find-entry looks for occurrences of keywords anywhere in the bibliography entry.

To use:
     (autoload 'refer-find-entry "refer" nil t)
or (require 'refer)

     To look for an article by Knuth about semaphores:
         Invoke refer-find-entry, then in response to the Keywords: prompt,
         say: Knuth semaphores (a blank-separated list of keywords to be used
         as search strings).

     To continue the previous search, i.e., to search for the next occurrence
     of the keywords, use refer-find-next-entry, or invoke refer-find-entry
     with a prefix argument.

Once you've found the entry you want to reference, invoke refer-yank-key to insert it at point in the current buffer
(typically as the argument of a \cite{} command).

I use (define-key tex-mode-map "\\C-c\\C-y" 'refer-yank-key)
to bind this often-used function to a key in (la)tex-mode.

     If the list of bibliography files changes, reinitialize the variable
     refer-bib-files.

To customize:
     See variables refer-bib-files, refer-cache-bib-files and
     refer-bib-files-regexp. By default, these are set up so that refer
     looks for the keywords you specify in all the .bib files in the current
     directory.

     The only assumption I make about bib files is that they contain a bunch
     of entries, one to a paragraph. refer-find-entry searches paragraph by
     paragraph, looking for a paragraph containing all the keywords
     specified. So you should be able to use pretty much any bib file with
     this code. If your bib file does not use paragraphs to separate
     entries, try setting the paragraph-start/separate variables, or changing
     the (forward-paragraph 1) call in refer-find-entry-in-file.

Defined variables (4)

refer-bib-directoryDirectory, or list of directories, to search for \.bib files.
refer-bib-filesList of \.bib files to search for references,
refer-bib-files-regexpRegexp matching a bibliography file declaration.
refer-cache-bib-filesVariable determining whether the value of ‘refer-bib-files’ should be cached.

Defined functions (8)

refer-convert-string-to-list-of-strings(S)
refer-every(PRED SEQUENCE)
refer-expand-files(FILE-LIST DIR-LIST)
refer-find-entry(KEYWORDS &optional CONTINUE)
refer-find-entry-in-file(KEYWORDS-LIST FILE &optional OLD-POS)
refer-find-entry-internal(KEYWORDS CONTINUE)
refer-find-next-entry()
refer-yank-key()

Defined faces (0)