HCoop / bpt / emacs.git / blame
| Commit | Line | Data |
|---|---|---|
| 3afbc435 | 1 | ;;; reftex-vars.el --- configuration variables for RefTeX |
| d5a2f2b0 | 2 | |
| ba318903 | 3 | ;; Copyright (C) 1997-1999, 2001-2014 Free Software Foundation, Inc. |
| 3ba2590f | 4 | |
| 6fbeb429 | 5 | ;; Author: Carsten Dominik <dominik@science.uva.nl> |
| ce545621 | 6 | ;; Maintainer: auctex-devel@gnu.org |
| 3ba2590f RS |
7 | |
| 8 | ;; This file is part of GNU Emacs. | |
| 9 | ||
| 1fecc8fe | 10 | ;; GNU Emacs is free software: you can redistribute it and/or modify |
| 3ba2590f | 11 | ;; it under the terms of the GNU General Public License as published by |
| 1fecc8fe GM |
12 | ;; the Free Software Foundation, either version 3 of the License, or |
| 13 | ;; (at your option) any later version. | |
| 3ba2590f RS |
14 | |
| 15 | ;; GNU Emacs is distributed in the hope that it will be useful, | |
| 16 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | |
| 1fecc8fe | 17 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 3ba2590f RS |
18 | ;; GNU General Public License for more details. |
| 19 | ||
| 20 | ;; You should have received a copy of the GNU General Public License | |
| 1fecc8fe | 21 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
| 1a9461d0 | 22 | |
| 3afbc435 PJ |
23 | ;;; Commentary: |
| 24 | ||
| 25 | ;;; Code: | |
| 0c86715d | 26 | (defvar reftex-tables-dirty) |
| 7c4d13cc | 27 | (eval-when-compile (require 'cl)) |
| f541b8c6 MR |
28 | (eval-and-compile |
| 29 | (defun reftex-set-dirty (symbol value) | |
| 30 | (setq reftex-tables-dirty t) | |
| 31 | (set symbol value))) | |
| 1a9461d0 CD |
32 | |
| 33 | ;; Define the two constants which are needed during compilation | |
| 34 | ||
| 35 | (eval-and-compile | |
| 36 | (defconst reftex-label-alist-builtin | |
| 37 | '( | |
| 38 | ;; Some aliases, mostly for backward compatibility | |
| 39 | (Sideways "Alias for -->rotating" (rotating)) | |
| 40 | (AMSTeX "amsmath with eqref macro" | |
| 41 | ((nil ?e nil "~\\eqref{%s}") | |
| 42 | amsmath)) | |
| 43 | ||
| 44 | ;; Individual package defaults | |
| 45 | (amsmath "AMS-LaTeX math environments" | |
| 46 | (("align" ?e nil nil eqnarray-like) | |
| 47 | ("gather" ?e nil nil eqnarray-like) | |
| 48 | ("multline" ?e nil nil t) | |
| 49 | ("flalign" ?e nil nil eqnarray-like) | |
| 50 | ("alignat" ?e nil nil alignat-like) | |
| 51 | ("xalignat" ?e nil nil alignat-like) | |
| 52 | ("xxalignat" ?e nil nil alignat-like) | |
| 53 | ("subequations" ?e nil nil t))) | |
| 54 | ||
| 55 | (endnotes "The \\endnote macro" | |
| 56 | (("\\endnote[]{}" ?N "en:" "~\\ref{%s}" 2 | |
| 57 | (regexp "endnotes?" "notes?" "Anmerkung\\(en\\)?" "Anm\\.")))) | |
| 58 | ||
| 59 | (fancybox "The Beqnarray environment" | |
| 60 | (("Beqnarray" ?e nil nil eqnarray-like))) | |
| 61 | ||
| 62 | (floatfig "The floatingfigure environment" | |
| 63 | (("floatingfigure" ?f nil nil caption))) | |
| 64 | ||
| 65 | (longtable "The longtable environment" | |
| 66 | (("longtable" ?t nil nil caption))) | |
| 67 | ||
| 68 | (picinpar "The figwindow and tabwindow environments" | |
| 69 | (("figwindow" ?f nil nil 1) | |
| 70 | ("tabwindow" ?f nil nil 1))) | |
| 71 | ||
| 72 | (rotating "Sidewaysfigure and table" | |
| 73 | (("sidewaysfigure" ?f nil nil caption) | |
| 74 | ("sidewaystable" ?t nil nil caption))) | |
| 75 | ||
| 76 | (sidecap "CSfigure and SCtable" | |
| 77 | (("SCfigure" ?f nil nil caption) | |
| 78 | ("SCtable" ?t nil nil caption))) | |
| 79 | ||
| 80 | (subfigure "Subfigure environments/macro" | |
| 81 | (("subfigure" ?f nil nil caption) | |
| 82 | ("subfigure*" ?f nil nil caption) | |
| 83 | ("\\subfigure[]{}" ?f nil nil 1))) | |
| 84 | ||
| 85 | (supertab "Supertabular environment" | |
| 86 | (("supertabular" ?t nil nil "\\tablecaption{"))) | |
| 87 | ||
| 88 | (wrapfig "The wrapfigure environment" | |
| 89 | (("wrapfigure" ?f nil nil caption))) | |
| 90 | ||
| cfcc9cc8 | 91 | (ctable "The ctable package" |
| b2984e39 | 92 | (("\\ctable[]{}{}{}" ?t "tab:" "~\\ref{%s}" 1 ("table" "Tabelle")))) |
| cfcc9cc8 TH |
93 | |
| 94 | (listings "The listings package" | |
| 983741d8 | 95 | (("lstlisting" ?l "lst:" "~\\ref{%s}" nil (regexp "[Ll]isting")))) |
| cfcc9cc8 TH |
96 | |
| 97 | (minted "The minted package" | |
| 983741d8 | 98 | (("minted" ?l "lst:" "~\\ref{%s}" nil (regexp "[Ll]isting")))) |
| cfcc9cc8 | 99 | |
| 1a9461d0 CD |
100 | ;; The LaTeX core stuff |
| 101 | (LaTeX "LaTeX default environments" | |
| 102 | (("section" ?s "%S" "~\\ref{%s}" (nil . t) | |
| 103 | (regexp "parts?" "chapters?" "chap\\." "sections?" "sect?\\." | |
| 3666daf6 CD |
104 | "paragraphs?" "par\\." |
| 105 | "\\\\S" "\247" "Teile?" "Kapitel" "Kap\\." "Abschnitte?" | |
| 106 | "appendi\\(x\\|ces\\)" "App\\." "Anh\"?ange?" "Anh\\.")) | |
| 1a9461d0 CD |
107 | |
| 108 | ("enumerate" ?i "item:" "~\\ref{%s}" item | |
| 109 | (regexp "items?" "Punkte?")) | |
| c8de140b | 110 | |
| 1a9461d0 CD |
111 | ("equation" ?e "eq:" "~(\\ref{%s})" t |
| 112 | (regexp "equations?" "eqs?\\." "eqn\\." "Gleichung\\(en\\)?" "Gl\\.")) | |
| 113 | ("eqnarray" ?e "eq:" nil eqnarray-like) | |
| c8de140b | 114 | |
| 1a9461d0 CD |
115 | ("figure" ?f "fig:" "~\\ref{%s}" caption |
| 116 | (regexp "figure?[sn]?" "figs?\\." "Abbildung\\(en\\)?" "Abb\\.")) | |
| 117 | ("figure*" ?f nil nil caption) | |
| c8de140b | 118 | |
| 1a9461d0 CD |
119 | ("table" ?t "tab:" "~\\ref{%s}" caption |
| 120 | (regexp "tables?" "tab\\." "Tabellen?")) | |
| 121 | ("table*" ?t nil nil caption) | |
| c8de140b | 122 | |
| 1a9461d0 CD |
123 | ("\\footnote[]{}" ?n "fn:" "~\\ref{%s}" 2 |
| 124 | (regexp "footnotes?" "Fussnoten?")) | |
| c8de140b | 125 | |
| 1a9461d0 CD |
126 | ("any" ?\ " " "~\\ref{%s}" nil) |
| 127 | ||
| 128 | ;; The label macro is hard coded, but it *could* be defined like this: | |
| 129 | ;;("\\label{*}" nil nil nil nil) | |
| a0031f97 TH |
130 | )) |
| 131 | ||
| 132 | ;; Texinfo | |
| 133 | (Texinfo "Texinfo default environments" nil)) | |
| 1a9461d0 CD |
134 | "The default label environment descriptions. |
| 135 | Lower-case symbols correspond to a style file of the same name in the LaTeX | |
| 136 | distribution. Mixed-case symbols are convenience aliases.") | |
| 137 | ||
| 138 | (defconst reftex-cite-format-builtin | |
| 139 | '((default "Default macro \\cite{%l}" | |
| f3c18bd0 | 140 | "\\cite[]{%l}") |
| 1a9461d0 | 141 | (natbib "The Natbib package" |
| f3c18bd0 CD |
142 | ((?\C-m . "\\cite[][]{%l}") |
| 143 | (?t . "\\citet[][]{%l}") | |
| 144 | (?T . "\\citet*[][]{%l}") | |
| 145 | (?p . "\\citep[][]{%l}") | |
| 146 | (?P . "\\citep*[][]{%l}") | |
| 1a9461d0 CD |
147 | (?e . "\\citep[e.g.][]{%l}") |
| 148 | (?s . "\\citep[see][]{%l}") | |
| 149 | (?a . "\\citeauthor{%l}") | |
| 150 | (?A . "\\citeauthor*{%l}") | |
| 6fbeb429 CD |
151 | (?y . "\\citeyear{%l}") |
| 152 | (?n . "\\nocite{%l}"))) | |
| 3666daf6 CD |
153 | (amsrefs "The AMSRefs package" |
| 154 | ((?\C-m . "\\cite{%l}") | |
| 155 | (?p . "\\cite{%l}") | |
| 156 | (?P . "\\cites{%l}") | |
| 157 | (?t . "\\ocite{%l}") | |
| 158 | (?T . "\\ocites{%l}") | |
| 159 | (?y . "\\ycite{%l}") | |
| 160 | (?Y . "\\ycites{%l}") | |
| 161 | (?a . "\\citeauthor{%l}") | |
| 162 | (?A . "\\citeauthory{%l}") | |
| 163 | (?f . "\\fullcite{%l}") | |
| 164 | (?F . "\\fullocite{%l}") | |
| 165 | (?n . "\\nocite{%l}"))) | |
| 3a1e8128 CD |
166 | (jurabib "The Jurabib package" |
| 167 | ((?\C-m . "\\cite{%l}") | |
| 168 | (?c . "\\cite[][]{%l}") | |
| 169 | (?t . "\\citet{%l}") | |
| 170 | (?p . "\\citep{%l}") | |
| 171 | (?e . "\\citep[e.g.][]{%l}") | |
| 172 | (?s . "\\citep[see][]{%l}") | |
| 173 | (?u . "\\fullcite{%l}") | |
| 174 | (?i . "\\citetitle{%l}") | |
| 175 | (?a . "\\citeauthor{%l}") | |
| 176 | (?e . "\\citefield{}{%l}") | |
| 177 | (?y . "\\citeyear{%l}") | |
| 178 | (?f . "\\footcite{%l}") | |
| 179 | (?F . "\\footcite[][]{%l}") | |
| 180 | (?l . "\\footfullcite{%l}"))) | |
| d8fb2015 CD |
181 | (bibentry "The Bibentry package" |
| 182 | "\\bibentry{%l}") | |
| 1a9461d0 | 183 | (harvard "The Harvard package" |
| f3c18bd0 CD |
184 | ((?\C-m . "\\cite[]{%l}") |
| 185 | (?p . "\\cite[]{%l}") | |
| 1a9461d0 CD |
186 | (?t . "\\citeasnoun{%l}") |
| 187 | (?n . "\\citeasnoun{%l}") | |
| 188 | (?s . "\\possessivecite{%l}") | |
| 189 | (?e . "\\citeaffixed{%l}{?}") | |
| 190 | (?y . "\\citeyear{%l}") | |
| 191 | (?a . "\\citename{%l}"))) | |
| 192 | (chicago "The Chicago package" | |
| f3c18bd0 CD |
193 | ((?\C-m . "\\cite[]{%l}") |
| 194 | (?t . "\\citeN[]{%l}") | |
| 1a9461d0 | 195 | (?T . "\\shortciteN{%l}") |
| f3c18bd0 | 196 | (?p . "\\cite[]{%l}") |
| 1a9461d0 CD |
197 | (?P . "\\shortcite{%l}") |
| 198 | (?a . "\\citeA{%l}") | |
| 199 | (?A . "\\shortciteA{%l}") | |
| 200 | (?y . "\\citeyear{%l}"))) | |
| 201 | (astron "The Astron package" | |
| f3c18bd0 CD |
202 | ((?\C-m . "\\cite[]{%l}") |
| 203 | (?p . "\\cite[]{%l}" ) | |
| 1a9461d0 CD |
204 | (?t . "%2a (\\cite{%l})"))) |
| 205 | (author-year "Do-it-yourself Author-year" | |
| 206 | ((?\C-m . "\\cite{%l}") | |
| 207 | (?t . "%2a (%y)\\nocite{%l}") | |
| 208 | (?p . "(%2a %y\\nocite{%l})"))) | |
| 209 | (locally "Full info in parenthesis" | |
| 210 | "(%2a %y, %j %v, %P, %e: %b, %u, %s %<)") | |
| 4f595e15 RA |
211 | (context |
| 212 | "ConTeXt bib module" | |
| 213 | ((?\C-m . "\\cite[%l]") | |
| 214 | (?s . "\\cite[][%l]") | |
| 215 | (?n . "\\nocite[%l]"))) | |
| 1a9461d0 CD |
216 | ) |
| 217 | "Builtin versions of the citation format. | |
| 218 | The following conventions are valid for all alist entries: | |
| 219 | `?\C-m' should always point to a straight \\cite{%l} macro. | |
| 220 | `?t' should point to a textual citation (citation as a noun). | |
| 221 | `?p' should point to a parenthetical citation.") | |
| 222 | ||
| c8de140b | 223 | (defconst reftex-index-macros-builtin |
| 1a9461d0 | 224 | '((default "Default \\index and \\glossary macros" |
| 7c4d13cc CD |
225 | (("\\index{*}" "idx" ?i "" nil t) |
| 226 | ("\\glossary{*}" "glo" ?g "" nil t))) | |
| 1a9461d0 | 227 | (multind "The multind.sty package" |
| 7c4d13cc | 228 | (("\\index{}{*}" 1 ?i "" nil t))) |
| 1a9461d0 | 229 | (index "The index.sty package" |
| 3666daf6 CD |
230 | (("\\index[]{*}" 1 ?i "" nil t) |
| 231 | ("\\index*[]{*}" 1 ?I "" nil nil))) | |
| 1a9461d0 | 232 | (Index-Shortcut "index.sty with \\shortindexingon" |
| 7c4d13cc | 233 | (("\\index[]{*}" 1 ?i "" nil t) |
| 3666daf6 | 234 | ("\\index*[]{*}" 1 ?I "" nil nil) |
| c8de140b | 235 | ("^[]{*}" 1 ?^ "" texmathp t) |
| 3666daf6 | 236 | ("_[]{*}" 1 ?_ "" texmathp nil)))) |
| c8de140b | 237 | "Builtin stuff for `reftex-index-macros'. |
| 1a9461d0 CD |
238 | Lower-case symbols correspond to a style file of the same name in the LaTeX |
| 239 | distribution. Mixed-case symbols are convenience aliases.") | |
| 240 | ) | |
| 241 | ||
| 242 | ;; Configuration Variables and User Options for RefTeX ------------------ | |
| 243 | ||
| 244 | (defgroup reftex nil | |
| 245 | "LaTeX label and citation support." | |
| 246 | :tag "RefTeX" | |
| c8de140b | 247 | :link '(url-link :tag "Home Page" |
| 4f595e15 | 248 | "http://www.gnu.org/software/auctex/reftex.html") |
| 1a9461d0 CD |
249 | :link '(emacs-commentary-link :tag "Commentary in reftex.el" "reftex.el") |
| 250 | :link '(custom-manual "(reftex)Top") | |
| 251 | :prefix "reftex-" | |
| 252 | :group 'tex) | |
| 253 | ||
| 6fbeb429 | 254 | |
| 1a9461d0 CD |
255 | ;; Table of contents configuration -------------------------------------- |
| 256 | ||
| 257 | (defgroup reftex-table-of-contents-browser nil | |
| 258 | "A multifile table of contents browser." | |
| 259 | :group 'reftex) | |
| 260 | ||
| 6fbeb429 CD |
261 | (defcustom reftex-include-file-commands '("include" "input") |
| 262 | "LaTeX commands which input another file. | |
| 263 | The file name is expected after the command, either in braces or separated | |
| 264 | by whitespace." | |
| 265 | :group 'reftex-table-of-contents-browser | |
| 266 | :type '(repeat string)) | |
| 267 | ||
| 268 | (defcustom reftex-max-section-depth 12 | |
| 269 | "Maximum depth of section levels in document structure. | |
| 4f595e15 RA |
270 | The default in standard LaTeX is 7, but there are packages for |
| 271 | which this needs to be larger." | |
| 6fbeb429 CD |
272 | :group 'reftex-table-of-contents-browser |
| 273 | :type 'integer) | |
| 274 | ||
| 275 | ;; LaTeX section commands and level numbers | |
| 276 | (defcustom reftex-section-levels | |
| 277 | '( | |
| 278 | ("part" . 0) | |
| 279 | ("chapter" . 1) | |
| 280 | ("section" . 2) | |
| 281 | ("subsection" . 3) | |
| 282 | ("subsubsection" . 4) | |
| 283 | ("paragraph" . 5) | |
| 284 | ("subparagraph" . 6) | |
| 6fbeb429 CD |
285 | ("addchap" . -1) ; KOMA-Script |
| 286 | ("addsec" . -2) ; KOMA-Script | |
| 287 | ;;; ("minisec" . -7) ; KOMA-Script | |
| 288 | ) | |
| 289 | "Commands and levels used for defining sections in the document. | |
| 290 | This is an alist with each element like (COMMAND-NAME . LEVEL). | |
| 291 | The car of each cons cell is the name of the section macro (without | |
| 292 | the backslash). The cdr is a number indicating its level. A negative | |
| 293 | level means the same level as the positive value, but the section will | |
| 294 | never get a number. The cdr may also be a function which will be called | |
| 3666daf6 | 295 | to after the section-re matched to determine the level. |
| c8de140b | 296 | This list is also used for promotion and demotion of sectioning commands. |
| 3666daf6 CD |
297 | If you are using a document class which has several sets of sectioning |
| 298 | commands, promotion only works correctly if this list is sorted first | |
| 299 | by set, then within each set by level. The promotion commands always | |
| 300 | select the nearest entry with the correct new level." | |
| 6fbeb429 CD |
301 | :group 'reftex-table-of-contents-browser |
| 302 | :set 'reftex-set-dirty | |
| 303 | :type '(repeat | |
| 304 | (cons (string :tag "sectioning macro" "") | |
| 3666daf6 CD |
305 | (choice |
| 306 | (number :tag "level " 0) | |
| 307 | (symbol :tag "function " my-level-func))))) | |
| 6fbeb429 | 308 | |
| 7c4d13cc | 309 | (defcustom reftex-toc-max-level 100 |
| fb7ada5f | 310 | "The maximum level of toc entries which will be included in the TOC. |
| 7c4d13cc CD |
311 | Section headings with a bigger level will be ignored. In RefTeX, chapters |
| 312 | are level 1, sections are level 2 etc. | |
| 313 | This variable can be changed from within the *toc* buffer with the `t' key." | |
| 314 | :group 'reftex-table-of-contents-browser | |
| 315 | :type 'integer) | |
| 316 | ||
| 3b919c9f | 317 | (defcustom reftex-part-resets-chapter nil |
| fb7ada5f | 318 | "Non-nil means, \\part is like any other sectioning command. |
| 3b919c9f CD |
319 | This means, part numbers will be included in the numbering of chapters, and |
| 320 | chapter counters will be reset for each part. | |
| 321 | When nil (the default), parts are special, do not reset the chapter counter | |
| 322 | and also do not show up in chapter numbers." | |
| 323 | :group 'reftex-table-of-contents-browser | |
| 324 | :type 'boolean) | |
| 325 | ||
| 326 | ||
| 3666daf6 | 327 | (defcustom reftex-auto-recenter-toc 'frame |
| fb7ada5f | 328 | "Non-nil means, turn automatic recentering of *TOC* window on. |
| 3666daf6 | 329 | When active, the *TOC* window will always show the section you |
| 3b919c9f CD |
330 | are currently working in. Recentering happens whenever Emacs is idle for |
| 331 | more than `reftex-idle-time' seconds. | |
| 3b919c9f | 332 | |
| 3666daf6 | 333 | Value t means, turn on immediately when RefTeX gets started. Then, |
| c8de140b | 334 | recentering will work for any TOC window created during the session. |
| 3666daf6 CD |
335 | |
| 336 | Value 'frame (the default) means, turn automatic recentering on only while the | |
| 337 | dedicated TOC frame does exist, and do the recentering only in that frame. So | |
| 4f595e15 | 338 | when creating that frame (with `d' key in an ordinary TOC window), the |
| 3666daf6 CD |
339 | automatic recentering is turned on. When the frame gets destroyed, automatic |
| 340 | recentering is turned off again. | |
| 341 | ||
| c8de140b | 342 | This feature can be turned on and off from the menu |
| 3666daf6 CD |
343 | \(Ref->Options)." |
| 344 | :group 'reftex-table-of-contents-browser | |
| 345 | :type '(choice | |
| 346 | (const :tag "never" nil) | |
| 347 | (const :tag "always" t) | |
| 23fed453 | 348 | (const :tag "in dedicated frame only" frame))) |
| c8de140b | 349 | |
| 6fbeb429 | 350 | (defcustom reftex-toc-split-windows-horizontally nil |
| fb7ada5f | 351 | "Non-nil means, create TOC window by splitting window horizontally." |
| 6fbeb429 CD |
352 | :group 'reftex-table-of-contents-browser |
| 353 | :type 'boolean) | |
| 354 | ||
| 3666daf6 | 355 | (defcustom reftex-toc-split-windows-fraction .3 |
| fb7ada5f | 356 | "Fraction of the width or height of the frame to be used for TOC window. |
| 3666daf6 | 357 | See also `reftex-toc-split-windows-horizontally'." |
| 6fbeb429 CD |
358 | :group 'reftex-table-of-contents-browser |
| 359 | :type 'number) | |
| 360 | ||
| 3666daf6 CD |
361 | (defvar reftex-toc-split-windows-horizontally-fraction 0.5 |
| 362 | "This variable is obsolete, use `reftex-toc-split-windows-fraction' instead.") | |
| 363 | ||
| 1a9461d0 | 364 | (defcustom reftex-toc-keep-other-windows t |
| fb7ada5f | 365 | "Non-nil means, split the selected window to display the *toc* buffer. |
| 1a9461d0 CD |
366 | This helps to keep the window configuration, but makes the *toc* small. |
| 367 | When nil, all other windows except the selected one will be deleted, so | |
| 368 | that the *toc* window fills half the frame." | |
| 369 | :group 'reftex-table-of-contents-browser | |
| 370 | :type 'boolean) | |
| 371 | ||
| 372 | (defcustom reftex-toc-include-file-boundaries nil | |
| fb7ada5f | 373 | "Non-nil means, include file boundaries in *toc* buffer. |
| 1a9461d0 CD |
374 | This flag can be toggled from within the *toc* buffer with the `F' key." |
| 375 | :group 'reftex-table-of-contents-browser | |
| 376 | :type 'boolean) | |
| 377 | ||
| 378 | (defcustom reftex-toc-include-labels nil | |
| fb7ada5f | 379 | "Non-nil means, include labels in *toc* buffer. |
| 1a9461d0 CD |
380 | This flag can be toggled from within the *toc* buffer with the `l' key." |
| 381 | :group 'reftex-table-of-contents-browser | |
| 382 | :type 'boolean) | |
| 383 | ||
| 384 | (defcustom reftex-toc-include-index-entries nil | |
| fb7ada5f | 385 | "Non-nil means, include index entries in *toc* buffer. |
| 1a9461d0 CD |
386 | This flag can be toggled from within the *toc* buffer with the `i' key." |
| 387 | :group 'reftex-table-of-contents-browser | |
| 388 | :type 'boolean) | |
| 389 | ||
| 3666daf6 | 390 | (defcustom reftex-toc-confirm-promotion 2 |
| fb7ada5f | 391 | "Non-nil means, promotion/demotion commands first prompt for confirmation. |
| 4f595e15 RA |
392 | If nil, the command is executed immediately. If this is an integer N, |
| 393 | ask for confirmation only if N or more section commands are going to be | |
| 3666daf6 CD |
394 | changed." |
| 395 | :group 'reftex-table-of-contents-browser | |
| 396 | :type '(choice | |
| 397 | (const :tag "Never" nil) | |
| 398 | (const :tag "Always" t) | |
| 399 | (number :tag "When more than N sections" :value 2))) | |
| 400 | ||
| 1a9461d0 | 401 | (defcustom reftex-toc-include-context nil |
| fb7ada5f | 402 | "Non-nil means, include context with labels in the *toc* buffer. |
| 1a9461d0 CD |
403 | Context will only be shown when labels are visible as well. |
| 404 | This flag can be toggled from within the *toc* buffer with the `c' key." | |
| 405 | :group 'reftex-table-of-contents-browser | |
| 406 | :type 'boolean) | |
| 407 | ||
| 408 | (defcustom reftex-toc-follow-mode nil | |
| fb7ada5f | 409 | "Non-nil means, point in *toc* buffer will cause other window to follow. |
| 1a9461d0 CD |
410 | The other window will show the corresponding part of the document. |
| 411 | This flag can be toggled from within the *toc* buffer with the `f' key." | |
| 412 | :group 'reftex-table-of-contents-browser | |
| 413 | :type 'boolean) | |
| 414 | ||
| 415 | (defcustom reftex-revisit-to-follow nil | |
| fb7ada5f | 416 | "Non-nil means, follow-mode will revisit files if necessary. |
| 4f595e15 | 417 | If nil, follow-mode will be suspended for stuff in unvisited files." |
| 1a9461d0 CD |
418 | :group 'reftex-table-of-contents-browser |
| 419 | :group 'reftex-referencing-labels | |
| 420 | :type 'boolean) | |
| 421 | ||
| 422 | (defcustom reftex-toc-mode-hook nil | |
| c8de140b | 423 | "Mode hook for `reftex-toc-mode'." |
| 1a9461d0 CD |
424 | :group 'reftex-table-of-contents-browser |
| 425 | :type 'hook) | |
| 426 | ||
| 427 | ;; Label Support Configuration | |
| 428 | ||
| 429 | (defgroup reftex-label-support nil | |
| 430 | "Support for creation, insertion and referencing of labels in LaTeX." | |
| 431 | :group 'reftex) | |
| 432 | ||
| 433 | (defgroup reftex-defining-label-environments nil | |
| 434 | "Definition of environments and macros to do with label." | |
| 435 | :group 'reftex-label-support) | |
| 436 | ||
| 437 | (defcustom reftex-default-label-alist-entries | |
| 438 | '(amsmath endnotes fancybox floatfig longtable picinpar | |
| cfcc9cc8 TH |
439 | rotating sidecap subfigure supertab wrapfig |
| 440 | listings minted ctable LaTeX) | |
| 1a9461d0 | 441 | "Default label alist specifications. LaTeX should always be the last entry. |
| c8de140b | 442 | The value of this variable is a list of symbols with associations in the |
| 1a9461d0 CD |
443 | constant `reftex-label-alist-builtin'. Check that constant for a full list |
| 444 | of options." | |
| 445 | :group 'reftex-defining-label-environments | |
| 446 | :set 'reftex-set-dirty | |
| 447 | :type `(set | |
| 3666daf6 | 448 | :indent 4 |
| 1a9461d0 CD |
449 | :inline t |
| 450 | :greedy t | |
| 451 | ,@(mapcar | |
| 3666daf6 CD |
452 | (lambda (x) |
| 453 | (list 'const :tag (concat (symbol-name (nth 0 x)) | |
| 454 | ": " (nth 1 x)) | |
| 455 | (nth 0 x))) | |
| 1a9461d0 CD |
456 | reftex-label-alist-builtin))) |
| 457 | ||
| 458 | (defcustom reftex-label-alist nil | |
| 459 | "Alist with information on environments for \\label-\\ref use. | |
| 460 | ||
| 4f595e15 RA |
461 | This doc string is easier to understand after reading the configuration |
| 462 | examples in the manual. Looking at the builtin defaults in the constant | |
| 1a9461d0 CD |
463 | `reftex-label-alist-builtin' may also be instructive. |
| 464 | ||
| 465 | Set this variable to define additions and changes to the default. The only | |
| 466 | things you MUST NOT change is that `?s' is the type indicator for section | |
| 467 | labels, and SPC for the `any' label type. These are hard-coded at other | |
| 468 | places in the code. | |
| 469 | ||
| 470 | The value of the variable must be a list of items. Each item is a list | |
| 471 | itself and has the following structure: | |
| 472 | ||
| 473 | (ENV-OR-MACRO TYPE-KEY LABEL-PREFIX REFERENCE-FORMAT CONTEXT-METHOD | |
| 7c4d13cc | 474 | (MAGIC-WORD ... ) TOC-LEVEL) |
| 1a9461d0 CD |
475 | |
| 476 | Each list entry describes either an environment carrying a counter for use | |
| 477 | with \\label and \\ref, or a LaTeX macro defining a label as (or inside) | |
| 478 | one of its arguments. The elements of each list entry are: | |
| 479 | ||
| 480 | ENV-OR-MACRO | |
| 481 | Name of the environment (like \"table\") or macro (like \"\\\\myfig\"). | |
| 482 | For macros, indicate the macro arguments for best results, as in | |
| 483 | \"\\\\myfig[]{}{}{*}{}\". Use square brackets for optional arguments, | |
| 484 | a star to mark the label argument, if any. The macro does not have to | |
| 485 | have a label argument - you could also use \\label{..} inside one of | |
| 486 | its arguments. | |
| 487 | Special names: `section' for section labels, `any' to define a group | |
| 488 | which contains all labels. | |
| 489 | ||
| 4f595e15 RA |
490 | This may also be a function to do local parsing and identify point to |
| 491 | be in a non-standard label environment. The function must take an | |
| 492 | argument BOUND and limit backward searches to this value. It should | |
| 493 | return either nil or the position where the special environment starts. | |
| 494 | See the Info documentation for an example. | |
| 1a9461d0 CD |
495 | |
| 496 | Finally this may also be nil if the entry is only meant to change | |
| 497 | some settings associated with the type indicator character (see below). | |
| 498 | ||
| 499 | TYPE-KEY | |
| 500 | Type indicator character, like `?t', must be a printable ASCII character. | |
| 501 | The type indicator is a single character which defines a label type. | |
| 502 | Any label inside the environment or macro is assumed to belong to this | |
| 503 | type. The same character may occur several times in this list, to cover | |
| 504 | cases in which different environments carry the same label type (like | |
| 505 | `equation' and `eqnarray'). | |
| 506 | If the type indicator is nil and the macro has a label argument {*}, | |
| 70d797cd | 507 | the macro defines neutral labels just like \\label. In this case |
| 4f595e15 | 508 | the remainder of this entry is ignored. |
| 1a9461d0 CD |
509 | |
| 510 | LABEL-PREFIX | |
| 511 | Label prefix string, like \"tab:\". | |
| 512 | The prefix is a short string used as the start of a label. It may be the | |
| 513 | empty string. The prefix may contain the following `%' escapes: | |
| 514 | %f Current file name with directory and extension stripped. | |
| 515 | %F Current file name relative to directory of master file. | |
| f3c18bd0 CD |
516 | %m Master file name, directory and extension stripped. |
| 517 | %M Directory name (without path) where master file is located. | |
| 1a9461d0 CD |
518 | %u User login name, on systems which support this. |
| 519 | %S A section prefix derived with variable `reftex-section-prefixes'. | |
| 520 | ||
| 521 | Example: In a file `intro.tex', \"eq:%f:\" will become \"eq:intro:\"). | |
| 522 | ||
| 523 | REFERENCE-FORMAT | |
| 4f595e15 RA |
524 | Format string for reference insertion in buffer. `%s' will be replaced |
| 525 | by the label. | |
| 1a9461d0 CD |
526 | When the format starts with `~', the `~' will only be inserted if |
| 527 | there is not already a whitespace before point. | |
| 528 | ||
| 529 | CONTEXT-METHOD | |
| 530 | Indication on how to find the short context. | |
| 531 | - If nil, use the text following the \\label{...} macro. | |
| 532 | - If t, use | |
| 533 | - the section heading for section labels. | |
| 534 | - text following the \\begin{...} statement of environments. | |
| 535 | (not a good choice for environments like eqnarray or enumerate, | |
| 536 | where one has several labels in a single environment). | |
| 537 | - text after the macro name (starting with the first arg) for macros. | |
| 538 | - If an integer, use the nth argument of the macro. As a special case, | |
| 539 | 1000 means to get text after the last macro argument. | |
| 540 | - If a string, use as regexp to search *backward* from the label. Context | |
| 4f595e15 | 541 | is then the text following the end of the match. E.g. setting this to |
| 1a9461d0 CD |
542 | \"\\\\\\\\caption[[{]\" will use the caption in a figure or table |
| 543 | environment. | |
| 544 | \"\\\\\\\\begin{eqnarray}\\\\|\\\\\\\\\\\\\\\\\" works for eqnarrays. | |
| 545 | - If any of `caption', `item', `eqnarray-like', `alignat-like', this | |
| 546 | symbol will internally be translated into an appropriate regexp | |
| 547 | (see also the variable `reftex-default-context-regexps'). | |
| 548 | - If a function, call this function with the name of the environment/macro | |
| 549 | as argument. On call, point will be just after the \\label macro. The | |
| 550 | function is expected to return a suitable context string. It should | |
| 551 | throw an exception (error) when failing to find context. | |
| 552 | As an example, here is a function returning the 10 chars following | |
| 553 | the label macro as context: | |
| 554 | ||
| 555 | (defun my-context-function (env-or-mac) | |
| 556 | (if (> (point-max) (+ 10 (point))) | |
| 557 | (buffer-substring (point) (+ 10 (point))) | |
| 558 | (error \"Buffer too small\"))) | |
| 559 | ||
| 560 | Label context is used in two ways by RefTeX: For display in the label | |
| 561 | menu, and to derive a label string. If you want to use a different | |
| 562 | method for each of these, specify them as a dotted pair. | |
| 563 | E.g. `(nil . t)' uses the text after the label (nil) for display, and | |
| 564 | text from the default position (t) to derive a label string. This is | |
| 565 | actually used for section labels. | |
| 566 | ||
| 567 | MAGIC-WORDS | |
| 568 | List of magic words which identify a reference to be of this type. | |
| 569 | If the word before point is equal to one of these words when calling | |
| 570 | `reftex-reference', the label list offered will be automatically | |
| 571 | restricted to labels of the correct type. | |
| 572 | If the first element of this wordlist is the symbol `regexp', the | |
| 573 | strings are interpreted as regular expressions. RefTeX will add | |
| 574 | a \"\\\\W\" to the beginning and other stuff to the end of the regexp. | |
| 575 | ||
| 7c4d13cc CD |
576 | TOC-LEVEL |
| 577 | The integer level at which this environment should be added to the | |
| 578 | table of contents. See also `reftex-section-levels'. A positive | |
| 579 | value will number the entries mixed with the sectioning commands of | |
| 580 | the same level. A negative value will make unnumbered entries. | |
| 581 | Useful only for theorem-like environments, will be ignored for macros. | |
| 582 | When omitted or nil, no TOC entries will be made. | |
| 583 | ||
| 1a9461d0 CD |
584 | If the type indicator characters of two or more entries are the same, RefTeX |
| 585 | will use | |
| 586 | - the first non-nil format and prefix | |
| 587 | - the magic words of all involved entries. | |
| 588 | ||
| 589 | Any list entry may also be a symbol. If that has an association in | |
| 590 | `reftex-label-alist-builtin', the cddr of that association is spliced into the | |
| 591 | list. However, builtin defaults should normally be set with the variable | |
| 983741d8 | 592 | `reftex-default-label-alist-entries'." |
| 1a9461d0 CD |
593 | :group 'reftex-defining-label-environments |
| 594 | :set 'reftex-set-dirty | |
| 595 | :type | |
| 596 | `(repeat | |
| 597 | (choice :tag "Package or Detailed " | |
| 598 | :value ("" ?a nil nil nil nil) | |
| 599 | (list :tag "Detailed Entry" | |
| 600 | :value ("" ?a nil nil nil nil) | |
| 601 | (choice :tag "Environment or \\macro " | |
| 602 | (const :tag "Ignore, just use typekey" nil) | |
| 603 | (string "") | |
| 3666daf6 CD |
604 | (symbol :tag "Special parser" my-parser)) |
| 605 | (choice :tag "Type specification " | |
| 606 | (const :tag "unspecified, like in \\label" nil) | |
| 607 | (character :tag "Char " ?a)) | |
| 1a9461d0 CD |
608 | (choice :tag "Label prefix string " |
| 609 | (const :tag "Default" nil) | |
| 610 | (string :tag "String" "lab:")) | |
| 611 | (choice :tag "Label reference format" | |
| 612 | (const :tag "Default" nil) | |
| 613 | (string :tag "String" "~\\ref{%s}")) | |
| 614 | (choice :tag "Context method " | |
| 3666daf6 CD |
615 | (const :tag "Default position" t) |
| 616 | (const :tag "After label" nil) | |
| 617 | (number :tag "Macro arg nr" 1) | |
| 618 | (regexp :tag "Regexp" "") | |
| 619 | (const :tag "Caption in float" caption) | |
| 620 | (const :tag "Item in list" item) | |
| 621 | (const :tag "Eqnarray-like" eqnarray-like) | |
| 622 | (const :tag "Alignat-like" alignat-like) | |
| 623 | (symbol :tag "Function" my-func)) | |
| 624 | (repeat :tag "Magic words" :extra-offset 2 (string)) | |
| 625 | (option (choice :tag "Make TOC entry " | |
| 626 | (const :tag "No entry" nil) | |
| 627 | (integer :tag "Level" :value -3)))) | |
| 1a9461d0 CD |
628 | (choice |
| 629 | :tag "Package" | |
| 630 | :value AMSTeX | |
| 631 | ,@(mapcar | |
| 3666daf6 CD |
632 | (lambda (x) |
| 633 | (list 'const :tag (concat (symbol-name (nth 0 x))) | |
| 634 | (nth 0 x))) | |
| 635 | reftex-label-alist-builtin))))) | |
| 1a9461d0 | 636 | |
| 1a9461d0 CD |
637 | (defcustom reftex-section-prefixes '((0 . "part:") (1 . "cha:") (t . "sec:")) |
| 638 | "Prefixes for section labels. | |
| 639 | When the label prefix given in an entry in `reftex-label-alist' contains `%S', | |
| c8de140b | 640 | this list is used to determine the correct prefix string depending on the |
| 1a9461d0 CD |
641 | current section level. |
| 642 | The list is an alist, with each entry of the form (KEY . PREFIX) | |
| 643 | Possible keys are sectioning macro names like `chapter', section levels | |
| 3666daf6 | 644 | \(as given in `reftex-section-levels'), and t for the default." |
| 1a9461d0 CD |
645 | :group 'reftex-defining-label-environments |
| 646 | :type '(repeat | |
| 3666daf6 CD |
647 | (cons :value (0 . "") |
| 648 | (choice | |
| 649 | (string :tag "macro name") | |
| 650 | (integer :tag "section level") | |
| 651 | (const :tag "default" t)) | |
| 652 | (string :tag "Prefix")))) | |
| 1a9461d0 CD |
653 | |
| 654 | (defcustom reftex-default-context-regexps | |
| 655 | '((caption . "\\\\\\(rot\\)?caption\\*?[[{]") | |
| 656 | (item . "\\\\item\\(\\[[^]]*\\]\\)?") | |
| 657 | (eqnarray-like . "\\\\begin{%s}\\|\\\\\\\\") | |
| 658 | (alignat-like . "\\\\begin{%s}{[0-9]*}\\|\\\\\\\\")) | |
| 659 | "Alist with default regular expressions for finding context. | |
| 660 | The form (format regexp (regexp-quote environment)) is used to calculate | |
| 661 | the final regular expression - so %s will be replaced with the environment | |
| 662 | or macro." | |
| 663 | :group 'reftex-defining-label-environments | |
| 664 | :type '(repeat (cons (symbol) (regexp)))) | |
| f3c18bd0 CD |
665 | |
| 666 | (defcustom reftex-trust-label-prefix nil | |
| 667 | "Non-nil means, trust the label prefix when determining label type. | |
| 668 | It is customary to use special label prefixes to distinguish different label | |
| 669 | types. The label prefixes have no syntactic meaning in LaTeX (unless | |
| 3a1e8128 | 670 | special packages like fancyref are being used). RefTeX can and by |
| f3c18bd0 CD |
671 | default does parse around each label to detect the correct label type, |
| 672 | but this process can be slow when a document contains thousands of | |
| 673 | labels. If you use label prefixes consistently, you may speed up | |
| 674 | document parsing by setting this variable to a non-nil value. RefTeX | |
| 675 | will then compare the label prefix with the prefixes found in | |
| 676 | `reftex-label-alist' and derive the correct label type in this way. | |
| 677 | Possible values for this option are: | |
| 678 | ||
| 679 | t This means to trust any label prefixes found. | |
| 680 | regexp If a regexp, only prefixes matched by the regexp are trusted. | |
| 681 | list List of accepted prefixes, as strings. The colon is part of | |
| 682 | the prefix, e.g. (\"fn:\" \"eqn:\" \"item:\"). | |
| 683 | nil Never trust a label prefix. | |
| 684 | ||
| 685 | The only disadvantage of using this feature is that the label context | |
| 686 | displayed in the label selection buffer along with each label is | |
| 687 | simply some text after the label definition. This is no problem if you | |
| 688 | place labels keeping this in mind (e.g. *before* the equation, *at | |
| 689 | the beginning* of a fig/tab caption ...). Anyway, it is probably best | |
| 690 | to use the regexp or the list value types to fine-tune this feature. | |
| 691 | For example, if your document contains thousands of footnotes with | |
| 692 | labels fn:xxx, you may want to set this variable to the value \"^fn:$\" or | |
| 693 | \(\"fn:\"). Then RefTeX will still do extensive parsing for any | |
| 694 | non-footnote labels." | |
| 695 | :group 'reftex-defining-label-environments | |
| 696 | :type '(choice | |
| 697 | (const :tag "Always" t) | |
| 698 | (const :tag "Never" nil) | |
| 699 | (regexp) | |
| 700 | (repeat :tag "List" | |
| 701 | (string :tag "prefix (with colon)")))) | |
| c8de140b | 702 | |
| 1a9461d0 CD |
703 | (defcustom reftex-special-environment-functions nil |
| 704 | "List of functions to be called when trying to figure out current environment. | |
| 705 | These are special functions to detect \"environments\" which do not | |
| 706 | start with \\begin and end with \\end. Some LaTeX packages seem to | |
| 707 | use such non-standard ways to set up environment-like constructs. The | |
| 708 | purpose of each function in this list is to detect if point is | |
| 709 | currently inside such a special \"environment\". If the environment | |
| 710 | carries a label, you must also set up an entry for it in | |
| 711 | `reftex-label-alist'. | |
| 712 | ||
| 713 | The function should check if point is currently in the special | |
| 714 | environment it was written to detect. If so, the function must return | |
| 715 | a cons cell (NAME . POSITION). NAME is the name of the environment | |
| 716 | detected and POSITION is the buffer position where the environment | |
| 717 | starts. The function must return nil on failure to detect the | |
| 718 | environment. | |
| 719 | ||
| 720 | The function must take an argument BOUND. If non-nil, BOUND is a | |
| 721 | boundary for backwards searches which should be observed. | |
| 722 | ||
| 723 | Here is an example. The LaTeX package linguex.sty defines list macros | |
| 724 | `\\ex.', `\\a.', etc for lists which are terminated by `\\z.' or an empty | |
| 725 | line. | |
| 726 | ||
| 727 | \\ex. \\label{ex:12} Some text in an exotic language ... | |
| 728 | \\a. \\label{ex:13} more stuff | |
| 729 | \\b. \\label{ex:14} still more stuff | |
| 730 | ||
| 731 | ... more text after the empty line terminating all lists | |
| 732 | ||
| 733 | And here is the setup for RefTeX: | |
| 734 | ||
| 735 | 1. Define a dummy environment for this in `reftex-label-alist'. Dummy means, | |
| 736 | make up an environment name even though it is not used with \\begin and | |
| 737 | \\end. Here we use \"linguex\" as this name. | |
| 738 | ||
| 739 | (setq reftex-label-alist | |
| 740 | '((\"linguex\" ?x \"ex:\" \"~\\\\ref{%s}\" nil (\"Example\" \"Ex.\")))) | |
| 741 | ||
| 742 | 2. Write a function to detect the list macros and the determinators as well. | |
| 743 | ||
| 744 | (defun my-detect-linguex-list (bound) | |
| 745 | (let ((pos (point)) p1) | |
| 746 | (save-excursion | |
| 747 | ;; Search for any of the linguex item macros at the beginning of a line | |
| c8de140b | 748 | (if (re-search-backward |
| 1a9461d0 CD |
749 | \"^[ \\t]*\\\\(\\\\\\\\\\\\(ex\\\\|a\\\\|b\\\\|c\\\\|d\\\\|e\\\\|f\\\\)g?\\\\.\\\\)\" bound t) |
| 750 | (progn | |
| 751 | (setq p1 (match-beginning 1)) | |
| 752 | ;; Make sure no empty line or \\z. is between us and the item macro | |
| 753 | (if (re-search-forward \"\\n[ \\t]*\\n\\\\|\\\\\\\\z\\\\.\" pos t) | |
| 754 | ;; Return nil because list was already closed | |
| 755 | nil | |
| 756 | ;; OK, we got it | |
| 757 | (cons \"linguex\" p1))) | |
| c8de140b | 758 | ;; Return nil for not found |
| 1a9461d0 CD |
759 | nil)))) |
| 760 | ||
| 761 | 3. Tell RefTeX to use this function | |
| 762 | ||
| 4f595e15 | 763 | (setq reftex-special-environment-functions '(my-detect-linguex-list))" |
| 1a9461d0 CD |
764 | :group 'reftex-defining-label-environments |
| 765 | :type 'hook) | |
| 766 | ||
| 767 | ;; Label insertion | |
| 768 | ||
| 769 | (defgroup reftex-making-and-inserting-labels nil | |
| 770 | "Options on how to create new labels." | |
| 771 | :group 'reftex-label-support) | |
| 772 | ||
| 773 | (defcustom reftex-insert-label-flags '("s" "sft") | |
| 774 | "Flags governing label insertion. First flag DERIVE, second flag PROMPT. | |
| 775 | ||
| 776 | If DERIVE is t, RefTeX will try to derive a sensible label from context. | |
| 777 | A section label for example will be derived from the section heading. | |
| f8b00e0f | 778 | The conversion of the context to a valid label is governed by the |
| 1a9461d0 CD |
779 | specifications given in `reftex-derive-label-parameters'. |
| 780 | If RefTeX fails to derive a label, it will prompt the user. | |
| 781 | If DERIVE is nil, the label generated will consist of the prefix and a | |
| 782 | unique number, like `eq:23'. | |
| 783 | ||
| 784 | If PROMPT is t, the user will be prompted for a label string. The prompt will | |
| 785 | already contain the prefix, and (if DERIVE is t) a default label derived from | |
| 786 | context. When PROMPT is nil, the default label will be inserted without | |
| 787 | query. | |
| 788 | ||
| 789 | So the combination of DERIVE and PROMPT controls label insertion. Here is a | |
| 790 | table describing all four possibilities: | |
| 791 | ||
| 792 | DERIVE PROMPT ACTION | |
| 793 | ------------------------------------------------------------------------- | |
| 794 | nil nil Insert simple label, like eq:22 or sec:13. No query. | |
| 795 | nil t Prompt for label. | |
| 796 | t nil Derive a label from context and insert without query. | |
| 797 | t t Derive a label from context and prompt for confirmation. | |
| 798 | ||
| 799 | Each flag may be set to t, nil, or a string of label type letters | |
| 800 | indicating the label types for which it should be true. The strings work | |
| 801 | like character classes. | |
| 802 | Thus, the combination may be set differently for each label type. The | |
| 803 | default settings \"s\" and \"sft\" mean: Derive section labels from headings | |
| 3666daf6 | 804 | \(with confirmation). Prompt for figure and table labels. Use simple labels |
| 1a9461d0 CD |
805 | without confirmation for everything else. |
| 806 | The available label types are: s (section), f (figure), t (table), i (item), | |
| 807 | e (equation), n (footnote), N (endnote), plus any definitions in | |
| 808 | `reftex-label-alist'." | |
| 809 | :group 'reftex-making-and-inserting-labels | |
| 810 | :type '(list (choice :tag "Derive label from context" | |
| 811 | (const :tag "always" t) | |
| 812 | (const :tag "never" nil) | |
| 813 | (string :tag "selected label types" "")) | |
| 814 | (choice :tag "Prompt for label string " | |
| 815 | :entry-format " %b %v" | |
| 816 | (const :tag "always" t) | |
| 817 | (const :tag "never" nil) | |
| 818 | (string :tag "selected label types" "")))) | |
| 819 | ||
| 820 | (defcustom reftex-string-to-label-function 'reftex-string-to-label | |
| f8b00e0f | 821 | "Function to turn an arbitrary string into a valid label. |
| 1a9461d0 CD |
822 | RefTeX's default function uses the variable `reftex-derive-label-parameters'." |
| 823 | :group 'reftex-making-and-inserting-labels | |
| 824 | :type 'symbol) | |
| 825 | ||
| 826 | (defcustom reftex-translate-to-ascii-function 'reftex-latin1-to-ascii | |
| 4f595e15 RA |
827 | "Filter function to convert a string to ASCII. |
| 828 | The function is used to process a context string before it is | |
| 829 | used to derive a label from it. The intended application is to | |
| 830 | convert ISO or Mule characters into something valid in labels. | |
| 831 | The default function removes the accents from Latin-1 characters. | |
| 832 | X-Symbol (>=2.6) sets this variable to the much more general | |
| 833 | `x-symbol-translate-to-ascii'." | |
| 1a9461d0 CD |
834 | :group 'reftex-making-and-inserting-labels |
| 835 | :type 'symbol) | |
| 836 | ||
| 837 | (defcustom reftex-derive-label-parameters '(3 20 t 1 "-" | |
| 838 | ("the" "on" "in" "off" "a" "for" "by" "of" "and" "is" "to") t) | |
| 839 | "Parameters for converting a string into a label. | |
| 840 | This variable is a list of the following items. | |
| 841 | ||
| 842 | NWORDS Number of words to use. | |
| 843 | MAXCHAR Maximum number of characters in a label string. | |
| 5181ff9f WL |
844 | INVALID nil: Throw away any words containing characters invalid in labels. |
| 845 | t: Throw away only the invalid characters, not the whole word. | |
| 1a9461d0 CD |
846 | ABBREV nil: Never abbreviate words. |
| 847 | t: Always abbreviate words (see `reftex-abbrev-parameters'). | |
| 848 | not t and not nil: Abbreviate words if necessary to shorten | |
| 849 | label string below MAXCHAR. | |
| 850 | SEPARATOR String separating different words in the label. | |
| 851 | IGNOREWORDS List of words which should not be part of labels. | |
| 852 | DOWNCASE t: Downcase words before using them." | |
| 853 | :group 'reftex-making-and-inserting-labels | |
| 854 | :type '(list (integer :tag "Number of words " 3) | |
| 855 | (integer :tag "Maximum label length " 20) | |
| 5181ff9f | 856 | (choice :tag "Invalid characters in words" |
| 1a9461d0 CD |
857 | (const :tag "throw away entire word" nil) |
| 858 | (const :tag "throw away single chars" t)) | |
| 859 | (choice :tag "Abbreviate words " | |
| 860 | (const :tag "never" nil) | |
| 861 | (const :tag "always" t) | |
| 862 | (const :tag "when label is too long" 1)) | |
| 863 | (string :tag "Separator between words " "-") | |
| 864 | (repeat :tag "Ignore words" | |
| 865 | :entry-format " %i %d %v" | |
| 866 | (string :tag "")) | |
| 3666daf6 | 867 | (option (boolean :tag "Downcase words ")))) |
| 1a9461d0 | 868 | |
| 4d9a0979 TH |
869 | (defcustom reftex-label-regexps |
| 870 | '(;; Normal \\label{foo} labels | |
| 871 | "\\\\label{\\(?1:[^}]*\\)}" | |
| 872 | ;; keyvals [..., label = {foo}, ...] forms used by ctable, | |
| 873 | ;; listings, minted, ... | |
| 874 | "\\[[^]]*\\<label[[:space:]]*=[[:space:]]*{?\\(?1:[^],}]+\\)}?") | |
| 875 | "List of regexps matching \\label definitions. | |
| 876 | The default value matches usual \\label{...} definitions and | |
| 877 | keyval style [..., label = {...}, ...] label definitions. It is | |
| 878 | assumed that the regexp group 1 matches the label text, so you | |
| 0aecf718 TH |
879 | have to define it using \\(?1:...\\) when adding new regexps. |
| 880 | ||
| 881 | When changed from Lisp, make sure to call | |
| 882 | `reftex-compile-variables' afterwards to make the change | |
| 883 | effective." | |
| bb098075 | 884 | :version "24.4" |
| 0aecf718 TH |
885 | :set (lambda (symbol value) |
| 886 | (set symbol value) | |
| 6eca2e74 TH |
887 | (when (fboundp 'reftex-compile-variables) |
| 888 | (reftex-compile-variables))) | |
| 4d9a0979 TH |
889 | :group 'reftex-defining-label-environments |
| 890 | :type '(repeat (regexp :tag "Regular Expression"))) | |
| 891 | ||
| d79d37bd TH |
892 | (defcustom reftex-label-ignored-macros-and-environments nil |
| 893 | "List of macros and environments to be ignored when searching for labels. | |
| 894 | The purpose is to ignore environments and macros that use keyval | |
| 895 | style label=foo arguments, but the label has a different meaning | |
| 896 | than a \\label{foo}. Standard \\label{...} definitions are never | |
| 897 | ignored. | |
| 898 | ||
| 899 | E.g., TikZ defines several macros/environments where [label=foo] | |
| 900 | defines the label to be printed at some node or edge, but it's | |
| 901 | not a label used for referencing. | |
| 902 | ||
| 903 | Note that this feature is only supported if you are using AUCTeX | |
| 904 | and the functions `TeX-current-macro' and | |
| 905 | `LaTeX-current-environment' are bound. Also note that this | |
| 906 | feature might slow down the reftex parsing process for large TeX | |
| 907 | files." | |
| 9fc02c2f | 908 | :version "24.4" |
| d79d37bd TH |
909 | :group 'reftex-defining-label-environments |
| 910 | :type '(repeat string)) | |
| 911 | ||
| 1a9461d0 | 912 | (defcustom reftex-label-illegal-re "[^-a-zA-Z0-9_+=:;,.]" |
| 5181ff9f | 913 | "Regexp matching characters not valid in labels." |
| 1a9461d0 CD |
914 | :group 'reftex-making-and-inserting-labels |
| 915 | :type '(regexp :tag "Regular Expression")) | |
| 916 | ||
| 917 | (defcustom reftex-abbrev-parameters '(4 2 "^aeiou" "aeiou") | |
| 918 | "Parameters for abbreviation of words. | |
| 919 | This variable is a list of the following items. | |
| 920 | ||
| 921 | MIN-CHARS Minimum number of characters remaining after abbreviation. | |
| 922 | MIN-KILL Minimum number of characters to remove when abbreviating words. | |
| 923 | BEFORE Character class before abbrev point in word. | |
| 924 | AFTER Character class after abbrev point in word." | |
| 925 | :group 'reftex-making-and-inserting-labels | |
| 926 | :type '(list | |
| 927 | (integer :tag "Minimum chars per word" 4) | |
| 928 | (integer :tag "Shorten by at least " 2) | |
| 929 | (string :tag "cut before char class " "^saeiou") | |
| 930 | (string :tag "cut after char class " "aeiou"))) | |
| 931 | ||
| 932 | (defcustom reftex-format-label-function nil | |
| 933 | "Function which produces the string to insert as a label definition. | |
| 934 | Normally should be nil, unless you want to do something fancy. | |
| 935 | The function will be called with two arguments, the LABEL and the DEFAULT | |
| 70d797cd | 936 | FORMAT, which usually is `\\label{%s}'. The function should return the |
| 1a9461d0 CD |
937 | string to insert into the buffer." |
| 938 | :group 'reftex-making-and-inserting-labels | |
| a931698a | 939 | :type '(choice (const nil) function)) |
| 1a9461d0 CD |
940 | |
| 941 | ;; Label referencing | |
| 942 | ||
| 943 | (defgroup reftex-referencing-labels nil | |
| 944 | "Options on how to reference labels." | |
| 945 | :group 'reftex-label-support) | |
| 946 | ||
| 947 | (eval-and-compile | |
| 948 | (defconst reftex-tmp | |
| 949 | '((const :tag "on" t) | |
| 950 | (const :tag "off" nil) | |
| 951 | (string :tag "Selected label types")))) | |
| 952 | ||
| 953 | (defcustom reftex-label-menu-flags '(t t nil nil nil nil t nil) | |
| 954 | "List of flags governing the label menu makeup. | |
| 955 | The flags are: | |
| 956 | ||
| 957 | TABLE-OF-CONTENTS Show the labels embedded in a table of context. | |
| 958 | SECTION-NUMBERS Include section numbers (like 4.1.3) in table of contents. | |
| 959 | COUNTERS Show counters. This just numbers the labels in the menu. | |
| 960 | NO-CONTEXT Non-nil means do NOT show the short context. | |
| 961 | FOLLOW Follow full context in other window. | |
| 962 | SHOW-COMMENTED Show labels from regions which are commented out. | |
| 963 | MATCH-IN-TOC Obsolete flag. | |
| 964 | SHOW FILES Show begin and end of included files. | |
| 965 | ||
| 966 | Each of these flags can be set to t or nil, or to a string of type letters | |
| 967 | indicating the label types for which it should be true. These strings work | |
| 968 | like character classes in regular expressions. Thus, setting one of the | |
| 969 | flags to \"sf\" makes the flag true for section and figure labels, nil | |
| 970 | for everything else. Setting it to \"^sf\" makes it the other way round. | |
| 971 | The available label types are: s (section), f (figure), t (table), i (item), | |
| 972 | e (equation), n (footnote), plus any definitions in `reftex-label-alist'. | |
| 973 | ||
| 974 | Most options can also be switched from the label menu itself - so if you | |
| 975 | decide here to not have a table of contents in the label menu, you can still | |
| 976 | get one interactively during selection from the label menu." | |
| 977 | :group 'reftex-referencing-labels | |
| 978 | :type | |
| 979 | `(list | |
| 980 | (choice :tag "Embed in table of contents " ,@reftex-tmp) | |
| 981 | (choice :tag "Show section numbers " ,@reftex-tmp) | |
| 982 | (choice :tag "Show individual counters " ,@reftex-tmp) | |
| 983 | (choice :tag "Hide short context " ,@reftex-tmp) | |
| 984 | (choice :tag "Follow context in other window " ,@reftex-tmp) | |
| 985 | (choice :tag "Show commented labels " ,@reftex-tmp) | |
| 3666daf6 | 986 | (choice :tag "Obsolete flag, Don't use. " ,@reftex-tmp) |
| 1a9461d0 CD |
987 | (choice :tag "Show begin/end of included files" ,@reftex-tmp))) |
| 988 | ||
| 989 | (defcustom reftex-multiref-punctuation '((?, . ", ") (?- . "--") (?+ . " and ")) | |
| 990 | "Punctuation strings for multiple references. | |
| 991 | When marking is used in the selection buffer to select several references, | |
| 992 | this variable associates the 3 marking characters `,-+' with prefix strings | |
| 70d797cd | 993 | to be inserted into the buffer before the corresponding \\ref macro. |
| 1a9461d0 CD |
994 | This is used to string together whole reference sets, like |
| 995 | `eqs. 1,2,3-5,6 and 7' in a single call to `reftex-reference'. See manual." | |
| 996 | :group 'reftex-referencing-labels | |
| 997 | :type '(repeat (cons (character) (string)))) | |
| 998 | ||
| 4f595e15 RA |
999 | (defcustom reftex-ref-style-alist |
| 1000 | '(("Default" t | |
| 1001 | (("\\ref" ?\C-m) ("\\pageref" ?p))) | |
| 1002 | ("Varioref" "varioref" | |
| 1003 | (("\\vref" ?v) ("\\vpageref" ?g) ("\\Vref" ?V) ("\\Ref" ?R))) | |
| 1004 | ("Fancyref" "fancyref" | |
| 1005 | (("\\fref" ?f) ("\\Fref" ?F))) | |
| 1006 | ("Hyperref" "hyperref" | |
| 074dd971 TH |
1007 | (("\\autoref" ?a) ("\\autopageref" ?u))) |
| 1008 | ("Cleveref" "cleveref" | |
| 1009 | (("\\cref" ?c) ("\\Cref" ?C) ("\\cpageref" ?d) ("\\Cpageref" ?D)))) | |
| 4f595e15 RA |
1010 | "Alist of reference styles. |
| 1011 | Each element is a list of the style name, the name of the LaTeX | |
| 1012 | package associated with the style or t for any package, and an | |
| 1013 | alist of macros where the first entry of each item is the | |
| 1014 | reference macro and the second a key for selecting the macro when | |
| 1015 | the macro type is being prompted for. (See also | |
| 1016 | `reftex-ref-macro-prompt'.) The keys, represented as characters, | |
| 1017 | have to be unique." | |
| 1018 | :group 'reftex-referencing-labels | |
| d1a1c7e6 | 1019 | :version "24.3" |
| 4f595e15 RA |
1020 | :type '(alist :key-type (string :tag "Style name") |
| 1021 | :value-type (group (choice :tag "Package" | |
| 1022 | (const :tag "Any package" t) | |
| 1023 | (string :tag "Name")) | |
| 1024 | (repeat :tag "Macros" | |
| 1025 | (group (string :tag "Macro") | |
| 1026 | (character :tag "Key")))))) | |
| 1027 | ||
| 1028 | (defcustom reftex-ref-macro-prompt t | |
| 1029 | "If non-nil, `reftex-reference' prompts for the reference macro." | |
| 1030 | :group 'reftex-referencing-labels | |
| d1a1c7e6 | 1031 | :version "24.3" |
| 4f595e15 RA |
1032 | :type 'boolean) |
| 1033 | ||
| 1a9461d0 | 1034 | (defcustom reftex-vref-is-default nil |
| 4f595e15 RA |
1035 | "Non-nil means, the varioref reference style is used as default. |
| 1036 | The value of this variable determines the default which is active | |
| 1037 | when entering the selection process. Instead of nil or t, this | |
| 1038 | may also be a string of type letters indicating the label types | |
| 1039 | for which it should be true. | |
| 1040 | ||
| 1041 | This variable is obsolete, use `reftex-ref-style-default-list' | |
| 1042 | instead." | |
| 1a9461d0 CD |
1043 | :group 'reftex-referencing-labels |
| 1044 | :type `(choice :tag "\\vref is default macro" ,@reftex-tmp)) | |
| 0a206828 | 1045 | ;;;###autoload(put 'reftex-vref-is-default 'safe-local-variable (lambda (x) (or (stringp x) (symbolp x)))) |
| 1a9461d0 CD |
1046 | |
| 1047 | (defcustom reftex-fref-is-default nil | |
| 4f595e15 RA |
1048 | "Non-nil means, the fancyref reference style is used as default. |
| 1049 | The value of this variable determines the default which is active | |
| 1050 | when entering the selection process. Instead of nil or t, this | |
| 1051 | may also be a string of type letters indicating the label types | |
| 1052 | for which it should be true. | |
| 1053 | ||
| 1054 | This variable is obsolete, use `reftex-ref-style-default-list' | |
| 1055 | instead." | |
| 1a9461d0 CD |
1056 | :group 'reftex-referencing-labels |
| 1057 | :type `(choice :tag "\\fref is default macro" ,@reftex-tmp)) | |
| 0a206828 | 1058 | ;;;###autoload(put 'reftex-fref-is-default 'safe-local-variable (lambda (x) (or (stringp x) (symbolp x)))) |
| 1a9461d0 | 1059 | |
| 4f595e15 RA |
1060 | (defcustom reftex-ref-style-default-list '("Default") |
| 1061 | "List of reference styles to be activated by default. | |
| 1062 | The order is significant and controls the order in which macros | |
| 1063 | can be cycled in the buffer for selecting a label. The entries | |
| 1064 | in the list have to match the respective reference style names | |
| 1065 | used in the variable `reftex-ref-style-alist'." | |
| 1066 | :group 'reftex-referencing-labels | |
| d1a1c7e6 | 1067 | :version "24.3" |
| 4f595e15 RA |
1068 | :type `(set ,@(mapcar (lambda (x) (list 'const (car x))) |
| 1069 | reftex-ref-style-alist))) | |
| 1070 | ||
| 1071 | ;; Compatibility with obsolete variables. | |
| 1072 | (when reftex-vref-is-default | |
| 1073 | (add-to-list 'reftex-ref-style-default-list "Varioref")) | |
| 1074 | (when reftex-fref-is-default | |
| 1075 | (add-to-list 'reftex-ref-style-default-list "Fancyref")) | |
| 1076 | ||
| 1a9461d0 | 1077 | (defcustom reftex-level-indent 2 |
| fb7ada5f | 1078 | "Number of spaces to be used for indentation per section level." |
| 1a9461d0 CD |
1079 | :group 'reftex-referencing-labels |
| 1080 | :type 'integer) | |
| 6c07f4d4 | 1081 | ;;;###autoload(put 'reftex-level-indent 'safe-local-variable 'integerp) |
| 1a9461d0 CD |
1082 | |
| 1083 | (defcustom reftex-guess-label-type t | |
| fb7ada5f | 1084 | "Non-nil means, `reftex-reference' will try to guess the label type. |
| 1a9461d0 CD |
1085 | To do that, RefTeX will look at the word before the cursor and compare it with |
| 1086 | the words given in `reftex-label-alist'. When it finds a match, RefTeX will | |
| 1087 | immediately offer the correct label menu - otherwise it will prompt you for | |
| 1088 | a label type. If you set this variable to nil, RefTeX will always prompt." | |
| 1089 | :group 'reftex-referencing-labels | |
| 1090 | :type 'boolean) | |
| a55b741e | 1091 | ;;;###autoload(put 'reftex-guess-label-type 'safe-local-variable (lambda (x) (memq x '(nil t)))) |
| 1a9461d0 CD |
1092 | |
| 1093 | (defcustom reftex-format-ref-function nil | |
| 1094 | "Function which produces the string to insert as a reference. | |
| 4f595e15 RA |
1095 | Normally should be nil, because the format to insert a reference |
| 1096 | can already be specified in `reftex-label-alist'. | |
| 1097 | ||
| 1098 | This hook also is used by the special commands to insert | |
| 1099 | e.g. `\\vref' and `\\fref' references, so even if you set this, | |
| 1100 | your setting will be ignored by the special commands. | |
| 1101 | ||
| 1102 | The function will be called with three arguments, the LABEL, the | |
| 1103 | DEFAULT FORMAT, which normally is `~\\ref{%s}' and the REFERENCE | |
| 1104 | STYLE. The function should return the string to insert into the | |
| 1105 | buffer." | |
| 1a9461d0 | 1106 | :group 'reftex-referencing-labels |
| 4f595e15 | 1107 | :type '(choice (const nil) function)) |
| 1a9461d0 CD |
1108 | |
| 1109 | (defcustom reftex-select-label-mode-hook nil | |
| 4f595e15 | 1110 | "Mode hook for `reftex-select-label-mode'." |
| 1a9461d0 CD |
1111 | :group 'reftex-referencing-labels |
| 1112 | :type 'hook) | |
| 1113 | ||
| 1114 | ;; BibteX citation configuration ---------------------------------------- | |
| 1115 | ||
| 1116 | (defgroup reftex-citation-support nil | |
| 1117 | "Support for referencing bibliographic data with BibTeX." | |
| 1118 | :group 'reftex) | |
| 1119 | ||
| 4f595e15 | 1120 | (defcustom reftex-bibliography-commands |
| c43d45f9 | 1121 | '("bibliography" "nobibliography" "setupbibtex\\[.*?database=" "addbibresource") |
| 6fbeb429 CD |
1122 | "LaTeX commands which specify the BibTeX databases to use with the document." |
| 1123 | :group 'reftex-citation-support | |
| 1124 | :type '(repeat string)) | |
| 1125 | ||
| 1126 | ||
| 1a9461d0 CD |
1127 | (defvar reftex-bibfile-ignore-list nil) ; compatibility |
| 1128 | (defcustom reftex-bibfile-ignore-regexps nil | |
| fb7ada5f | 1129 | "List of regular expressions to exclude files in \\bibliography{..}. |
| 1a9461d0 CD |
1130 | File names matched by these regexps will not be parsed by RefTeX. |
| 1131 | Intended for files which contain only `@string' macro definitions and the | |
| 1132 | like, which are ignored by RefTeX anyway." | |
| 1133 | :group 'reftex-citation-support | |
| 1134 | :set 'reftex-set-dirty | |
| 1135 | :type '(repeat (regexp))) | |
| 1136 | ||
| 1137 | (defcustom reftex-default-bibliography nil | |
| fb7ada5f | 1138 | "List of BibTeX database files which should be used if none are specified. |
| 1a9461d0 | 1139 | When `reftex-citation' is called from a document which has neither a |
| 70d797cd | 1140 | `\\bibliography{..}' statement nor a `thebibliography' environment, |
| 1a9461d0 CD |
1141 | RefTeX will scan these files instead. Intended for using `reftex-citation' |
| 1142 | in non-LaTeX files. The files will be searched along the BIBINPUTS or TEXBIB | |
| 1143 | path." | |
| 1144 | :group 'reftex-citation-support | |
| 1145 | :type '(repeat (file))) | |
| 1146 | ||
| 1147 | (defcustom reftex-sort-bibtex-matches 'reverse-year | |
| fb7ada5f | 1148 | "Sorting of the entries found in BibTeX databases by reftex-citation. |
| 1a9461d0 CD |
1149 | Possible values: |
| 1150 | nil Do not sort entries. | |
| 1151 | 'author Sort entries by author name. | |
| 1152 | 'year Sort entries by increasing year. | |
| 1153 | 'reverse-year Sort entries by decreasing year." | |
| 1154 | :group 'reftex-citation-support | |
| 1155 | :type '(choice (const :tag "not" nil) | |
| 1156 | (const :tag "by author" author) | |
| 1157 | (const :tag "by year" year) | |
| 1158 | (const :tag "by year, reversed" reverse-year))) | |
| 1159 | ||
| 1160 | (defcustom reftex-cite-format 'default | |
| fb7ada5f | 1161 | "The format of citations to be inserted into the buffer. |
| 1a9461d0 CD |
1162 | It can be a string or an alist or a symbol. In the simplest case this |
| 1163 | is just the string \"\\cite{%l}\", which is also the default. See the | |
| 1164 | definition of `reftex-cite-format-builtin' for more complex examples. | |
| 1165 | ||
| 1166 | If `reftex-cite-format' is a string, it will be used as the format. | |
| 1167 | In the format, the following percent escapes will be expanded. | |
| 1168 | ||
| 1169 | %l The BibTeX label of the citation. | |
| 6fbeb429 | 1170 | %a List of author names, see also `reftex-cite-punctuation'. |
| 1a9461d0 CD |
1171 | %2a Like %a, but abbreviate more than 2 authors like Jones et al. |
| 1172 | %A First author name only. | |
| 1173 | %e Works like %a, but on list of editor names. (%2e and %E work a well) | |
| 1174 | ||
| 1175 | It is also possible to access all other BibTeX database fields: | |
| e6aff855 TH |
1176 | %b booktitle %c chapter %d edition %h howpublished |
| 1177 | %i institution %j journal %k key %m month | |
| 1178 | %n number %N note %o organization %p pages | |
| 1179 | %P first page %r address %s school %u publisher | |
| 1180 | %U url %t title %v volume %y year | |
| 1181 | %B booktitle, abbreviated %T title, abbreviated | |
| 1a9461d0 CD |
1182 | |
| 1183 | Usually, only %l is needed. The other stuff is mainly for the echo area | |
| 1184 | display, and for (setq reftex-comment-citations t). | |
| 1185 | ||
| c8de140b | 1186 | %< as a special operator kills punctuation and space around it after the |
| 1a9461d0 CD |
1187 | string has been formatted. |
| 1188 | ||
| f3c18bd0 CD |
1189 | A pair of square brackets indicates an optional argument, and RefTeX |
| 1190 | will prompt for the values of these arguments. | |
| 1191 | ||
| 1a9461d0 CD |
1192 | Beware that all this only works with BibTeX database files. When |
| 1193 | citations are made from the \\bibitems in an explicit thebibliography | |
| 1194 | environment, only %l is available. | |
| 1195 | ||
| 1196 | If `reftex-cite-format' is an alist of characters and strings, the user | |
| 1197 | will be prompted for a character to select one of the possible format | |
| 1198 | strings. | |
| 1199 | In order to configure this variable, you can either set | |
| 1200 | `reftex-cite-format' directly yourself or set it to the SYMBOL of one of | |
| c8de140b | 1201 | the predefined styles. The predefined symbols are those which have an |
| 1a9461d0 CD |
1202 | association in the constant `reftex-cite-format-builtin'. |
| 1203 | E.g.: (setq reftex-cite-format 'natbib)" | |
| 1204 | :group 'reftex-citation-support | |
| 1205 | :type | |
| 1206 | `(choice | |
| 1207 | :format "%{%t%}: \n%[Value Menu%] %v" | |
| 1208 | (radio :tag "Symbolic Builtins" | |
| 1209 | :indent 4 | |
| 1210 | :value default | |
| 1211 | ,@(mapcar | |
| 1212 | (lambda (x) | |
| 1213 | (list 'const :tag (concat (symbol-name (nth 0 x)) | |
| 1214 | ": " (nth 1 x)) | |
| 1215 | (nth 0 x))) | |
| 1216 | reftex-cite-format-builtin)) | |
| 1217 | (string :tag "format string" "\\cite{%l}") | |
| 1218 | (repeat :tag "key-ed format strings" | |
| 1219 | :value ((?\r . "\\cite{%l}") | |
| 1220 | (?t . "\\cite{%l}") (?p . "\\cite{%l}")) | |
| 1221 | (cons (character :tag "Key character" ?\r) | |
| 1222 | (string :tag "Format string" ""))))) | |
| 1223 | ||
| f3c18bd0 | 1224 | (defcustom reftex-cite-prompt-optional-args 'maybe |
| fb7ada5f | 1225 | "Non-nil means, prompt for empty optional arguments in cite macros. |
| 4f595e15 | 1226 | When an entry in `reftex-cite-format' is given with square brackets to |
| f3c18bd0 CD |
1227 | indicate optional arguments (for example \\cite[][]{%l}), RefTeX can |
| 1228 | prompt for values. Possible values are: | |
| 1229 | ||
| 1230 | nil Never prompt for optional arguments | |
| 1231 | t Always prompt | |
| 1232 | maybe Prompt only if `reftex-citation' was called with C-u prefix arg | |
| 1233 | ||
| 1234 | Unnecessary empty optional arguments are removed before insertion into | |
| 1235 | the buffer. See `reftex-cite-cleanup-optional-args'." | |
| 1236 | :group 'reftex-citation-support | |
| 1237 | :type '(choice | |
| 1238 | (const :tag "Always" t) | |
| 1239 | (const :tag "When called with prefix arg" maybe) | |
| 1240 | (const :tag "Never" nil))) | |
| 1241 | ||
| 1242 | (defcustom reftex-cite-cleanup-optional-args t | |
| fb7ada5f | 1243 | "Non-nil means, remove unnecessary empty optional arguments in cite macros. |
| f3c18bd0 CD |
1244 | The cite macros provided by some packages (for example |
| 1245 | natbib) allow specifying two optional arguments, one for a prefix to | |
| 1246 | the citation, and a second for a postfix. When only one optional | |
| 1247 | argument is given, it is interpreted as postfix. When this option is | |
| 1248 | t, RefTeX removes unnecessary empty optional arguments from the cite | |
| 1249 | macro before insertion. For example, it will change | |
| 1250 | \\cite[][]{Jones} -> \\cite{Jones} | |
| 1251 | \\cite[][Chapter 1]{Jones} -> \\cite[Chapter 1]{Jones} | |
| 1252 | \\cite[see][]{Jones} -> \\cite[see][]{Jones} | |
| 1253 | \\cite[see][Chapter 1]{Jones} -> \\cite{Jones} | |
| 1254 | Is is possible that other packages have other conventions about which | |
| 1255 | optional argument is interpreted how - that is why this cleaning up | |
| 1256 | can be turned off." | |
| 1257 | :group 'reftex-citation-support | |
| 1258 | :type 'boolean) | |
| 1259 | ||
| 1a9461d0 | 1260 | (defcustom reftex-comment-citations nil |
| fb7ada5f | 1261 | "Non-nil means add a comment for each citation describing the full entry. |
| 1a9461d0 CD |
1262 | The comment is formatted according to `reftex-cite-comment-format'." |
| 1263 | :group 'reftex-citation-support | |
| 1264 | :type 'boolean) | |
| 1265 | ||
| 1266 | (defcustom reftex-cite-comment-format | |
| 1267 | "%% %2a %y, %j %v, %P, %b, %e, %u, %s %<\n" | |
| 1268 | "Citation format used for commented citations. Must NOT contain %l. | |
| 1269 | See the variable `reftex-cite-format' for possible percent escapes." | |
| 1270 | :group 'reftex-citation-support | |
| 1271 | :type 'string) | |
| 1272 | ||
| 1273 | (defcustom reftex-cite-view-format "%2a %y, %T, %B, %j %v:%P, %s %<" | |
| 1274 | "Citation format used to display citation info in the message area. | |
| 1275 | Must NOT contain %l. See the variable `reftex-cite-format' for | |
| 1276 | possible percent escapes." | |
| 1277 | :group 'reftex-citation-support | |
| 1278 | :group 'reftex-viewing-cross-references | |
| 1279 | :type 'string) | |
| 1280 | ||
| 1281 | (defcustom reftex-cite-punctuation '(", " " \\& " " {\\it et al.}") | |
| 1282 | "Punctuation for formatting of name lists in citations. | |
| 1283 | This is a list of 3 strings. | |
| c8de140b JB |
1284 | 1. Normal names separator, like \", \" in Jones, Brown and Miller |
| 1285 | 2. Final names separator, like \" and \" in Jones, Brown and Miller | |
| 1a9461d0 CD |
1286 | 3. The \"et al\" string, like \" {\\it et al.}\" in Jones {\\it et al.}" |
| 1287 | :group 'reftex-citation-support | |
| 1288 | :type '(list | |
| 1289 | (string :tag "Separator for names ") | |
| 1290 | (string :tag "Separator for last name in list") | |
| 1291 | (string :tag "string used as et al. "))) | |
| 1292 | ||
| 1293 | (defcustom reftex-format-cite-function nil | |
| 1294 | "Function which produces the string to insert as a citation. | |
| c8de140b | 1295 | Normally should be nil, because the format to insert a reference can |
| 1a9461d0 CD |
1296 | already be specified in `reftex-cite-format'. |
| 1297 | The function will be called with two arguments, the CITATION KEY and the | |
| 1298 | DEFAULT FORMAT, which is taken from `reftex-cite-format'. The function | |
| 1299 | should return the string to insert into the buffer." | |
| 1300 | :group 'reftex-citation-support | |
| 4f595e15 | 1301 | :type '(choice (const nil) function)) |
| 1a9461d0 CD |
1302 | |
| 1303 | (defcustom reftex-select-bib-mode-hook nil | |
| 1304 | "Mode hook for reftex-select-bib-mode." | |
| 1305 | :group 'reftex-citation-support | |
| 1306 | :type 'hook) | |
| 1307 | ||
| 4f595e15 RA |
1308 | (defcustom reftex-cite-key-separator "," |
| 1309 | "String to be used for separating several keys in a \\cite macro." | |
| 1310 | :group 'reftex-citation-support | |
| d1a1c7e6 | 1311 | :version "24.3" |
| 4f595e15 RA |
1312 | :type 'string) |
| 1313 | ||
| 1314 | (defcustom reftex-create-bibtex-header nil | |
| 1315 | "Header to insert in BibTeX files generated by RefTeX." | |
| 1316 | :group 'reftex-citation-support | |
| d1a1c7e6 | 1317 | :version "24.3" |
| 460042b8 | 1318 | :type '(choice (const :tag "No header" nil) string)) |
| 4f595e15 RA |
1319 | |
| 1320 | (defcustom reftex-create-bibtex-footer nil | |
| 1321 | "Footer to insert in BibTeX files generated by RefTeX." | |
| 1322 | :group 'reftex-citation-support | |
| d1a1c7e6 | 1323 | :version "24.3" |
| 460042b8 | 1324 | :type '(choice (const :tag "No footer" nil) string)) |
| 4f595e15 | 1325 | |
| 1a9461d0 CD |
1326 | ;; Index Support Configuration |
| 1327 | ||
| 1328 | (defgroup reftex-index-support nil | |
| 1329 | "Support for viewing and editing the index." | |
| 1330 | :group 'reftex) | |
| 1331 | ||
| 1332 | (defcustom reftex-support-index t | |
| fb7ada5f | 1333 | "Non-nil means, index entries are parsed as well. |
| 1a9461d0 CD |
1334 | Index support is resource intensive and the internal structure holding the |
| 1335 | parsed information can become quite big. Therefore it can be turned off. | |
| 1336 | When this is nil and you execute a command which requires index support, | |
| 1337 | you will be asked for confirmation to turn it on and rescan the document." | |
| 1338 | :group 'reftex-index-support | |
| 1339 | :type 'boolean) | |
| 1340 | ||
| 1341 | (defcustom reftex-index-special-chars '("!" "|" "@" "\"" "\\") | |
| 1342 | "Special characters in index entries. The value is a list of five strings. | |
| 1343 | These correspond to the makeindex keywords LEVEL ENCAP ACTUAL QUOTE ESCAPE." | |
| 1344 | :group 'reftex-index-support | |
| 1345 | :type '(list | |
| 3666daf6 CD |
1346 | (string :tag "LEVEL separator") |
| 1347 | (string :tag "ENCAP char ") | |
| 1348 | (string :tag "ACTUAL char ") | |
| 1349 | (string :tag "QUOTE char ") | |
| 1350 | (string :tag "ESCAPE char "))) | |
| 1a9461d0 CD |
1351 | |
| 1352 | (defcustom reftex-index-macros nil | |
| 4f595e15 RA |
1353 | "Macros which define index entries. |
| 1354 | ||
| 1355 | The structure is | |
| 1a9461d0 | 1356 | |
| 3666daf6 | 1357 | \(MACRO INDEX-TAG KEY PREFIX EXCLUDE REPEAT) |
| 1a9461d0 CD |
1358 | |
| 1359 | MACRO is the macro. Arguments should be denoted by empty braces like | |
| 1360 | \\index[]{*}. Use square brackets to denote optional arguments. The star | |
| 1361 | marks where the index key is. | |
| 1362 | ||
| 1363 | INDEX-TAG is a short name of the index. \"idx\" and \"glo\" are | |
| 1364 | reserved for the default index and the glossary. Other indices can be | |
| 1365 | defined as well. If this is an integer, the Nth argument of the macro | |
| 1366 | holds the index tag. | |
| 1367 | ||
| 1368 | KEY is a character which is used to identify the macro for input with | |
| 1369 | \\[reftex-index]. ?i, ?I, and ?g are reserved for default index and glossary. | |
| 1370 | ||
| 1371 | PREFIX can be a prefix which is added to the KEY part of the index entry. | |
| 1372 | If you have a macro \\newcommand{\\molec}[1]{#1\\index{Molecules!#1}}, this | |
| 1373 | prefix should be \"Molecules!\". See the manual for details. | |
| 1374 | ||
| 1375 | EXCLUDE can be a function. If this function exists and returns a non-nil | |
| 1376 | value, the index entry at point is ignored. This was implemented to support | |
| 1377 | the (deprecated) `^' and `_' shortcuts in the LaTeX2e `index' package. | |
| 1378 | ||
| 7c4d13cc CD |
1379 | REPEAT, if non-nil, means the index macro does not typeset the entry in |
| 1380 | the text, so that the text has to be repeated outside the index macro. | |
| 1381 | Needed for `reftex-index-selection-or-word' and for indexing from the | |
| 1382 | phrase buffer. | |
| 1383 | ||
| 1a9461d0 CD |
1384 | The final entry may also be a symbol if this entry has a association |
| 1385 | in the variable `reftex-index-macros-builtin' to specify the main | |
| f8b00e0f | 1386 | indexing package you are using. Valid values are currently |
| 1a9461d0 CD |
1387 | default The LaTeX default - unnecessary to specify this one |
| 1388 | multind The multind.sty package | |
| 1389 | index The index.sty package | |
| 1390 | index-shortcut The index.sty packages with the ^ and _ shortcuts. | |
| 1391 | Should not be used - only for old documents. | |
| 1392 | Note that AUCTeX sets these things internally for RefTeX as well, so | |
| 1393 | with a sufficiently new version of AUCTeX, you should not set the | |
| 1394 | package here." | |
| 1395 | :group 'reftex-index-support | |
| 1396 | :set 'reftex-set-dirty | |
| 1397 | :type `(list | |
| c8de140b | 1398 | (repeat |
| 3666daf6 CD |
1399 | :inline t |
| 1400 | (list :value ("" "idx" ?a "" nil) | |
| 1401 | (string :tag "Macro with args") | |
| 1402 | (choice :tag "Index Tag " | |
| 1403 | (string) | |
| 1404 | (integer :tag "Macro arg Nr" :value 1)) | |
| 1405 | (character :tag "Access Key ") | |
| 1406 | (string :tag "Key Prefix ") | |
| 1407 | (symbol :tag "Exclusion hook ") | |
| 7c4d13cc | 1408 | (boolean :tag "Repeat Outside "))) |
| 3666daf6 CD |
1409 | (option |
| 1410 | :tag "Package:" | |
| 1411 | (choice :tag "Package" | |
| 1412 | :value index | |
| 1413 | ,@(mapcar | |
| 1414 | (lambda (x) | |
| 1415 | (list 'const :tag (concat (symbol-name (nth 0 x)) | |
| 1416 | ": " (nth 1 x)) | |
| 1417 | (nth 0 x))) | |
| 1418 | reftex-index-macros-builtin))))) | |
| 1a9461d0 | 1419 | |
| 7c4d13cc | 1420 | (defcustom reftex-index-default-macro '(?i "idx") |
| 1a9461d0 | 1421 | "The default index macro for \\[reftex-index-selection-or-word]. |
| 7c4d13cc | 1422 | This is a list with (MACRO-KEY DEFAULT-TAG). |
| 1a9461d0 CD |
1423 | |
| 1424 | MACRO-KEY: Character identifying an index macro - see `reftex-index-macros'. | |
| c8de140b | 1425 | DEFAULT-TAG: This is the tag to be used if the macro requires a TAG argument. |
| 1a9461d0 CD |
1426 | When this is nil and a TAG is needed, RefTeX will ask for it. |
| 1427 | When this is the empty string and the TAG argument of the index | |
| 7c4d13cc | 1428 | macro is optional, the TAG argument will be omitted." |
| 1a9461d0 CD |
1429 | :group 'reftex-index-support |
| 1430 | :type '(list | |
| 3666daf6 CD |
1431 | (character :tag "Character identifying default macro") |
| 1432 | (choice :tag "Default index tag " | |
| 1433 | (const nil) | |
| 1434 | (string)))) | |
| 1a9461d0 CD |
1435 | |
| 1436 | (defcustom reftex-index-default-tag "idx" | |
| 1437 | "Default index tag. | |
| 1438 | When working with multiple indexes, RefTeX queries for an index tag when | |
| 1439 | creating index entries or displaying a specific index. This variable controls | |
| 1440 | the default offered for these queries. The default can be selected with RET | |
| f8b00e0f | 1441 | during selection or completion. Valid values of this variable are: |
| 1a9461d0 CD |
1442 | |
| 1443 | nil Do not provide a default index | |
| 1444 | \"tag\" The default index tag given as a string, e.g. \"idx\". | |
| 1445 | last The last used index tag will be offered as default." | |
| 1446 | :group 'reftex-index-support | |
| 1447 | :type '(choice | |
| 3666daf6 | 1448 | (const :tag "no default" nil) |
| 9c61f806 | 1449 | (const :tag "last used " last) |
| 3666daf6 | 1450 | (string :tag "index tag " "idx"))) |
| 1a9461d0 CD |
1451 | |
| 1452 | (defcustom reftex-index-math-format "$%s$" | |
| 1453 | "Format of index entries when copied from inside math mode. | |
| 1454 | When `reftex-index-selection-or-word' is executed inside TeX math mode, | |
| 1455 | the index key copied from the buffer is processed with this format string | |
| 1456 | through the `format' function. This can be used to add the math delimiters | |
| 3666daf6 | 1457 | \(e.g. `$') to the string. |
| 1a9461d0 CD |
1458 | Requires the `texmathp.el' library which is part of AUCTeX." |
| 1459 | :group 'reftex-index-support | |
| 1460 | :type 'string) | |
| 1461 | ||
| 9f286482 CD |
1462 | (defcustom reftex-index-phrase-file-extension ".rip" |
| 1463 | "File extension for the index phrase file. | |
| 1464 | This extension will be added to the base name of the master file." | |
| 1465 | :group 'reftex-index-support | |
| 1466 | :type 'string) | |
| 1467 | ||
| 7c4d13cc CD |
1468 | (defcustom reftex-index-phrases-logical-and-regexp " *&& *" |
| 1469 | "Regexp matching the `and' operator for index arguments in phrases file. | |
| 1470 | When several index arguments in a phrase line are separated by this | |
| 1471 | operator, each part will generate an index macro. So each match of | |
| 1472 | the search phrase will produce *several* different index entries. | |
| 1473 | ||
| 1474 | Note: make sure this does no match things which are not separators. | |
| 1475 | This logical `and' has higher priority than the logical `or' specified in | |
| 1476 | `reftex-index-phrases-logical-or-regexp'." | |
| 1477 | :group 'reftex-index-support | |
| 1478 | :type 'regexp) | |
| 1479 | ||
| 1480 | (defcustom reftex-index-phrases-logical-or-regexp " *|| *" | |
| 1481 | "Regexp matching the `or' operator for index arguments in phrases file. | |
| 1482 | When several index arguments in a phrase line are separated by this | |
| 1483 | operator, the user will be asked to select one of them at each match | |
| 1484 | of the search phrase. The first index arg will be the default - a | |
| 1485 | number key 1-9 must be pressed to switch to another. | |
| 1486 | ||
| 1487 | Note: make sure this does no match things which are not separators. | |
| 1488 | The logical `and' specified in `reftex-index-phrases-logical-or-regexp' | |
| 1489 | has higher priority than this logical `or'." | |
| 1490 | :group 'reftex-index-support | |
| 1491 | :type 'regexp) | |
| 1492 | ||
| 1493 | (defcustom reftex-index-phrases-search-whole-words t | |
| fb7ada5f | 1494 | "Non-nil means phrases search will look for whole words, not subwords. |
| 7c4d13cc CD |
1495 | This works by requiring word boundaries at the beginning and end of |
| 1496 | the search string. When the search phrase already has a non-word-char | |
| 1497 | at one of these points, no word boundary is required there." | |
| 1498 | :group 'reftex-index-support | |
| 1499 | :type 'boolean) | |
| 1500 | ||
| 1501 | (defcustom reftex-index-phrases-case-fold-search t | |
| fb7ada5f | 1502 | "Non-nil means, searching for index phrases will ignore case." |
| 7c4d13cc CD |
1503 | :group 'reftex-index-support |
| 1504 | :type 'boolean) | |
| 1505 | ||
| 6fbeb429 CD |
1506 | (defcustom reftex-index-verify-function nil |
| 1507 | "A function which is called at each match during global indexing. | |
| 1508 | If the function returns nil, the current match is skipped." | |
| 1509 | :group 'reftex-index-support | |
| 1510 | :type '(choice | |
| 3666daf6 CD |
1511 | (const :tag "No verification" nil) |
| 1512 | (function))) | |
| 6fbeb429 | 1513 | |
| 7c4d13cc | 1514 | (defcustom reftex-index-phrases-skip-indexed-matches nil |
| fb7ada5f | 1515 | "Non-nil means, skip matches which appear to be indexed already. |
| 7c4d13cc CD |
1516 | When doing global indexing from the phrases buffer, searches for some |
| 1517 | phrases may match at places where that phrase was already indexed. In | |
| 1518 | particular when indexing an already processed document again, this | |
| 1519 | will even be the norm. When this variable is non-nil, RefTeX checks if | |
| 3666daf6 | 1520 | the match is inside an index macro argument, or if an index macro is directly |
| 7c4d13cc CD |
1521 | before or after the phrase. If that is the case, that match will |
| 1522 | be ignored." | |
| 1523 | :group 'reftex-index-support | |
| 1524 | :type 'boolean) | |
| 1525 | ||
| 1526 | (defcustom reftex-index-phrases-wrap-long-lines nil | |
| fb7ada5f | 1527 | "Non-nil means, when indexing from the phrases buffer, wrap lines. |
| 7c4d13cc CD |
1528 | Inserting indexing commands in a line makes the line longer - often |
| 1529 | so long that it does not fit onto the screen. When this variable is | |
| 1530 | non-nil, newlines will be added as necessary before and/or after the | |
| 1531 | indexing command to keep lines short. However, the matched text | |
| f5307782 JB |
1532 | phrase and its index command will always end up on a single line." |
| 1533 | :group 'reftex-index-support | |
| 1534 | :type 'boolean) | |
| 7c4d13cc CD |
1535 | |
| 1536 | (defcustom reftex-index-phrases-sort-prefers-entry nil | |
| fb7ada5f | 1537 | "Non-nil means when sorting phrase lines, the explicit index entry is used. |
| 7c4d13cc CD |
1538 | Phrase lines in the phrases buffer contain a search phrase, and |
| 1539 | sorting is normally based on these. Some phrase lines also have | |
| 1540 | an explicit index argument specified. When this variable is non-nil, | |
| 1541 | the index argument will be used for sorting." | |
| 1542 | :group 'reftex-index-support | |
| 1543 | :type 'boolean) | |
| 1544 | ||
| 1545 | (defcustom reftex-index-phrases-sort-in-blocks t | |
| fb7ada5f | 1546 | "Non-nil means, empty and comment lines separate phrase buffer into blocks. |
| 7c4d13cc CD |
1547 | Sorting will then preserve blocks, so that lines are re-arranged only |
| 1548 | within blocks." | |
| 1549 | :group 'reftex-index-support | |
| 1550 | :type 'boolean) | |
| 1551 | ||
| 1a9461d0 CD |
1552 | (defcustom reftex-index-section-letters "ABCDEFGHIJKLMNOPQRSTUVWXYZ" |
| 1553 | "The letters which denote sections in the index. | |
| 1554 | Usually these are all capital letters. Don't use any downcase letters. | |
| 1555 | Order is not significant, the index will be sorted by whatever the sort | |
| 1556 | function thinks is correct. | |
| 1557 | In addition to these letters, RefTeX will create a group `!' which | |
| 1558 | contains all entries sorted below the lowest specified letter. | |
| 1559 | In the index buffer, pressing any of these capital letters or `!' will jump | |
| 1560 | to that section." | |
| 1561 | :group 'reftex-index-support | |
| 1562 | :type '(string :tag "Capital letters")) | |
| 1563 | ||
| 1564 | (defcustom reftex-index-include-context nil | |
| fb7ada5f | 1565 | "Non-nil means, display the index definition context in the index buffer. |
| c8de140b | 1566 | This flag may also be toggled from the index buffer with the `c' key." |
| 1a9461d0 CD |
1567 | :group 'reftex-index-support |
| 1568 | :type 'boolean) | |
| 1569 | ||
| 1570 | (defcustom reftex-index-follow-mode nil | |
| fb7ada5f | 1571 | "Non-nil means, point in *Index* buffer will cause other window to follow. |
| 1a9461d0 CD |
1572 | The other window will show the corresponding part of the document. |
| 1573 | This flag can be toggled from within the *Index* buffer with the `f' key." | |
| 1574 | :group 'reftex-table-of-contents-browser | |
| 1575 | :type 'boolean) | |
| 1576 | ||
| 1577 | ;; Viewing Cross References | |
| 1578 | ||
| 1579 | (defgroup reftex-viewing-cross-references nil | |
| 1580 | "Displaying cross references and citations." | |
| 1581 | :group 'reftex) | |
| 1582 | ||
| 1583 | (defcustom reftex-view-crossref-extra nil | |
| 1584 | "Macros which can be used for the display of cross references. | |
| 1585 | This is used when `reftex-view-crossref' is called with point in an | |
| 1586 | argument of a macro. Note that crossref viewing for citations, | |
| 1587 | references (both ways) and index entries is hard-coded. This variable | |
| 4f595e15 | 1588 | is only to configure additional structures for which cross-reference |
| c8de140b | 1589 | viewing can be useful. Each entry has the structure |
| 1a9461d0 | 1590 | |
| 3666daf6 | 1591 | \(MACRO-RE SEARCH-RE HIGHLIGHT). |
| 1a9461d0 CD |
1592 | |
| 1593 | MACRO-RE is matched against the macro. SEARCH-RE is the regexp used | |
| 1594 | to search for cross references. `%s' in this regexp is replaced with | |
| 1595 | with the macro argument at point. HIGHLIGHT is an integer indicating | |
| 1596 | which subgroup of the match should be highlighted." | |
| 1597 | :group 'reftex-viewing-cross-references | |
| 1598 | :type '(repeat (group (regexp :tag "Macro Regexp ") | |
| 3666daf6 CD |
1599 | (string :tag "Search Regexp ") |
| 1600 | (integer :tag "Highlight Group")))) | |
| 1a9461d0 CD |
1601 | |
| 1602 | (defcustom reftex-auto-view-crossref t | |
| fb7ada5f | 1603 | "Non-nil means, initially turn automatic viewing of crossref info on. |
| 1a9461d0 | 1604 | Automatic viewing of crossref info normally uses the echo area. |
| 3b919c9f CD |
1605 | Whenever point is idle for more than `reftex-idle-time' seconds on the |
| 1606 | argument of a \\ref or \\cite macro, and no other message is being | |
| 1607 | displayed, the echo area will display information about that cross | |
| 1608 | reference. You can also set the variable to the symbol `window'. In | |
| 1609 | this case a small temporary window is used for the display. | |
| c8de140b | 1610 | This feature can be turned on and off from the menu |
| 3666daf6 | 1611 | \(Ref->Options)." |
| 1a9461d0 CD |
1612 | :group 'reftex-viewing-cross-references |
| 1613 | :type '(choice (const :tag "off" nil) | |
| 3666daf6 CD |
1614 | (const :tag "in Echo Area" t) |
| 1615 | (const :tag "in Other Window" window))) | |
| 1a9461d0 CD |
1616 | |
| 1617 | (defcustom reftex-idle-time 1.2 | |
| fb7ada5f | 1618 | "Time (secs) Emacs has to be idle before automatic crossref display is done. |
| 3b919c9f | 1619 | Applies also to toc recentering." |
| 1a9461d0 CD |
1620 | :group 'reftex-viewing-cross-references |
| 1621 | :type 'number) | |
| 1622 | ||
| 1623 | (defcustom reftex-revisit-to-echo nil | |
| fb7ada5f | 1624 | "Non-nil means, automatic citation display will revisit files if necessary. |
| 1a9461d0 CD |
1625 | When nil, citation display in echo area will only be active for cached |
| 1626 | entries and for BibTeX database files with live associated buffers." | |
| 1627 | :group 'reftex-viewing-cross-references | |
| 1628 | :type 'boolean) | |
| 1629 | ||
| 1630 | (defcustom reftex-cache-cite-echo t | |
| 4f595e15 RA |
1631 | "Non-nil means, echoed information for cite macros is cached. |
| 1632 | The information displayed in the echo area for cite macros is | |
| 1633 | cached and even saved along with the parsing information. The | |
| 1634 | cache survives document scans. In order to clear it, use M-x | |
| 1635 | reftex-reset-mode <RET>." | |
| 1a9461d0 CD |
1636 | :group 'reftex-viewing-cross-references |
| 1637 | :type 'boolean) | |
| 1638 | ||
| 1639 | (defcustom reftex-display-copied-context-hook nil | |
| 4f595e15 RA |
1640 | "Normal hook which is run before context is displayed anywhere. |
| 1641 | Designed for X-Symbol, but may have other uses as well." | |
| 1a9461d0 CD |
1642 | :group 'reftex-viewing-cross-references |
| 1643 | :group 'reftex-referencing-labels | |
| 1644 | :type 'hook) | |
| 1645 | ||
| 1646 | ;; Finding Files -------------------------------------------------------- | |
| 1647 | ||
| 1648 | (defgroup reftex-finding-files nil | |
| 1649 | "Finding files on search paths." | |
| 1650 | :group 'reftex) | |
| 1651 | ||
| 1652 | (defcustom reftex-texpath-environment-variables '("TEXINPUTS") | |
| fb7ada5f | 1653 | "List of specifications how to retrieve the search path for TeX files. |
| 1a9461d0 CD |
1654 | Several entries are possible. |
| 1655 | - If an element is the name of an environment variable, its content is used. | |
| 1656 | - If an element starts with an exclamation mark, it is used as a command | |
| 1657 | to retrieve the path. A typical command with the kpathsearch library would | |
| c8de140b | 1658 | be `!kpsewhich -show-path=.tex'. |
| 1a9461d0 CD |
1659 | - Otherwise the element itself is interpreted as a path. |
| 1660 | Multiple directories can be separated by the system dependent `path-separator'. | |
| 1661 | Directories ending in `//' or `!!' will be expanded recursively. | |
| 1662 | See also `reftex-use-external-file-finders'." | |
| 1663 | :group 'reftex-finding-files | |
| 1664 | :set 'reftex-set-dirty | |
| 1665 | :type '(repeat (string :tag "Specification"))) | |
| 1666 | ||
| 1667 | (defcustom reftex-bibpath-environment-variables '("BIBINPUTS" "TEXBIB") | |
| fb7ada5f | 1668 | "List of specifications how to retrieve search path for .bib database files. |
| 1a9461d0 CD |
1669 | Several entries are possible. |
| 1670 | - If an element is the name of an environment variable, its content is used. | |
| 1671 | - If an element starts with an exclamation mark, it is used as a command | |
| 1672 | to retrieve the path. A typical command with the kpathsearch library would | |
| c8de140b | 1673 | be `!kpsewhich -show-path=.bib'. |
| 1a9461d0 CD |
1674 | - Otherwise the element itself is interpreted as a path. |
| 1675 | Multiple directories can be separated by the system dependent `path-separator'. | |
| 1676 | Directories ending in `//' or `!!' will be expanded recursively. | |
| 1677 | See also `reftex-use-external-file-finders'." | |
| 1678 | :group 'reftex-citation-support | |
| 1679 | :group 'reftex-finding-files | |
| 1680 | :set 'reftex-set-dirty | |
| 1681 | :type '(repeat (string :tag "Specification"))) | |
| 1682 | ||
| 1683 | (defcustom reftex-file-extensions '(("tex" . (".tex" ".ltx")) | |
| 3666daf6 | 1684 | ("bib" . (".bib"))) |
| fb7ada5f | 1685 | "Association list with file extensions for different file types. |
| 1a9461d0 CD |
1686 | This is a list of items, each item is like: (TYPE . (DEF-EXT OTHER-EXT ...)) |
| 1687 | ||
| 1688 | TYPE: File type like \"bib\" or \"tex\". | |
| 1689 | DEF-EXT: The default extension for that file type, like \".tex\" or \".bib\". | |
| f8b00e0f | 1690 | OTHER-EXT: Any number of other valid extensions for this file type. |
| 1a9461d0 | 1691 | |
| 3a1e8128 | 1692 | When a files is searched and it does not have any of the legal extensions, |
| 70d797cd CD |
1693 | we try the default extension first, and then the naked file name. |
| 1694 | ||
| 1695 | If you are using AUCTeX, you also need to add new extensions to | |
| 1696 | TeX-file-extensions." | |
| 1a9461d0 CD |
1697 | :group 'reftex-finding-files |
| 1698 | :type '(repeat (cons (string :tag "File type") | |
| 3666daf6 | 1699 | (repeat (string :tag "Extension"))))) |
| 1a9461d0 | 1700 | |
| ea2a0e35 CD |
1701 | (defcustom reftex-try-all-extensions nil |
| 1702 | "Non-nil means, try all extensions listed in `reftex-file-extensions'. | |
| 1703 | When searching for a file, LaTeX uses only the default extension. However, | |
| 1704 | if you are working with a noweb system that produces the .tex files from | |
| 1705 | some other file, and you want RefTeX to scan the web file instead of the | |
| 1706 | tex file, you need to set this option. You also need to make the noweb | |
| 1707 | extension the default extension, i.e. the first in the list in | |
| 1708 | `reftex-file-extensions'. | |
| 1709 | Note that if you are using external file finders, this option has no effect." | |
| 1710 | :group 'reftex-finding-files | |
| 1711 | :type 'boolean) | |
| 1712 | ||
| 1a9461d0 | 1713 | (defcustom reftex-search-unrecursed-path-first t |
| fb7ada5f | 1714 | "Non-nil means, search all specified directories before trying recursion. |
| 1a9461d0 CD |
1715 | Thus, in a path \".//:/tex/\", search first \"./\", then \"/tex/\" and then |
| 1716 | all subdirectories of \"./\". If this option is nil, the subdirectories of | |
| c8de140b | 1717 | \"./\" are searched before \"/tex/\". This is mainly for speed - most of the |
| 1a9461d0 CD |
1718 | time the recursive path is for the system files and not for the user files. |
| 1719 | Set this to nil if the default makes RefTeX finding files with equal names | |
| 1720 | in wrong sequence." | |
| 1721 | :group 'reftex-finding-files | |
| 1722 | :type 'boolean) | |
| 1723 | ||
| 1724 | (defcustom reftex-use-external-file-finders nil | |
| fb7ada5f | 1725 | "Non-nil means, use external programs to find files. |
| 1a9461d0 CD |
1726 | Normally, RefTeX searches the paths given in the environment variables |
| 1727 | TEXINPUTS and BIBINPUTS to find TeX files and BibTeX database files. | |
| 1728 | With this option turned on, it calls an external program specified in the | |
| 1729 | option `reftex-external-file-finders' instead. As a side effect, | |
| c8de140b | 1730 | the variables `reftex-texpath-environment-variables' and |
| 1a9461d0 CD |
1731 | `reftex-bibpath-environment-variables' will be ignored." |
| 1732 | :group 'reftex-finding-files | |
| 1733 | :type 'boolean) | |
| 1734 | ||
| 1735 | (defcustom reftex-external-file-finders '(("tex" . "kpsewhich -format=.tex %f") | |
| 3666daf6 | 1736 | ("bib" . "kpsewhich -format=.bib %f")) |
| fb7ada5f | 1737 | "Association list with external programs to call for finding files. |
| 1a9461d0 CD |
1738 | Each entry is a cons cell (TYPE . PROGRAM). |
| 1739 | TYPE is either \"tex\" or \"bib\". PROGRAM is the external program to use with | |
| 1740 | any arguments. %f will be replaced by the name of the file to be found. | |
| 1741 | Note that these commands will be executed directly, not via a shell. | |
| 1742 | Only relevant when `reftex-use-external-file-finders' is non-nil." | |
| 1743 | :group 'reftex-finding-files | |
| 1744 | :type '(repeat (cons (string :tag "File type") | |
| 3666daf6 | 1745 | (string :tag "Program ")))) |
| 1a9461d0 CD |
1746 | |
| 1747 | ;; Tuning the parser ---------------------------------------------------- | |
| 1748 | ||
| 1749 | (defgroup reftex-optimizations-for-large-documents nil | |
| 1750 | "Configuration of parser speed and memory usage." | |
| 1751 | :group 'reftex) | |
| 1752 | ||
| 1753 | (defcustom reftex-keep-temporary-buffers 1 | |
| fb7ada5f | 1754 | "Non-nil means, keep buffers created for parsing and lookup. |
| 1a9461d0 CD |
1755 | RefTeX sometimes needs to visit files related to the current document. |
| 1756 | We distinguish files visited for | |
| 1757 | PARSING: Parts of a multifile document loaded when (re)-parsing the document. | |
| 1758 | LOOKUP: BibTeX database files and TeX files loaded to find a reference, | |
| 1759 | to display label context, etc. | |
| 1760 | The created buffers can be kept for later use, or be thrown away immediately | |
| 1761 | after use, depending on the value of this variable: | |
| 1762 | ||
| 1763 | nil Throw away as much as possible. | |
| 1764 | t Keep everything. | |
| 1765 | 1 Throw away buffers created for parsing, but keep the ones created | |
| 1766 | for lookup. | |
| 1767 | ||
| 1768 | If a buffer is to be kept, the file is visited normally (which is potentially | |
| 1769 | slow but will happen only once). | |
| 1770 | If a buffer is to be thrown away, the initialization of the buffer depends | |
| 1771 | upon the variable `reftex-initialize-temporary-buffers'." | |
| 1772 | :group 'reftex-optimizations-for-large-documents | |
| 1773 | :type '(choice | |
| 1774 | (const :tag "Throw away everything" nil) | |
| 1775 | (const :tag "Keep everything" t) | |
| 1776 | (const :tag "Keep lookup buffers only" 1))) | |
| 1777 | ||
| 1778 | (defcustom reftex-initialize-temporary-buffers nil | |
| fb7ada5f | 1779 | "Non-nil means do initializations even when visiting file temporarily. |
| 1a9461d0 CD |
1780 | When nil, RefTeX may turn off find-file hooks and other stuff to briefly |
| 1781 | visit a file. | |
| 1782 | When t, the full default initializations are done (find-file-hook etc.). | |
| 1783 | Instead of t or nil, this variable may also be a list of hook functions to | |
| 1784 | do a minimal initialization." | |
| 1785 | :group 'reftex-optimizations-for-large-documents | |
| 1786 | :type '(choice | |
| 1787 | (const :tag "Read files literally" nil) | |
| 1788 | (const :tag "Fully initialize buffers" t) | |
| 1789 | (repeat :tag "Hook functions" :value (nil) | |
| 1790 | (function-item)))) | |
| 1791 | ||
| 1792 | (defcustom reftex-no-include-regexps '("\\.pstex_t\\'") | |
| fb7ada5f | 1793 | "List of regular expressions to exclude certain input files from parsing. |
| 1a9461d0 CD |
1794 | If the name of a file included via \\include or \\input is matched by any |
| 1795 | of the regular expressions in this list, that file is not parsed by RefTeX." | |
| 1796 | :group 'reftex-optimizations-for-large-documents | |
| 1797 | :type '(repeat (regexp))) | |
| 1798 | ||
| 1799 | (defcustom reftex-enable-partial-scans nil | |
| fb7ada5f | 1800 | "Non-nil means, re-parse only 1 file when asked to re-parse. |
| 1a9461d0 CD |
1801 | Re-parsing is normally requested with a `C-u' prefix to many RefTeX commands, |
| 1802 | or with the `r' key in menus. When this option is t in a multifile document, | |
| 1803 | we will only parse the current buffer, or the file associated with the label | |
| 1804 | or section heading near point in a menu. Requesting re-parsing of an entire | |
| 1805 | multifile document then requires a `C-u C-u' prefix or the capital `R' key | |
| 1806 | in menus." | |
| 1807 | :group 'reftex-optimizations-for-large-documents | |
| 1808 | :type 'boolean) | |
| 1809 | ||
| 1810 | (defcustom reftex-allow-automatic-rescan t | |
| fb7ada5f | 1811 | "Non-nil means, RefTeX may rescan the document when this seems necessary. |
| 1a9461d0 CD |
1812 | Currently this applies only to rescanning after label insertion, when |
| 1813 | the new label cannot be inserted correctly into the internal label | |
| 1814 | list." | |
| 1815 | :group 'reftex-optimizations-for-large-documents | |
| 1816 | :type 'boolean) | |
| 1817 | ||
| 1818 | (defcustom reftex-save-parse-info nil | |
| fb7ada5f | 1819 | "Non-nil means, save information gathered with parsing in a file. |
| 1a9461d0 | 1820 | The file MASTER.rel in the same directory as MASTER.tex is used to save the |
| c8de140b | 1821 | information. When this variable is t, |
| 1a9461d0 CD |
1822 | - accessing the parsing information for the first time in an editing session |
| 1823 | will read that file (if available) instead of parsing the document. | |
| 4f595e15 | 1824 | - exiting Emacs or killing a buffer in `reftex-mode' will cause a new version |
| 1a9461d0 CD |
1825 | of the file to be written." |
| 1826 | :group 'reftex-optimizations-for-large-documents | |
| 1827 | :type 'boolean) | |
| 1828 | ||
| 9f286482 | 1829 | (defcustom reftex-parse-file-extension ".rel" |
| fb7ada5f | 1830 | "File extension for the file in which parser information is stored. |
| 9f286482 CD |
1831 | This extension is added to the base name of the master file." |
| 1832 | :group 'reftex-optimizations-for-large-documents | |
| 1833 | :type 'string) | |
| 1834 | ||
| 1a9461d0 | 1835 | (defcustom reftex-use-multiple-selection-buffers nil |
| fb7ada5f | 1836 | "Non-nil means use a separate selection buffer for each label type. |
| 1a9461d0 CD |
1837 | These buffers are kept from one selection to the next and need not to be |
| 1838 | created for each use - so the menu generally comes up faster. The | |
| 1839 | selection buffers will be erased (and therefore updated) automatically | |
| 1840 | when new labels in its category are added. See the variable | |
| 1841 | `reftex-auto-update-selection-buffers'." | |
| 1842 | :group 'reftex-optimizations-for-large-documents | |
| 1843 | :group 'reftex-referencing-labels | |
| 1844 | :type 'boolean) | |
| 1845 | ||
| 1846 | (defcustom reftex-auto-update-selection-buffers t | |
| fb7ada5f | 1847 | "Non-nil means, selection buffers will be updated automatically. |
| 1a9461d0 CD |
1848 | When a new label is defined with `reftex-label', all selection buffers |
| 1849 | associated with that label category are emptied, in order to force an | |
| 1850 | update upon next use. When nil, the buffers are left alone and have to be | |
| 1851 | updated by hand, with the `g' key from the label selection process. | |
| 1852 | The value of this variable will only have any effect when | |
| 1853 | `reftex-use-multiple-selection-buffers' is non-nil." | |
| 1854 | :group 'reftex-optimizations-for-large-documents | |
| 1855 | :group 'reftex-referencing-labels | |
| 1856 | :type 'boolean) | |
| 1857 | ||
| 1858 | ;; Fontification and Faces ---------------------------------------------- | |
| 1859 | ||
| 1860 | (defgroup reftex-fontification-configurations nil | |
| 1861 | "Options concerning the faces used in RefTeX." | |
| 8ec3bce0 | 1862 | :link '(custom-group-link :tag "Font Lock Faces group" font-lock-faces) |
| 1a9461d0 CD |
1863 | :group 'reftex) |
| 1864 | ||
| 1865 | (defcustom reftex-use-fonts t | |
| fb7ada5f | 1866 | "Non-nil means, use fonts in *toc* and selection buffers. |
| 1a9461d0 CD |
1867 | Font-lock must be loaded as well to actually get fontified display. |
| 1868 | When changing this option, a rescan may be necessary to activate the change." | |
| 1869 | :group 'reftex-fontification-configurations | |
| 1870 | :type 'boolean) | |
| 1871 | ||
| 1872 | (defcustom reftex-refontify-context 1 | |
| fb7ada5f | 1873 | "Non-nil means, re-fontify the context in the label menu with font-lock. |
| 1a9461d0 CD |
1874 | This slightly slows down the creation of the label menu. It is only necessary |
| 1875 | when you definitely want the context fontified. | |
| 1876 | ||
| 1877 | This option may have 3 different values: | |
| 1878 | nil Never refontify. | |
| 1879 | t Always refontify. | |
| 1880 | 1 Refontify when absolutely necessary, e.g. when old versions of X-Symbol. | |
| 1881 | The option is ignored when `reftex-use-fonts' is nil." | |
| 1882 | :group 'reftex-fontification-configurations | |
| 1883 | :group 'reftex-referencing-labels | |
| 1884 | :type '(choice | |
| 1885 | (const :tag "Never" nil) | |
| 1886 | (const :tag "Always" t) | |
| 1887 | (const :tag "When necessary" 1))) | |
| 1888 | ||
| 1889 | (defcustom reftex-highlight-selection 'cursor | |
| fb7ada5f | 1890 | "Non-nil mean, highlight selected text in selection and *toc* buffers. |
| 1a9461d0 | 1891 | Normally, the text near the cursor is the selected text, and it is |
| 9858f6c3 | 1892 | highlighted. This is the entry most keys in the selection and *toc* |
| 1a9461d0 CD |
1893 | buffers act on. However, if you mainly use the mouse to select an |
| 1894 | item, you may find it nice to have mouse-triggered highlighting | |
| c8de140b | 1895 | instead or as well. The variable may have one of these values: |
| 1a9461d0 CD |
1896 | |
| 1897 | nil No highlighting. | |
| 1898 | cursor Highlighting is cursor driven. | |
| 1899 | mouse Highlighting is mouse driven. | |
| 1900 | both Both cursor and mouse trigger highlighting. | |
| 1901 | ||
| 1902 | Changing this variable requires to rebuild the selection and *toc* buffers | |
| 1903 | to become effective (keys `g' or `r')." | |
| 1904 | :group 'reftex-fontification-configurations | |
| 1905 | :type '(choice | |
| 3666daf6 CD |
1906 | (const :tag "Never" nil) |
| 1907 | (const :tag "Cursor driven" cursor) | |
| 1908 | (const :tag "Mouse driven" mouse) | |
| 1909 | (const :tag "Mouse and Cursor driven." both))) | |
| 1a9461d0 CD |
1910 | |
| 1911 | (defcustom reftex-cursor-selected-face 'highlight | |
| 1912 | "Face name to highlight cursor selected item in toc and selection buffers. | |
| 1913 | See also the variable `reftex-highlight-selection'." | |
| 1914 | :group 'reftex-fontification-configurations | |
| 1915 | :type 'symbol) | |
| 1916 | (defcustom reftex-mouse-selected-face 'secondary-selection | |
| 1917 | "Face name to highlight mouse selected item in toc and selection buffers. | |
| 1918 | See also the variable `reftex-highlight-selection'." | |
| 1919 | :group 'reftex-fontification-configurations | |
| 1920 | :type 'symbol) | |
| 1921 | (defcustom reftex-file-boundary-face 'font-lock-comment-face | |
| 1922 | "Face name for file boundaries in selection buffer." | |
| 1923 | :group 'reftex-fontification-configurations | |
| 1924 | :type 'symbol) | |
| 1925 | (defcustom reftex-label-face 'font-lock-constant-face | |
| 1926 | "Face name for labels in selection buffer." | |
| 1927 | :group 'reftex-fontification-configurations | |
| 1928 | :type 'symbol) | |
| 1929 | (defcustom reftex-section-heading-face 'font-lock-function-name-face | |
| 1930 | "Face name for section headings in toc and selection buffers." | |
| 1931 | :group 'reftex-fontification-configurations | |
| 1932 | :type 'symbol) | |
| 1933 | (defcustom reftex-toc-header-face 'font-lock-comment-face | |
| 1934 | "Face name for the header of a toc buffer." | |
| 1935 | :group 'reftex-fontification-configurations | |
| 1936 | :type 'symbol) | |
| 1937 | (defcustom reftex-bib-author-face 'font-lock-keyword-face | |
| 1938 | "Face name for author names in bib selection buffer." | |
| 1939 | :group 'reftex-fontification-configurations | |
| 1940 | :type 'symbol) | |
| 1941 | (defcustom reftex-bib-year-face 'font-lock-comment-face | |
| 1942 | "Face name for year in bib selection buffer." | |
| 1943 | :group 'reftex-fontification-configurations | |
| 1944 | :type 'symbol) | |
| 1945 | (defcustom reftex-bib-title-face 'font-lock-function-name-face | |
| 1946 | "Face name for article title in bib selection buffer." | |
| 1947 | :group 'reftex-fontification-configurations | |
| 1948 | :type 'symbol) | |
| 1949 | (defcustom reftex-bib-extra-face 'font-lock-comment-face | |
| 1950 | "Face name for bibliographic information in bib selection buffer." | |
| 1951 | :group 'reftex-fontification-configurations | |
| 1952 | :type 'symbol) | |
| 1953 | (defcustom reftex-select-mark-face 'bold | |
| 1954 | "Face name for marked entries in the selection buffers." | |
| 1955 | :group 'reftex-fontification-configurations | |
| 1956 | :type 'symbol) | |
| 1957 | (defcustom reftex-index-header-face 'font-lock-comment-face | |
| 1958 | "Face name for the header of an index buffer." | |
| 1959 | :group 'reftex-fontification-configurations | |
| 1960 | :type 'symbol) | |
| 1961 | (defcustom reftex-index-section-face 'font-lock-function-name-face | |
| 1962 | "Face name for the start of a new letter section in the index." | |
| 1963 | :group 'reftex-fontification-configurations | |
| 1964 | :type 'symbol) | |
| 1965 | (defcustom reftex-index-tag-face 'font-lock-keyword-face | |
| 1966 | "Face name for index names (for multiple indices)." | |
| 1967 | :group 'reftex-fontification-configurations | |
| 1968 | :type 'symbol) | |
| 1969 | (defcustom reftex-index-face 'font-lock-constant-face | |
| 1970 | "Face name for index entries." | |
| 1971 | :group 'reftex-fontification-configurations | |
| 1972 | :type 'symbol) | |
| 1973 | ||
| 1974 | (defcustom reftex-pre-refontification-functions nil | |
| 1975 | "X-Symbol specific hook. | |
| 1976 | Functions get two arguments, the buffer from where the command started and a | |
| 1977 | symbol indicating in what context the hook is called." | |
| 1978 | :group 'reftex-fontification-configurations | |
| 1979 | :type 'hook) | |
| 1980 | ||
| 1981 | ;; Miscellaneous configurations ----------------------------------------- | |
| 1982 | ||
| 1983 | (defgroup reftex-miscellaneous-configurations nil | |
| 1984 | "Collection of further configurations." | |
| 1985 | :group 'reftex) | |
| 1986 | ||
| 1987 | (defcustom reftex-extra-bindings nil | |
| 1988 | "Non-nil means, make additional key bindings on startup. | |
| 4f595e15 | 1989 | These extra bindings are located in the users `C-c letter' map." |
| 1a9461d0 CD |
1990 | :group 'reftex-miscellaneous-configurations |
| 1991 | :type 'boolean) | |
| 1992 | ||
| 1993 | (defcustom reftex-plug-into-AUCTeX nil | |
| fb7ada5f | 1994 | "Plug-in flags for AUCTeX interface. |
| 4f595e15 | 1995 | This variable is a list of 5 boolean flags. When a flag is non-nil, |
| 1a9461d0 CD |
1996 | RefTeX will |
| 1997 | ||
| 1998 | - supply labels in new sections and environments (flag 1) | |
| 1999 | - supply arguments for macros like `\\label'. (flag 2) | |
| 2000 | - supply arguments for macros like `\\ref'. (flag 3) | |
| 2001 | - supply arguments for macros like `\\cite'. (flag 4) | |
| 2002 | - supply arguments for macros like `\\index'. (flag 5) | |
| 2003 | ||
| 2004 | You may also set the variable itself to t or nil in order to turn all | |
| 2005 | plug-ins on or off, respectively. | |
| 2006 | \\<LaTeX-mode-map>Supplying labels in new sections and environments applies when creating | |
| 2007 | sections with \\[LaTeX-section] and environments with \\[LaTeX-environment]. | |
| 2008 | Supplying macro arguments applies when you insert such a macro interactively | |
| 2009 | with \\[TeX-insert-macro]. | |
| 2010 | See the AUCTeX documentation for more information. | |
| 2011 | RefTeX uses `fset' to take over the function calls. Changing the variable | |
| 2012 | may require a restart of Emacs in order to become effective." | |
| 2013 | :group 'reftex-miscellaneous-configurations | |
| 2014 | :group 'LaTeX | |
| c8de140b | 2015 | :type '(choice |
| 3666daf6 CD |
2016 | (const :tag "No plug-ins" nil) |
| 2017 | (const :tag "All possible plug-ins" t) | |
| 2018 | (list | |
| 2019 | :tag "Individual choice" | |
| 2020 | :value (t t t t t) | |
| 2021 | (boolean :tag "supply label in new sections and environments") | |
| 2022 | (boolean :tag "supply argument for macros like `\\label' ") | |
| 2023 | (boolean :tag "supply argument for macros like `\\ref' ") | |
| 2024 | (boolean :tag "supply argument for macros like `\\cite' ") | |
| 4f595e15 | 2025 | (boolean :tag "supply argument for macros like `\\index' ")))) |
| 1a9461d0 CD |
2026 | |
| 2027 | (defcustom reftex-allow-detached-macro-args nil | |
| fb7ada5f | 2028 | "Non-nil means, allow arguments of macros to be detached by whitespace. |
| 1a9461d0 CD |
2029 | When this is t, `aaa' will be considered as argument of \\bb in the following |
| 2030 | construct: \\bbb [xxx] {aaa}." | |
| 2031 | :group 'reftex-miscellaneous-configurations | |
| 2032 | :type 'boolean) | |
| 2033 | ||
| 2034 | ||
| 2035 | (defcustom reftex-load-hook nil | |
| 2036 | "Hook which is being run when loading reftex.el." | |
| 2037 | :group 'reftex-miscellaneous-configurations | |
| 2038 | :type 'hook) | |
| 2039 | ||
| 2040 | (defcustom reftex-mode-hook nil | |
| 2041 | "Hook which is being run when turning on RefTeX mode." | |
| 2042 | :group 'reftex-miscellaneous-configurations | |
| 2043 | :type 'hook) | |
| 2044 | ||
| 3666daf6 | 2045 | |
| f541b8c6 MR |
2046 | (provide 'reftex-vars) |
| 2047 | ||
| 1a9461d0 | 2048 | ;;; reftex-vars.el ends here |