Variable: reftex-cite-prompt-optional-args

reftex-cite-prompt-optional-args is a customizable variable defined in reftex-vars.el.gz.

Value

maybe

Documentation

Non-nil means, prompt for empty optional arguments in cite macros.

When an entry in reftex-cite-format is given with square brackets to indicate optional arguments (for example \cite[][]{%l}), RefTeX can prompt for values. Possible values are:

nil Never prompt for optional arguments
t Always prompt
maybe Prompt only if reftex-citation was called with C-u (universal-argument) prefix arg

Unnecessary empty optional arguments are removed before insertion into the buffer. See reftex-cite-cleanup-optional-args.

Probably introduced at or before Emacs version 22.1.

Source Code

;; Defined in /usr/src/emacs/lisp/textmodes/reftex-vars.el.gz
(defcustom reftex-cite-prompt-optional-args 'maybe
  "Non-nil means, prompt for empty optional arguments in cite macros.
When an entry in `reftex-cite-format' is given with square brackets to
indicate optional arguments (for example \\cite[][]{%l}), RefTeX can
prompt for values.  Possible values are:

nil     Never prompt for optional arguments
t       Always prompt
maybe   Prompt only if `reftex-citation' was called with \\[universal-argument] prefix arg

Unnecessary empty optional arguments are removed before insertion into
the buffer.  See `reftex-cite-cleanup-optional-args'."
  :group 'reftex-citation-support
  :type '(choice
          (const :tag "Always" t)
          (const :tag "When called with prefix arg" maybe)
          (const :tag "Never" nil)))