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