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