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-directory | Directory, or list of directories, to search for \.bib files. |
refer-bib-files | List of \.bib files to search for references, |
refer-bib-files-regexp | Regexp matching a bibliography file declaration. |
refer-cache-bib-files | Variable 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 | () |