Function: bib-display

bib-display is an interactive and byte-compiled function defined in bib-cite.el.

Signature

(bib-display)

Documentation

Display BibTeX citation or matching \ref or \label command under point.

If text under cursor is a \cite command, then display its BibTeX info from
\bibliography input file.
   Example with cursor located over cite command or arguments:
     \cite{Wadhams81,Bourke.et.al87,SchneiderBudeus94}
        ^Display-all-citations ^Display-this-citation

If text under cursor is a \ref command, then display environment associated with its matching \label command.

If text under cursor is a \label command, then display the text around the first matching \ref command.

The user is prompted for a \label or \ref is nothing suitable is found under the cursor. The first prompt is for a label. If you answer with an empty string, a second prompt for a ref will be given.

A TAGS file is created and used for multi-file documents under auctex.

Key Bindings

Source Code

;; Defined in ~/.emacs.d/elpa/auctex-14.1.2/bib-cite.el
(defun bib-display ()
  "Display BibTeX citation or matching \\ref or \\label command under point.

If text under cursor is a \\cite command, then display its BibTeX info from
\\bibliography input file.
   Example with cursor located over cite command or arguments:
     \\cite{Wadhams81,Bourke.et.al87,SchneiderBudeus94}
        ^Display-all-citations          ^Display-this-citation

If text under cursor is a \\ref command, then display environment associated
with its matching \\label command.

If text under cursor is a \\label command, then display the text around
the first matching \\ref command.

The user is prompted for a \\label or \\ref is nothing suitable is found under
the cursor.  The first prompt is for a label.  If you answer with an empty
string, a second prompt for a ref will be given.

A TAGS file is created and used for multi-file documents under auctex."
  (interactive)
  (let ((kind (bib-cite--kind)))
    (cond
     ;; reftex doesn't handle label->ref
     ((and bib-cite-use-reftex-view-crossref
           (memq kind '(ref cite)))
      ;;;FIXME: reftex doesn't want point on \ref or \cite part, but on keyword
      (require 'reftex)
      (reftex-view-crossref nil))
     ((eq kind 'cite)
      (bib-display-citation))
     (t
      (bib-display-label)))))