annotate man/reftex.texi @ 70387:a995a8745b40

*** empty log message ***
author YAMAMOTO Mitsuharu <mituharu@math.s.chiba-u.ac.jp>
date Fri, 05 May 2006 06:45:26 +0000
parents 11b616eddda4
children b7261e09f8e4 e6bf73e43cf4
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
Dave Love <fx@gnu.org>
parents:
diff changeset
2 @c %**start of header
59538
87ebb131f763 corrected setfilename
Carsten Dominik <dominik@science.uva.nl>
parents: 59536
diff changeset
3 @setfilename ../info/reftex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4 @settitle RefTeX User Manual
Dave Love <fx@gnu.org>
parents:
diff changeset
5 @synindex ky cp
Dave Love <fx@gnu.org>
parents:
diff changeset
6 @syncodeindex vr cp
Dave Love <fx@gnu.org>
parents:
diff changeset
7 @syncodeindex fn cp
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
8
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
9 @c Version and Contact Info
69095
10ad7754be93 Version number and date change only.
Carsten Dominik <dominik@science.uva.nl>
parents: 68639
diff changeset
10 @set VERSION 4.31
10ad7754be93 Version number and date change only.
Carsten Dominik <dominik@science.uva.nl>
parents: 68639
diff changeset
11 @set EDITION 4.31
10ad7754be93 Version number and date change only.
Carsten Dominik <dominik@science.uva.nl>
parents: 68639
diff changeset
12 @set DATE February 2006
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
13 @set AUCTEXSITE @uref{http://www.nongnu.org/auctex/,AUCTeX distribution site}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
14 @set MAINTAINERSITE @uref{http://www.astro.uva.nl/~dominik/Tools/,maintainers webpage}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
15 @set MAINTAINER Carsten Dominik
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
16 @set MAINTAINEREMAIL @email{dominik@@science.uva.nl}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
17 @set MAINTAINERCONTACT @uref{mailto:dominik@@science.uva.nl,contact the maintainer}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
18 @set XEMACSFTP @uref{ftp://ftp.xemacs.org/pub/xemacs/packages/,XEmacs ftp site}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
19 @c %**end of header
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
20
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
21 @copying
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
22 This file documents @b{Ref@TeX{}}, a package to do labels, references,
47737
0a70200bde27 use @copying instead of @ifinfo.
Karl Berry <karl@gnu.org>
parents: 47050
diff changeset
23 citations and indices for LaTeX documents with Emacs.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
24
Dave Love <fx@gnu.org>
parents:
diff changeset
25 This is edition @value{EDITION} of the @b{Ref@TeX{}} User Manual for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
26 @b{Ref@TeX{}} @value{VERSION}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
27
69681
11b616eddda4 @copyright{}, no indentation in @copying{}
Karl Berry <karl@gnu.org>
parents: 69095
diff changeset
28 Copyright @copyright{} 1997, 1998, 1999, 2000, 2001, 2002, 2004, 2005
11b616eddda4 @copyright{}, no indentation in @copying{}
Karl Berry <karl@gnu.org>
parents: 69095
diff changeset
29 Free Software Foundation, Inc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
30
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
31 @quotation
37404
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
32 Permission is granted to copy, distribute and/or modify this document
65555
69b3598a61c5 Update all manuals to specify GFDL version 1.2.
Romain Francoise <romain@orebokech.com>
parents: 65550
diff changeset
33 under the terms of the GNU Free Documentation License, Version 1.2 or
37404
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
34 any later version published by the Free Software Foundation; with no
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
35 Invariant Sections, with the Front-Cover texts being ``A GNU
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
36 Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
37 license is included in the section entitled ``GNU Free Documentation
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
38 License'' in the Emacs manual.
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
39
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
40 (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
41 this GNU Manual, like GNU software. Copies published by the Free
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
42 Software Foundation raise funds for GNU development.''
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
43
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
44 This document is part of a collection distributed under the GNU Free
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
45 Documentation License. If you want to distribute this document
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
46 separately from the collection, you can do so by adding a copy of the
730f77edf073 Use GNU Free Documentation License.
Gerd Moellmann <gerd@gnu.org>
parents: 37038
diff changeset
47 license to the document, as described in section 6 of the license.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
48 @end quotation
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
49 @end copying
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
50
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
51 @dircategory Emacs
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
52 @direntry
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
53 * RefTeX: (reftex). Emacs support for LaTeX cross-references and citations.
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
54 @end direntry
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
55
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
56 @finalout
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
57
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
58 @c Macro definitions
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
59
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
60 @c Subheadings inside a table. Need a difference between info and the rest.
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
61 @macro tablesubheading{text}
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
62 @ifinfo
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
63 @subsubheading \text\
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
64 @end ifinfo
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
65 @ifnotinfo
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
66 @item @b{\text\}
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
67 @end ifnotinfo
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
68 @end macro
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
69
Dave Love <fx@gnu.org>
parents:
diff changeset
70 @titlepage
Dave Love <fx@gnu.org>
parents:
diff changeset
71 @title Ref@TeX{} User Manual
Dave Love <fx@gnu.org>
parents:
diff changeset
72 @subtitle Support for LaTeX labels, references, citations and index entries with GNU Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
73 @subtitle Edition @value{EDITION}, @value{DATE}
Dave Love <fx@gnu.org>
parents:
diff changeset
74
Dave Love <fx@gnu.org>
parents:
diff changeset
75 @author by Carsten Dominik
Dave Love <fx@gnu.org>
parents:
diff changeset
76 @page
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
77 @vskip 0pt plus 1filll
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
78 @insertcopying
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
79 @end titlepage
Dave Love <fx@gnu.org>
parents:
diff changeset
80
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
81 @ifnottex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
82 @node Top,,,(dir)
Dave Love <fx@gnu.org>
parents:
diff changeset
83
Dave Love <fx@gnu.org>
parents:
diff changeset
84 @b{Ref@TeX{}} is a package for managing Labels, References,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
85 Citations and index entries with GNU Emacs.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
86
Dave Love <fx@gnu.org>
parents:
diff changeset
87 Don't be discouraged by the size of this manual, which covers
Dave Love <fx@gnu.org>
parents:
diff changeset
88 @b{Ref@TeX{}} in great depth. All you need to know to use
Dave Love <fx@gnu.org>
parents:
diff changeset
89 @b{Ref@TeX{}} can be summarized on two pages (@pxref{RefTeX in a
Dave Love <fx@gnu.org>
parents:
diff changeset
90 Nutshell}). You can go back later to other parts of this document when
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
91 needed.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
92
Dave Love <fx@gnu.org>
parents:
diff changeset
93 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
94 * Introduction:: Quick-Start information.
Dave Love <fx@gnu.org>
parents:
diff changeset
95
Dave Love <fx@gnu.org>
parents:
diff changeset
96 * Table of Contents:: A Tool to move around quickly.
Dave Love <fx@gnu.org>
parents:
diff changeset
97 * Labels and References:: Creating and referencing labels.
Dave Love <fx@gnu.org>
parents:
diff changeset
98 * Citations:: Creating Citations.
Dave Love <fx@gnu.org>
parents:
diff changeset
99 * Index Support:: Creating and Checking Index Entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
100 * Viewing Cross-References:: Who references or cites what?
Dave Love <fx@gnu.org>
parents:
diff changeset
101
Dave Love <fx@gnu.org>
parents:
diff changeset
102 * RefTeXs Menu:: The Ref menu in the menubar.
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
103 * Key Bindings:: The default key bindings.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
104 * Faces:: Fontification of RefTeX's buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
105 * Multifile Documents:: Document spread over many files.
Dave Love <fx@gnu.org>
parents:
diff changeset
106 * Language Support:: How to support other languages.
Dave Love <fx@gnu.org>
parents:
diff changeset
107 * Finding Files:: Included TeX files and BibTeX .bib files.
Dave Love <fx@gnu.org>
parents:
diff changeset
108 * AUCTeX:: Cooperation with AUCTeX.
Dave Love <fx@gnu.org>
parents:
diff changeset
109 * Optimizations:: When RefTeX is too slow.
Dave Love <fx@gnu.org>
parents:
diff changeset
110 * Problems and Work-Arounds:: First Aid.
Dave Love <fx@gnu.org>
parents:
diff changeset
111 * Imprint:: Author, Web-site, Thanks
Dave Love <fx@gnu.org>
parents:
diff changeset
112
Dave Love <fx@gnu.org>
parents:
diff changeset
113 * Commands:: Which are the available commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
114 * Options:: How to extend and configure RefTeX.
Dave Love <fx@gnu.org>
parents:
diff changeset
115 * Keymaps and Hooks:: For customization.
Dave Love <fx@gnu.org>
parents:
diff changeset
116 * Changes:: A List of recent changes to RefTeX.
Dave Love <fx@gnu.org>
parents:
diff changeset
117
Dave Love <fx@gnu.org>
parents:
diff changeset
118 The Index
Dave Love <fx@gnu.org>
parents:
diff changeset
119
Dave Love <fx@gnu.org>
parents:
diff changeset
120 * Index:: The full index.
Dave Love <fx@gnu.org>
parents:
diff changeset
121
Dave Love <fx@gnu.org>
parents:
diff changeset
122 @detailmenu
Dave Love <fx@gnu.org>
parents:
diff changeset
123
Dave Love <fx@gnu.org>
parents:
diff changeset
124 Introduction
Dave Love <fx@gnu.org>
parents:
diff changeset
125
Dave Love <fx@gnu.org>
parents:
diff changeset
126 * Installation:: How to install and activate RefTeX.
Dave Love <fx@gnu.org>
parents:
diff changeset
127 * RefTeX in a Nutshell:: A brief summary and quick guide.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
128
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
129 Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
130
Dave Love <fx@gnu.org>
parents:
diff changeset
131 * Creating Labels::
Dave Love <fx@gnu.org>
parents:
diff changeset
132 * Referencing Labels::
Dave Love <fx@gnu.org>
parents:
diff changeset
133 * Builtin Label Environments:: The environments RefTeX knows about.
Dave Love <fx@gnu.org>
parents:
diff changeset
134 * Defining Label Environments:: ... and environments it doesn't.
Dave Love <fx@gnu.org>
parents:
diff changeset
135 * Reference Info:: View the label corresponding to a \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
136 * xr (LaTeX package):: References to external documents.
Dave Love <fx@gnu.org>
parents:
diff changeset
137 * varioref (LaTeX package):: How to create \vref instead of \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
138 * fancyref (LaTeX package):: How to create \fref instead of \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
139
Dave Love <fx@gnu.org>
parents:
diff changeset
140 Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
141
Dave Love <fx@gnu.org>
parents:
diff changeset
142 * Theorem and Axiom:: Defined with @code{\newenvironment}.
Dave Love <fx@gnu.org>
parents:
diff changeset
143 * Quick Equation:: When a macro sets the label type.
Dave Love <fx@gnu.org>
parents:
diff changeset
144 * Figure Wrapper:: When a macro argument is a label.
Dave Love <fx@gnu.org>
parents:
diff changeset
145 * Adding Magic Words:: Other words for other languages.
Dave Love <fx@gnu.org>
parents:
diff changeset
146 * Using \eqref:: How to switch to this AMS-LaTeX macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
147 * Non-Standard Environments:: Environments without \begin and \end
Dave Love <fx@gnu.org>
parents:
diff changeset
148 * Putting it Together:: How to combine many entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
149
Dave Love <fx@gnu.org>
parents:
diff changeset
150 Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
151
Dave Love <fx@gnu.org>
parents:
diff changeset
152 * Creating Citations:: How to create them.
Dave Love <fx@gnu.org>
parents:
diff changeset
153 * Citation Styles:: Natbib, Harvard, Chicago and Co.
Dave Love <fx@gnu.org>
parents:
diff changeset
154 * Citation Info:: View the corresponding database entry.
Dave Love <fx@gnu.org>
parents:
diff changeset
155 * Chapterbib and Bibunits:: Multiple bibliographies in a Document.
Dave Love <fx@gnu.org>
parents:
diff changeset
156 * Citations Outside LaTeX:: How to make citations in Emails etc.
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
157 * BibTeX Database Subsets:: Extract parts of a big database.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
158
Dave Love <fx@gnu.org>
parents:
diff changeset
159 Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
160
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
161 * Creating Index Entries:: Macros and completion of entries.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
162 * The Index Phrases File:: A special file for global indexing.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
163 * Displaying and Editing the Index:: The index editor.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
164 * Builtin Index Macros:: The index macros RefTeX knows about.
Dave Love <fx@gnu.org>
parents:
diff changeset
165 * Defining Index Macros:: ... and macros it doesn't.
Dave Love <fx@gnu.org>
parents:
diff changeset
166
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
167 The Index Phrases File
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
168
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
169 * Collecting Phrases:: Collecting from document or external.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
170 * Consistency Checks:: Check for duplicates etc.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
171 * Global Indexing:: The interactive indexing process.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
172
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
173 AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
174
Dave Love <fx@gnu.org>
parents:
diff changeset
175 * AUCTeX-RefTeX Interface:: How both packages work together
Dave Love <fx@gnu.org>
parents:
diff changeset
176 * Style Files:: AUCTeX's style files can support RefTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
177 * Bib-Cite:: Hypertext reading of a document
Dave Love <fx@gnu.org>
parents:
diff changeset
178
Dave Love <fx@gnu.org>
parents:
diff changeset
179 Options, Keymaps, Hooks
Dave Love <fx@gnu.org>
parents:
diff changeset
180
Dave Love <fx@gnu.org>
parents:
diff changeset
181 * Options (Table of Contents)::
Dave Love <fx@gnu.org>
parents:
diff changeset
182 * Options (Defining Label Environments)::
Dave Love <fx@gnu.org>
parents:
diff changeset
183 * Options (Creating Labels)::
Dave Love <fx@gnu.org>
parents:
diff changeset
184 * Options (Referencing Labels)::
Dave Love <fx@gnu.org>
parents:
diff changeset
185 * Options (Creating Citations)::
Dave Love <fx@gnu.org>
parents:
diff changeset
186 * Options (Index Support)::
Dave Love <fx@gnu.org>
parents:
diff changeset
187 * Options (Viewing Cross-References)::
Dave Love <fx@gnu.org>
parents:
diff changeset
188 * Options (Finding Files)::
Dave Love <fx@gnu.org>
parents:
diff changeset
189 * Options (Optimizations)::
Dave Love <fx@gnu.org>
parents:
diff changeset
190 * Options (Fontification)::
Dave Love <fx@gnu.org>
parents:
diff changeset
191 * Options (Misc)::
Dave Love <fx@gnu.org>
parents:
diff changeset
192
Dave Love <fx@gnu.org>
parents:
diff changeset
193 @end detailmenu
Dave Love <fx@gnu.org>
parents:
diff changeset
194 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
195
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
196 @end ifnottex
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
197
Dave Love <fx@gnu.org>
parents:
diff changeset
198 @node Introduction, Table of Contents, , Top
Dave Love <fx@gnu.org>
parents:
diff changeset
199 @chapter Introduction
Dave Love <fx@gnu.org>
parents:
diff changeset
200 @cindex Introduction
Dave Love <fx@gnu.org>
parents:
diff changeset
201
Dave Love <fx@gnu.org>
parents:
diff changeset
202 @b{Ref@TeX{}} is a specialized package for support of labels,
Dave Love <fx@gnu.org>
parents:
diff changeset
203 references, citations, and the index in LaTeX. @b{Ref@TeX{}} wraps
Dave Love <fx@gnu.org>
parents:
diff changeset
204 itself round 4 LaTeX macros: @code{\label}, @code{\ref}, @code{\cite},
Dave Love <fx@gnu.org>
parents:
diff changeset
205 and @code{\index}. Using these macros usually requires looking up
Dave Love <fx@gnu.org>
parents:
diff changeset
206 different parts of the document and searching through BibTeX database
Dave Love <fx@gnu.org>
parents:
diff changeset
207 files. @b{Ref@TeX{}} automates these time--consuming tasks almost
Dave Love <fx@gnu.org>
parents:
diff changeset
208 entirely. It also provides functions to display the structure of a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
209 document and to move around in this structure quickly.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
210
Dave Love <fx@gnu.org>
parents:
diff changeset
211 @iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
212 Don't be discouraged by the size of this manual, which covers @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
213 in great depth. All you need to know to use @b{Ref@TeX{}} can be
Dave Love <fx@gnu.org>
parents:
diff changeset
214 summarized on two pages (@pxref{RefTeX in a Nutshell}). You can go
Dave Love <fx@gnu.org>
parents:
diff changeset
215 back later to other parts of this document when needed.
Dave Love <fx@gnu.org>
parents:
diff changeset
216 @end iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
217
Dave Love <fx@gnu.org>
parents:
diff changeset
218 @xref{Imprint}, for information about who to contact for help, bug
Dave Love <fx@gnu.org>
parents:
diff changeset
219 reports or suggestions.
Dave Love <fx@gnu.org>
parents:
diff changeset
220
Dave Love <fx@gnu.org>
parents:
diff changeset
221 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
222 * Installation:: How to install and activate RefTeX.
Dave Love <fx@gnu.org>
parents:
diff changeset
223 * RefTeX in a Nutshell:: A brief summary and quick guide.
Dave Love <fx@gnu.org>
parents:
diff changeset
224 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
225
Dave Love <fx@gnu.org>
parents:
diff changeset
226 @node Installation, RefTeX in a Nutshell, , Introduction
Dave Love <fx@gnu.org>
parents:
diff changeset
227 @section Installation
Dave Love <fx@gnu.org>
parents:
diff changeset
228 @cindex Installation
Dave Love <fx@gnu.org>
parents:
diff changeset
229
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
230 @b{Ref@TeX{}} is bundled and pre--installed with Emacs since version
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
231 20.2. It was also bundled and pre--installed with XEmacs 19.16--20.x.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
232 XEmacs 21.x users want to install the corresponding plug-in package
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
233 which is available from the @value{XEMACSFTP}. See the XEmacs 21.x
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
234 documentation on package installation for details.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
235
Dave Love <fx@gnu.org>
parents:
diff changeset
236 Users of earlier Emacs distributions (including Emacs 19) can get a copy
Dave Love <fx@gnu.org>
parents:
diff changeset
237 of the @b{Ref@TeX{}} distribution from the maintainers web-page.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
238 @xref{Imprint}, for more information.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
239
Dave Love <fx@gnu.org>
parents:
diff changeset
240 @section Environment
Dave Love <fx@gnu.org>
parents:
diff changeset
241 @cindex Finding files
Dave Love <fx@gnu.org>
parents:
diff changeset
242 @cindex BibTeX database files, not found
Dave Love <fx@gnu.org>
parents:
diff changeset
243 @cindex TeX files, not found
Dave Love <fx@gnu.org>
parents:
diff changeset
244 @cindex @code{TEXINPUTS}, environment variable
Dave Love <fx@gnu.org>
parents:
diff changeset
245 @cindex @code{BIBINPUTS}, environment variable
Dave Love <fx@gnu.org>
parents:
diff changeset
246
Dave Love <fx@gnu.org>
parents:
diff changeset
247 @b{Ref@TeX{}} needs to access all files which are part of a multifile
Dave Love <fx@gnu.org>
parents:
diff changeset
248 document, and the BibTeX database files requested by the
Dave Love <fx@gnu.org>
parents:
diff changeset
249 @code{\bibliography} command. To find these files, @b{Ref@TeX{}} will
Dave Love <fx@gnu.org>
parents:
diff changeset
250 require a search path, i.e. a list of directories to check. Normally
Dave Love <fx@gnu.org>
parents:
diff changeset
251 this list is stored in the environment variables @code{TEXINPUTS} and
Dave Love <fx@gnu.org>
parents:
diff changeset
252 @code{BIBINPUTS} which are also used by @b{Ref@TeX{}}. However, on some
Dave Love <fx@gnu.org>
parents:
diff changeset
253 systems these variables do not contain the full search path. If
Dave Love <fx@gnu.org>
parents:
diff changeset
254 @b{Ref@TeX{}} does not work for you because it cannot find some files,
Dave Love <fx@gnu.org>
parents:
diff changeset
255 read @ref{Finding Files}.
Dave Love <fx@gnu.org>
parents:
diff changeset
256
Dave Love <fx@gnu.org>
parents:
diff changeset
257 @section Entering @b{Ref@TeX{}} Mode
Dave Love <fx@gnu.org>
parents:
diff changeset
258
Dave Love <fx@gnu.org>
parents:
diff changeset
259 @findex turn-on-reftex
Dave Love <fx@gnu.org>
parents:
diff changeset
260 @findex reftex-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
261 @vindex LaTeX-mode-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
262 @vindex latex-mode-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
263 To turn @b{Ref@TeX{}} Mode on and off in a particular buffer, use
Dave Love <fx@gnu.org>
parents:
diff changeset
264 @kbd{M-x reftex-mode}. To turn on @b{Ref@TeX{}} Mode for all LaTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
265 files, add the following lines to your @file{.emacs} file:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
266
Dave Love <fx@gnu.org>
parents:
diff changeset
267 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
268 (add-hook 'LaTeX-mode-hook 'turn-on-reftex) ; with AUCTeX LaTeX mode
Dave Love <fx@gnu.org>
parents:
diff changeset
269 (add-hook 'latex-mode-hook 'turn-on-reftex) ; with Emacs latex mode
Dave Love <fx@gnu.org>
parents:
diff changeset
270 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
271
Dave Love <fx@gnu.org>
parents:
diff changeset
272 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
273 @node RefTeX in a Nutshell, , Installation, Introduction
Dave Love <fx@gnu.org>
parents:
diff changeset
274 @section @b{Ref@TeX{}} in a Nutshell
Dave Love <fx@gnu.org>
parents:
diff changeset
275 @cindex Quick-Start
Dave Love <fx@gnu.org>
parents:
diff changeset
276 @cindex Getting Started
Dave Love <fx@gnu.org>
parents:
diff changeset
277 @cindex RefTeX in a Nutshell
Dave Love <fx@gnu.org>
parents:
diff changeset
278 @cindex Nutshell, RefTeX in a
Dave Love <fx@gnu.org>
parents:
diff changeset
279
Dave Love <fx@gnu.org>
parents:
diff changeset
280 @enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
281 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
282 @b{Table of Contents}@* Typing @kbd{C-c =} (@code{reftex-toc}) will show
Dave Love <fx@gnu.org>
parents:
diff changeset
283 a table of contents of the document. This buffer can display sections,
Dave Love <fx@gnu.org>
parents:
diff changeset
284 labels and index entries defined in the document. From the buffer, you
Dave Love <fx@gnu.org>
parents:
diff changeset
285 can jump quickly to every part of your document. Press @kbd{?} to get
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
286 help.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
287
Dave Love <fx@gnu.org>
parents:
diff changeset
288 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
289 @b{Labels and References}@* @b{Ref@TeX{}} helps to create unique labels
Dave Love <fx@gnu.org>
parents:
diff changeset
290 and to find the correct key for references quickly. It distinguishes
Dave Love <fx@gnu.org>
parents:
diff changeset
291 labels for different environments, knows about all standard
Dave Love <fx@gnu.org>
parents:
diff changeset
292 environments (and many others), and can be configured to recognize any
Dave Love <fx@gnu.org>
parents:
diff changeset
293 additional labeled environments you have defined yourself (variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
294 @code{reftex-label-alist}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
295
Dave Love <fx@gnu.org>
parents:
diff changeset
296 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
297 @item
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
298 @b{Creating Labels}@*
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
299 Type @kbd{C-c (} (@code{reftex-label}) to insert a label at point.
Dave Love <fx@gnu.org>
parents:
diff changeset
300 @b{Ref@TeX{}} will either
Dave Love <fx@gnu.org>
parents:
diff changeset
301 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
302 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
303 derive a label from context (default for section labels)
Dave Love <fx@gnu.org>
parents:
diff changeset
304 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
305 prompt for a label string (default for figures and tables) or
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
306 @item
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
307 insert a simple label made of a prefix and a number (all other
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
308 environments)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
309 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
310 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
311 Which labels are created how is configurable with the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
312 @code{reftex-insert-label-flags}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
313
Dave Love <fx@gnu.org>
parents:
diff changeset
314 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
315 @b{Referencing Labels}@* To make a reference, type @kbd{C-c )}
Dave Love <fx@gnu.org>
parents:
diff changeset
316 (@code{reftex-reference}). This shows an outline of the document with
Dave Love <fx@gnu.org>
parents:
diff changeset
317 all labels of a certain type (figure, equation,...) and some label
Dave Love <fx@gnu.org>
parents:
diff changeset
318 context. Selecting a label inserts a @code{\ref@{@var{label}@}} macro
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
319 into the original buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
320 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
321
Dave Love <fx@gnu.org>
parents:
diff changeset
322 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
323 @b{Citations}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
324 Typing @kbd{C-c [} (@code{reftex-citation}) will let you specify a
Dave Love <fx@gnu.org>
parents:
diff changeset
325 regular expression to search in current BibTeX database files (as
Dave Love <fx@gnu.org>
parents:
diff changeset
326 specified in the @code{\bibliography} command) and pull out a list of
Dave Love <fx@gnu.org>
parents:
diff changeset
327 matches for you to choose from. The list is @emph{formatted} and
Dave Love <fx@gnu.org>
parents:
diff changeset
328 sorted. The selected article is referenced as @samp{\cite@{@var{key}@}}
Dave Love <fx@gnu.org>
parents:
diff changeset
329 (see the variable @code{reftex-cite-format} if you want to insert
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
330 different macros).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
331
Dave Love <fx@gnu.org>
parents:
diff changeset
332 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
333 @b{Index Support}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
334 @b{Ref@TeX{}} helps to enter index entries. It also compiles all
Dave Love <fx@gnu.org>
parents:
diff changeset
335 entries into an alphabetically sorted @file{*Index*} buffer which you
Dave Love <fx@gnu.org>
parents:
diff changeset
336 can use to check and edit the entries. @b{Ref@TeX{}} knows about the
Dave Love <fx@gnu.org>
parents:
diff changeset
337 standard index macros and can be configured to recognize any additional
Dave Love <fx@gnu.org>
parents:
diff changeset
338 macros you have defined (@code{reftex-index-macros}). Multiple indices
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
339 are supported.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
340
Dave Love <fx@gnu.org>
parents:
diff changeset
341 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
342 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
343 @b{Creating Index Entries}@*
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
344 To index the current selection or the word at point, type @kbd{C-c /}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
345 (@code{reftex-index-selection-or-word}). The default macro
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
346 @code{reftex-index-default-macro} will be used. For a more complex entry
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
347 type @kbd{C-c <} (@code{reftex-index}), select any of the index macros
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
348 and enter the arguments with completion.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
349
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
350 @item
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
351 @b{The Index Phrases File (Delayed Indexing)}@*
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
352 Type @kbd{C-c \} (@code{reftex-index-phrase-selection-or-word}) to add
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
353 the current word or selection to a special @emph{index phrase file}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
354 @b{Ref@TeX{}} can later search the document for occurrences of these
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
355 phrases and let you interactively index the matches.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
356
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
357 @item
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
358 @b{Displaying and Editing the Index}@*
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
359 To display the compiled index in a special buffer, type @kbd{C-c >}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
360 (@code{reftex-display-index}). From that buffer you can check and edit
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
361 all entries.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
362 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
363
Dave Love <fx@gnu.org>
parents:
diff changeset
364 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
365 @item @b{Viewing Cross-References}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
366 When point is on the @var{key} argument of a cross--referencing macro
Dave Love <fx@gnu.org>
parents:
diff changeset
367 (@code{\label}, @code{\ref}, @code{\cite}, @code{\bibitem},
Dave Love <fx@gnu.org>
parents:
diff changeset
368 @code{\index}, and variations) or inside a BibTeX database entry, you
Dave Love <fx@gnu.org>
parents:
diff changeset
369 can press @kbd{C-c &} (@code{reftex-view-crossref}) to display
Dave Love <fx@gnu.org>
parents:
diff changeset
370 corresponding locations in the document and associated BibTeX database
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
371 files. @*
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
372 When the enclosing macro is @code{\cite} or @code{\ref} and no other
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
373 message occupies the echo area, information about the citation or label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
374 will automatically be displayed in the echo area.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
375
Dave Love <fx@gnu.org>
parents:
diff changeset
376 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
377 @b{Multifile Documents}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
378 Multifile Documents are fully supported. The included files must have a
Dave Love <fx@gnu.org>
parents:
diff changeset
379 file variable @code{TeX-master} or @code{tex-main-file} pointing to the
Dave Love <fx@gnu.org>
parents:
diff changeset
380 master file. @b{Ref@TeX{}} provides cross-referencing information from
Dave Love <fx@gnu.org>
parents:
diff changeset
381 all parts of the document, and across document borders
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
382 (@file{xr.sty}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
383
Dave Love <fx@gnu.org>
parents:
diff changeset
384 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
385 @b{Document Parsing}@* @b{Ref@TeX{}} needs to parse the document in
Dave Love <fx@gnu.org>
parents:
diff changeset
386 order to find labels and other information. It does it automatically
Dave Love <fx@gnu.org>
parents:
diff changeset
387 once and updates its list internally when @code{reftex-label} and
Dave Love <fx@gnu.org>
parents:
diff changeset
388 @code{reftex-index} are used. To enforce reparsing, call any of the
Dave Love <fx@gnu.org>
parents:
diff changeset
389 commands described above with a raw @kbd{C-u} prefix, or press the
Dave Love <fx@gnu.org>
parents:
diff changeset
390 @kbd{r} key in the label selection buffer, the table of contents
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
391 buffer, or the index buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
392
Dave Love <fx@gnu.org>
parents:
diff changeset
393 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
394 @b{AUCTeX} @* If your major LaTeX mode is AUCTeX, @b{Ref@TeX{}} can
Dave Love <fx@gnu.org>
parents:
diff changeset
395 cooperate with it (see variable @code{reftex-plug-into-AUCTeX}). AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
396 contains style files which trigger appropriate settings in
Dave Love <fx@gnu.org>
parents:
diff changeset
397 @b{Ref@TeX{}}, so that for many of the popular LaTeX packages no
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
398 additional customizations will be necessary.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
399
Dave Love <fx@gnu.org>
parents:
diff changeset
400 @item
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
401 @b{Useful Settings}@*
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
402 To integrate RefTeX with AUCTeX, use
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
403 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
404 (setq reftex-plug-into-AUCTeX t)
Dave Love <fx@gnu.org>
parents:
diff changeset
405 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
406
Dave Love <fx@gnu.org>
parents:
diff changeset
407 To make your own LaTeX macro definitions known to @b{Ref@TeX{}},
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
408 customize the variables
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
409 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
410 @code{reftex-label-alist} @r{(for label macros/environments)}
Dave Love <fx@gnu.org>
parents:
diff changeset
411 @code{reftex-section-levels} @r{(for sectioning commands)}
Dave Love <fx@gnu.org>
parents:
diff changeset
412 @code{reftex-cite-format} @r{(for @code{\cite}-like macros)}
Dave Love <fx@gnu.org>
parents:
diff changeset
413 @code{reftex-index-macros} @r{(for @code{\index}-like macros)}
Dave Love <fx@gnu.org>
parents:
diff changeset
414 @code{reftex-index-default-macro} @r{(to set the default macro)}
Dave Love <fx@gnu.org>
parents:
diff changeset
415 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
416 If you have a large number of macros defined, you may want to write
Dave Love <fx@gnu.org>
parents:
diff changeset
417 an AUCTeX style file to support them with both AUCTeX and
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
418 @b{Ref@TeX{}}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
419
Dave Love <fx@gnu.org>
parents:
diff changeset
420 @item @b{Where Next?}@* Go ahead and use @b{Ref@TeX{}}. Use its menus
Dave Love <fx@gnu.org>
parents:
diff changeset
421 until you have picked up the key bindings. For an overview of what you
Dave Love <fx@gnu.org>
parents:
diff changeset
422 can do in each of the different special buffers, press @kbd{?}. Read
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
423 the manual if you get stuck, of if you are curious what else might be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
424 available. The first part of the manual explains in
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
425 a tutorial way how to use and customize @b{Ref@TeX{}}. The second
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
426 part is a command and variable reference.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
427 @end enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
428
Dave Love <fx@gnu.org>
parents:
diff changeset
429 @node Table of Contents, Labels and References, Introduction, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
430 @chapter Table of Contents
Dave Love <fx@gnu.org>
parents:
diff changeset
431 @cindex @file{*toc*} buffer
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
432 @cindex Structure editing
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
433 @cindex Table of contents buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
434 @findex reftex-toc
Dave Love <fx@gnu.org>
parents:
diff changeset
435 @kindex C-c =
Dave Love <fx@gnu.org>
parents:
diff changeset
436
Dave Love <fx@gnu.org>
parents:
diff changeset
437 Pressing the keys @kbd{C-c =} pops up a buffer showing the table of
Dave Love <fx@gnu.org>
parents:
diff changeset
438 contents of the document. By default, this @file{*toc*} buffer shows
Dave Love <fx@gnu.org>
parents:
diff changeset
439 only the sections of a document. Using the @kbd{l} and @kbd{i} keys you
Dave Love <fx@gnu.org>
parents:
diff changeset
440 can display all labels and index entries defined in the document as
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
441 well.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
442
Dave Love <fx@gnu.org>
parents:
diff changeset
443 With the cursor in any of the lines denoting a location in the
Dave Love <fx@gnu.org>
parents:
diff changeset
444 document, simple key strokes will display the corresponding part in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
445 another window, jump to that location, or perform other actions.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
446
Dave Love <fx@gnu.org>
parents:
diff changeset
447 @kindex ?
Dave Love <fx@gnu.org>
parents:
diff changeset
448 Here is a list of special commands in the @file{*toc*} buffer. A
Dave Love <fx@gnu.org>
parents:
diff changeset
449 summary of this information is always available by pressing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
450 @kbd{?}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
451
Dave Love <fx@gnu.org>
parents:
diff changeset
452 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
453
Dave Love <fx@gnu.org>
parents:
diff changeset
454 @tablesubheading{General}
Dave Love <fx@gnu.org>
parents:
diff changeset
455 @item ?
Dave Love <fx@gnu.org>
parents:
diff changeset
456 Display a summary of commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
457
Dave Love <fx@gnu.org>
parents:
diff changeset
458 @item 0-9, -
Dave Love <fx@gnu.org>
parents:
diff changeset
459 Prefix argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
460
Dave Love <fx@gnu.org>
parents:
diff changeset
461 @tablesubheading{Moving around}
Dave Love <fx@gnu.org>
parents:
diff changeset
462 @item n
Dave Love <fx@gnu.org>
parents:
diff changeset
463 Goto next entry in the table of context.
Dave Love <fx@gnu.org>
parents:
diff changeset
464
Dave Love <fx@gnu.org>
parents:
diff changeset
465 @item p
Dave Love <fx@gnu.org>
parents:
diff changeset
466 Goto previous entry in the table of context.
Dave Love <fx@gnu.org>
parents:
diff changeset
467
Dave Love <fx@gnu.org>
parents:
diff changeset
468 @item C-c C-n
Dave Love <fx@gnu.org>
parents:
diff changeset
469 Goto next section heading. Useful when many labels and index entries
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
470 separate section headings.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
471
Dave Love <fx@gnu.org>
parents:
diff changeset
472 @item C-c C-p
Dave Love <fx@gnu.org>
parents:
diff changeset
473 Goto previous section heading.
Dave Love <fx@gnu.org>
parents:
diff changeset
474
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
475 @item N z
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
476 Jump to section N, using the prefix arg. For example, @kbd{3 z} jumps
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
477 to section 3.
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
478
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
479 @tablesubheading{Access to document locations}
Dave Love <fx@gnu.org>
parents:
diff changeset
480 @item @key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
481 Show the corresponding location in another window. This command does
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
482 @emph{not} select that other window.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
483
Dave Love <fx@gnu.org>
parents:
diff changeset
484 @item @key{TAB}
Dave Love <fx@gnu.org>
parents:
diff changeset
485 Goto the location in another window.
Dave Love <fx@gnu.org>
parents:
diff changeset
486
Dave Love <fx@gnu.org>
parents:
diff changeset
487 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
488 Go to the location and hide the @file{*toc*} buffer. This will restore
Dave Love <fx@gnu.org>
parents:
diff changeset
489 the window configuration before @code{reftex-toc} (@kbd{C-c =}) was
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
490 called.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
491
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
492 @item mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
493 @vindex reftex-highlight-selection
Dave Love <fx@gnu.org>
parents:
diff changeset
494 Clicking with mouse button 2 on a line has the same effect as @key{RET}.
Dave Love <fx@gnu.org>
parents:
diff changeset
495 See also variable @code{reftex-highlight-selection}, @ref{Options
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
496 (Fontification)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
497
Dave Love <fx@gnu.org>
parents:
diff changeset
498 @item f
Dave Love <fx@gnu.org>
parents:
diff changeset
499 @vindex reftex-toc-follow-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
500 @vindex reftex-revisit-to-follow
Dave Love <fx@gnu.org>
parents:
diff changeset
501 Toggle follow mode. When follow mode is active, the other window will
Dave Love <fx@gnu.org>
parents:
diff changeset
502 always show the location corresponding to the line at point in the
Dave Love <fx@gnu.org>
parents:
diff changeset
503 @file{*toc*} buffer. This is similar to pressing @key{SPC} after each
Dave Love <fx@gnu.org>
parents:
diff changeset
504 cursor motion. The default for this flag can be set with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
505 @code{reftex-toc-follow-mode}. Note that only context in files already
Dave Love <fx@gnu.org>
parents:
diff changeset
506 visited is shown. @b{Ref@TeX{}} will not visit a file just for follow
Dave Love <fx@gnu.org>
parents:
diff changeset
507 mode. See, however, the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
508 @code{reftex-revisit-to-follow}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
509
Dave Love <fx@gnu.org>
parents:
diff changeset
510 @item .
Dave Love <fx@gnu.org>
parents:
diff changeset
511 Show calling point in another window. This is the point from where
Dave Love <fx@gnu.org>
parents:
diff changeset
512 @code{reftex-toc} was last called.
Dave Love <fx@gnu.org>
parents:
diff changeset
513
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
514 @page
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
515 @tablesubheading{Promotion and Demotion}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
516
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
517 @item <
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
518 Promote the current section. This will convert @code{\section} to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
519 @code{\chapter}, @code{\subsection} to @code{\section} etc. If there is
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
520 an active region, all sections in the region will be promoted, including
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
521 the one at point. To avoid mistakes, @b{Ref@TeX{}} requires a fresh
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
522 document scan before executing this command - if necessary, it will
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
523 automatically do this scan and ask the user to repeat the promotion
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
524 command.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
525
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
526 @item >
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
527 Demote the current section. This is the opposite of promotion. It will
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
528 convert @code{\chapter} to @code{\section} etc. If there is an active
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
529 region, all sections in the region will be demoted, including the one at
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
530 point.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
531
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
532 @item M-%
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
533 Rename the label at point. While generally not recommended, this can be
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
534 useful when a package like @file{fancyref} is used where the label
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
535 prefix determines the wording of a reference. After a
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
536 promotion/demotion it may be necessary to change a few labels from
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
537 @samp{sec:xyz} to @samp{cha:xyz} or vice versa. This command can be
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
538 used to do this - it launches a query replace to rename the definition
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
539 and all references of a label.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
540
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
541 @tablesubheading{Exiting}
Dave Love <fx@gnu.org>
parents:
diff changeset
542 @item q
Dave Love <fx@gnu.org>
parents:
diff changeset
543 Hide the @file{*toc*} buffer, return to the position where
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
544 @code{reftex-toc} was last called.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
545
Dave Love <fx@gnu.org>
parents:
diff changeset
546 @item k
Dave Love <fx@gnu.org>
parents:
diff changeset
547 Kill the @file{*toc*} buffer, return to the position where
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
548 @code{reftex-toc} was last called.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
549
Dave Love <fx@gnu.org>
parents:
diff changeset
550 @item C-c >
Dave Love <fx@gnu.org>
parents:
diff changeset
551 Switch to the @file{*Index*} buffer of this document. With prefix
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
552 @samp{2}, restrict the index to the section at point in the @file{*toc*}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
553 buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
554
Dave Love <fx@gnu.org>
parents:
diff changeset
555 @tablesubheading{Controlling what gets displayed}
Dave Love <fx@gnu.org>
parents:
diff changeset
556
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
557 @item t
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
558 @vindex reftex-toc-max-level
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
559 Change the maximum level of toc entries displayed in the @file{*toc*}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
560 buffer. Without prefix arg, all levels will be included. With prefix
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
561 arg (e.g @kbd{3 t}), ignore all toc entries with level greater than
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
562 @var{arg} (3 in this case). Chapters are level 1, sections are level 2.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
563 The mode line @samp{T<>} indicator shows the current value. The default
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
564 depth can be configured with the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
565 @code{reftex-toc-max-level}.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
566
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
567 @item F
Dave Love <fx@gnu.org>
parents:
diff changeset
568 @vindex reftex-toc-include-file-boundaries
Dave Love <fx@gnu.org>
parents:
diff changeset
569 Toggle the display of the file borders of a multifile document in the
Dave Love <fx@gnu.org>
parents:
diff changeset
570 @file{*toc*} buffer. The default for this flag can be set with the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
571 variable @code{reftex-toc-include-file-boundaries}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
572
Dave Love <fx@gnu.org>
parents:
diff changeset
573 @item l
Dave Love <fx@gnu.org>
parents:
diff changeset
574 @vindex reftex-toc-include-labels
Dave Love <fx@gnu.org>
parents:
diff changeset
575 Toggle the display of labels in the @file{*toc*} buffer. The default
Dave Love <fx@gnu.org>
parents:
diff changeset
576 for this flag can be set with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
577 @code{reftex-toc-include-labels}. When called with a prefix argument,
Dave Love <fx@gnu.org>
parents:
diff changeset
578 @b{Ref@TeX{}} will prompt for a label type and include only labels of
Dave Love <fx@gnu.org>
parents:
diff changeset
579 the selected type in the @file{*toc*} buffer. The mode line @samp{L<>}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
580 indicator shows which labels are included.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
581
Dave Love <fx@gnu.org>
parents:
diff changeset
582 @item i
Dave Love <fx@gnu.org>
parents:
diff changeset
583 @vindex reftex-toc-include-index-entries
Dave Love <fx@gnu.org>
parents:
diff changeset
584 Toggle the display of index entries in the @file{*toc*} buffer. The
Dave Love <fx@gnu.org>
parents:
diff changeset
585 default for this flag can be set with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
586 @code{reftex-toc-include-index-entries}. When called with a prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
587 argument, @b{Ref@TeX{}} will prompt for a specific index and include
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
588 only entries in the selected index in the @file{*toc*} buffer. The mode
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
589 line @samp{I<>} indicator shows which index is used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
590
Dave Love <fx@gnu.org>
parents:
diff changeset
591 @item c
Dave Love <fx@gnu.org>
parents:
diff changeset
592 @vindex reftex-toc-include-context
Dave Love <fx@gnu.org>
parents:
diff changeset
593 Toggle the display of label and index context in the @file{*toc*}
Dave Love <fx@gnu.org>
parents:
diff changeset
594 buffer. The default for this flag can be set with the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
595 @code{reftex-toc-include-context}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
596
Dave Love <fx@gnu.org>
parents:
diff changeset
597 @tablesubheading{Updating the buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
598
Dave Love <fx@gnu.org>
parents:
diff changeset
599 @item g
Dave Love <fx@gnu.org>
parents:
diff changeset
600 Rebuild the @file{*toc*} buffer. This does @emph{not} rescan the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
601 document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
602
Dave Love <fx@gnu.org>
parents:
diff changeset
603 @item r
Dave Love <fx@gnu.org>
parents:
diff changeset
604 @vindex reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
605 Reparse the LaTeX document and rebuild the @file{*toc*} buffer. When
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
606 @code{reftex-enable-partial-scans} is non-@code{nil}, rescan only the file this
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
607 location is defined in, not the entire document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
608
Dave Love <fx@gnu.org>
parents:
diff changeset
609 @item C-u r
Dave Love <fx@gnu.org>
parents:
diff changeset
610 Reparse the @emph{entire} LaTeX document and rebuild the @file{*toc*}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
611 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
612
Dave Love <fx@gnu.org>
parents:
diff changeset
613 @item x
Dave Love <fx@gnu.org>
parents:
diff changeset
614 Switch to the @file{*toc*} buffer of an external document. When the
Dave Love <fx@gnu.org>
parents:
diff changeset
615 current document is using the @code{xr} package (@pxref{xr (LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
616 package)}), @b{Ref@TeX{}} will switch to one of the external
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
617 documents.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
618
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
619
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
620 @tablesubheading{Automatic recentering}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
621
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
622 @item d
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
623 Toggle the display of a dedicated frame displaying just the @file{*toc*}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
624 buffer. Follow mode and visiting locations will not work that frame,
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
625 but automatic recentering will make this frame always show your current
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
626 editing location in the document (see below).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
627
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
628 @item a
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
629 Toggle the automatic recentering of the @file{*toc*} buffer. When this
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
630 option is on, moving around in the document will cause the @file{*toc*}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
631 to always highlight the current section. By default, this option is
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
632 active while the dedicated @file{*TOC*} frame exists. See also the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
633 variable @code{reftex-auto-recenter-toc}.
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
634
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
635 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
636
Dave Love <fx@gnu.org>
parents:
diff changeset
637 @vindex reftex-toc-map
Dave Love <fx@gnu.org>
parents:
diff changeset
638 In order to define additional commands for the @file{*toc*} buffer, the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
639 keymap @code{reftex-toc-map} may be used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
640
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
641 @findex reftex-toc-recenter
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
642 @vindex reftex-auto-recenter-toc
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
643 @vindex reftex-idle-time
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
644 @cindex @file{*toc*} buffer, recentering
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
645 @cindex Table of contents buffer, recentering
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
646 @kindex C-c -
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
647 If you call @code{reftex-toc} while the @file{*toc*} buffer already
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
648 exists, the cursor will immediately jump to the right place, i.e. the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
649 section from which @code{reftex-toc} was called will be highlighted.
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
650 The command @kbd{C-c -} (@code{reftex-toc-recenter}) will only redisplay
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
651 the @file{*toc*} buffer and highlight the correct line without actually
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
652 selecting the @file{*toc*} window. This can be useful to quickly find
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
653 out where in the document you currently are. You can also automate this
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
654 by asking RefTeX to keep track of your current editing position in the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
655 TOC. The TOC window will then be updated whenever you stop typing for
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
656 more than @code{reftex-idle-time} seconds. By default this works only
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
657 with the dedicated @file{*TOC*} frame. But you can also force automatic
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
658 recentering of the TOC window on the current frame with
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
659 @lisp
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
660 (setq reftex-auto-recenter-toc t)
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
661 @end lisp
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
662
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
663
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
664 @cindex Sectioning commands
Dave Love <fx@gnu.org>
parents:
diff changeset
665 @cindex KOMA-Script, LaTeX classes
Dave Love <fx@gnu.org>
parents:
diff changeset
666 @cindex LaTeX classes, KOMA-Script
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
667 @cindex TOC entries for environments
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
668 @vindex reftex-section-levels
Dave Love <fx@gnu.org>
parents:
diff changeset
669 The section macros recognized by @b{Ref@TeX{}} are all LaTeX section
Dave Love <fx@gnu.org>
parents:
diff changeset
670 macros (from @code{\part} to @code{\subsubparagraph}) and the commands
Dave Love <fx@gnu.org>
parents:
diff changeset
671 @code{\addchap} and @code{\addsec} from the KOMA-Script classes.
Dave Love <fx@gnu.org>
parents:
diff changeset
672 Additional macros can be configured with the variable
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
673 @code{reftex-section-levels}. It is also possible to add certain LaTeX
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
674 environments to the table of contents. This is probably only useful for
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
675 theorem-like environments. @xref{Defining Label Environments}, for an
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
676 example.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
677
Dave Love <fx@gnu.org>
parents:
diff changeset
678 @node Labels and References, Citations, Table of Contents, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
679 @chapter Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
680 @cindex Labels in LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
681 @cindex References in LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
682 @cindex Label category
Dave Love <fx@gnu.org>
parents:
diff changeset
683 @cindex Label environment
Dave Love <fx@gnu.org>
parents:
diff changeset
684 @cindex @code{\label}
Dave Love <fx@gnu.org>
parents:
diff changeset
685
Dave Love <fx@gnu.org>
parents:
diff changeset
686 LaTeX provides a powerful mechanism to deal with cross--references in a
Dave Love <fx@gnu.org>
parents:
diff changeset
687 document. When writing a document, any part of it can be marked with a
Dave Love <fx@gnu.org>
parents:
diff changeset
688 label, like @samp{\label@{mark@}}. LaTeX records the current value of a
Dave Love <fx@gnu.org>
parents:
diff changeset
689 certain counter when a label is defined. Later references to this label
Dave Love <fx@gnu.org>
parents:
diff changeset
690 (like @samp{\ref@{mark@}}) will produce the recorded value of the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
691 counter.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
692
Dave Love <fx@gnu.org>
parents:
diff changeset
693 Labels can be used to mark sections, figures, tables, equations,
Dave Love <fx@gnu.org>
parents:
diff changeset
694 footnotes, items in enumerate lists etc. LaTeX is context sensitive in
Dave Love <fx@gnu.org>
parents:
diff changeset
695 doing this: A label defined in a figure environment automatically
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
696 records the figure counter, not the section counter.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
697
Dave Love <fx@gnu.org>
parents:
diff changeset
698 Several different environments can share a common counter and therefore
Dave Love <fx@gnu.org>
parents:
diff changeset
699 a common label category. E.g. labels in both @code{equation} and
Dave Love <fx@gnu.org>
parents:
diff changeset
700 @code{eqnarray} environments record the value of the same counter - the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
701 equation counter.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
702
Dave Love <fx@gnu.org>
parents:
diff changeset
703 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
704 * Creating Labels::
Dave Love <fx@gnu.org>
parents:
diff changeset
705 * Referencing Labels::
Dave Love <fx@gnu.org>
parents:
diff changeset
706 * Builtin Label Environments:: The environments RefTeX knows about.
Dave Love <fx@gnu.org>
parents:
diff changeset
707 * Defining Label Environments:: ... and environments it doesn't.
Dave Love <fx@gnu.org>
parents:
diff changeset
708 * Reference Info:: View the label corresponding to a \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
709 * xr (LaTeX package):: References to external documents.
Dave Love <fx@gnu.org>
parents:
diff changeset
710 * varioref (LaTeX package):: How to create \vref instead of \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
711 * fancyref (LaTeX package):: How to create \fref instead of \ref.
Dave Love <fx@gnu.org>
parents:
diff changeset
712 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
713
Dave Love <fx@gnu.org>
parents:
diff changeset
714 @node Creating Labels, Referencing Labels, , Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
715 @section Creating Labels
Dave Love <fx@gnu.org>
parents:
diff changeset
716 @cindex Creating labels
Dave Love <fx@gnu.org>
parents:
diff changeset
717 @cindex Labels, creating
Dave Love <fx@gnu.org>
parents:
diff changeset
718 @cindex Labels, deriving from context
Dave Love <fx@gnu.org>
parents:
diff changeset
719 @kindex C-c (
Dave Love <fx@gnu.org>
parents:
diff changeset
720 @findex reftex-label
Dave Love <fx@gnu.org>
parents:
diff changeset
721
Dave Love <fx@gnu.org>
parents:
diff changeset
722 In order to create a label in a LaTeX document, press @kbd{C-c (}
Dave Love <fx@gnu.org>
parents:
diff changeset
723 (@code{reftex-label}). Just like LaTeX, @b{Ref@TeX{}} is context sensitive
Dave Love <fx@gnu.org>
parents:
diff changeset
724 and will figure out the environment it currently is in and adapt the
Dave Love <fx@gnu.org>
parents:
diff changeset
725 label to that environment. A label usually consists of a short prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
726 indicating the type of the label and a unique mark. @b{Ref@TeX{}} has
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
727 3 different modes to create this mark.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
728
Dave Love <fx@gnu.org>
parents:
diff changeset
729 @enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
730 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
731 @vindex reftex-translate-to-ascii-function
Dave Love <fx@gnu.org>
parents:
diff changeset
732 @vindex reftex-derive-label-parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
733 @vindex reftex-label-illegal-re
Dave Love <fx@gnu.org>
parents:
diff changeset
734 @vindex reftex-abbrev-parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
735 A label can be derived from context. This means, @b{Ref@TeX{}} takes
Dave Love <fx@gnu.org>
parents:
diff changeset
736 the context of the label definition and constructs a label from
Dave Love <fx@gnu.org>
parents:
diff changeset
737 that@footnote{Note that the context may contain constructs which are
60919
3ad3287d2e49 * calc.texi, reftex.texi: Replace `illegal' with `invalid'.
Werner LEMBERG <wl@gnu.org>
parents: 59731
diff changeset
738 invalid in labels. @b{Ref@TeX{}} will therefore strip the accent from
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
739 accented Latin-1 characters and remove everything else which is not
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
740 valid in labels. This mechanism is safe, but may not be satisfactory
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
741 for non-western languages. Check the following variables if you need to
Dave Love <fx@gnu.org>
parents:
diff changeset
742 change things: @code{reftex-translate-to-ascii-function},
Dave Love <fx@gnu.org>
parents:
diff changeset
743 @code{reftex-derive-label-parameters}, @code{reftex-label-illegal-re},
Dave Love <fx@gnu.org>
parents:
diff changeset
744 @code{reftex-abbrev-parameters}.}. This works best for section labels,
Dave Love <fx@gnu.org>
parents:
diff changeset
745 where the section heading is used to construct a label. In fact,
Dave Love <fx@gnu.org>
parents:
diff changeset
746 @b{Ref@TeX{}}'s default settings use this method only for section
Dave Love <fx@gnu.org>
parents:
diff changeset
747 labels. You will be asked to confirm the derived label, or edit
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
748 it.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
749
Dave Love <fx@gnu.org>
parents:
diff changeset
750 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
751 We may also use a simple unique number to identify a label. This is
Dave Love <fx@gnu.org>
parents:
diff changeset
752 mostly useful for labels where it is difficult to come up with a very
Dave Love <fx@gnu.org>
parents:
diff changeset
753 good descriptive name. @b{Ref@TeX{}}'s default settings use this method
Dave Love <fx@gnu.org>
parents:
diff changeset
754 for equations, enumerate items and footnotes. The author of @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
755 tends to write documents with many equations and finds it impossible
Dave Love <fx@gnu.org>
parents:
diff changeset
756 to come up with good names for each of them. These simple labels are
Dave Love <fx@gnu.org>
parents:
diff changeset
757 inserted without query, and are therefore very fast. Good descriptive
Dave Love <fx@gnu.org>
parents:
diff changeset
758 names are not really necessary as @b{Ref@TeX{}} will provide context to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
759 reference a label (@pxref{Referencing Labels}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
760
Dave Love <fx@gnu.org>
parents:
diff changeset
761 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
762 The third method is to ask the user for a label. This is most
Dave Love <fx@gnu.org>
parents:
diff changeset
763 useful for things which are easy to describe briefly and do not turn up
Dave Love <fx@gnu.org>
parents:
diff changeset
764 too frequently in a document. @b{Ref@TeX{}} uses this for figures and
Dave Love <fx@gnu.org>
parents:
diff changeset
765 tables. Of course, one can enter the label directly by typing the full
Dave Love <fx@gnu.org>
parents:
diff changeset
766 @samp{\label@{mark@}}. The advantage of using @code{reftex-label}
Dave Love <fx@gnu.org>
parents:
diff changeset
767 anyway is that @b{Ref@TeX{}} will know that a new label has been defined.
Dave Love <fx@gnu.org>
parents:
diff changeset
768 It will then not be necessary to rescan the document in order to access
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
769 this label later.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
770 @end enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
771
Dave Love <fx@gnu.org>
parents:
diff changeset
772 @vindex reftex-insert-label-flags
Dave Love <fx@gnu.org>
parents:
diff changeset
773 If you want to change the way certain labels are created, check out the
Dave Love <fx@gnu.org>
parents:
diff changeset
774 variable @code{reftex-insert-label-flags} (@pxref{Options (Creating
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
775 Labels)}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
776
Dave Love <fx@gnu.org>
parents:
diff changeset
777 If you are using AUCTeX to write your LaTeX documents, you can
Dave Love <fx@gnu.org>
parents:
diff changeset
778 set it up to delegate the creation of labels to
Dave Love <fx@gnu.org>
parents:
diff changeset
779 @b{Ref@TeX{}}. @xref{AUCTeX}, for more information.
Dave Love <fx@gnu.org>
parents:
diff changeset
780
Dave Love <fx@gnu.org>
parents:
diff changeset
781 @node Referencing Labels, Builtin Label Environments, Creating Labels, Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
782 @section Referencing Labels
Dave Love <fx@gnu.org>
parents:
diff changeset
783 @cindex Referencing labels
Dave Love <fx@gnu.org>
parents:
diff changeset
784 @cindex Labels, referencing
Dave Love <fx@gnu.org>
parents:
diff changeset
785 @cindex Selection buffer, labels
Dave Love <fx@gnu.org>
parents:
diff changeset
786 @cindex Selection process
Dave Love <fx@gnu.org>
parents:
diff changeset
787 @cindex @code{\ref}
Dave Love <fx@gnu.org>
parents:
diff changeset
788 @kindex C-c )
Dave Love <fx@gnu.org>
parents:
diff changeset
789 @findex reftex-reference
Dave Love <fx@gnu.org>
parents:
diff changeset
790
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
791 @vindex reftex-trust-label-prefix
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
792 @b{Ref@TeX{}} scans the document in order to find all labels. To make
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
793 referencing labels easier, it assigns to each label a category, the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
794 @emph{label type} (for example section, table, figure, equation, etc.).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
795 In order to determine the label type, RefTeX parses around each label
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
796 to see in what kind of environments it is located. You can speed up
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
797 the parsing by using type-specific prefixes for labels and configuring
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
798 the variable @code{reftex-trust-label-prefix}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
799
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
800 Referencing Labels is really at the heart of @b{Ref@TeX{}}. Press @kbd{C-c
Dave Love <fx@gnu.org>
parents:
diff changeset
801 )} in order to reference a label (reftex-reference). This will start a
Dave Love <fx@gnu.org>
parents:
diff changeset
802 selection process and finally insert the complete @samp{\ref@{label@}}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
803 into the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
804
Dave Love <fx@gnu.org>
parents:
diff changeset
805 First, @b{Ref@TeX{}} will determine the label category which is required.
Dave Love <fx@gnu.org>
parents:
diff changeset
806 Often that can be figured out from context. For example, if you
Dave Love <fx@gnu.org>
parents:
diff changeset
807 write @samp{As shown in eq.} and the press @kbd{C-c )}, @b{Ref@TeX{}} knows
Dave Love <fx@gnu.org>
parents:
diff changeset
808 that an equation label is going to be referenced. If it cannot figure
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
809 out what label category is needed, it will query for one.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
810
Dave Love <fx@gnu.org>
parents:
diff changeset
811 You will then be presented with a label selection menu. This is a
Dave Love <fx@gnu.org>
parents:
diff changeset
812 special buffer which contains an outline of the document along with all
Dave Love <fx@gnu.org>
parents:
diff changeset
813 labels of the given label category. In addition, next to the label
Dave Love <fx@gnu.org>
parents:
diff changeset
814 there will be one line of context of the label definition, which is some
Dave Love <fx@gnu.org>
parents:
diff changeset
815 text in the buffer near the label definition. Usually this is
Dave Love <fx@gnu.org>
parents:
diff changeset
816 sufficient to identify the label. If you are unsure about a certain
Dave Love <fx@gnu.org>
parents:
diff changeset
817 label, pressing @key{SPC} will show the label definition point in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
818 another window.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
819
Dave Love <fx@gnu.org>
parents:
diff changeset
820 In order to reference a label, move to cursor to the correct label and
Dave Love <fx@gnu.org>
parents:
diff changeset
821 press @key{RET}. You can also reference several labels with a single
Dave Love <fx@gnu.org>
parents:
diff changeset
822 call to @code{reftex-reference} by marking entries with the @kbd{m}
Dave Love <fx@gnu.org>
parents:
diff changeset
823 key (see below).
Dave Love <fx@gnu.org>
parents:
diff changeset
824
Dave Love <fx@gnu.org>
parents:
diff changeset
825 @kindex ?
Dave Love <fx@gnu.org>
parents:
diff changeset
826 Here is a list of special commands in the selection buffer. A summary
Dave Love <fx@gnu.org>
parents:
diff changeset
827 of this information is always available from the selection process by
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
828 pressing @kbd{?}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
829
Dave Love <fx@gnu.org>
parents:
diff changeset
830
Dave Love <fx@gnu.org>
parents:
diff changeset
831
Dave Love <fx@gnu.org>
parents:
diff changeset
832 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
833 @tablesubheading{General}
Dave Love <fx@gnu.org>
parents:
diff changeset
834 @item ?
Dave Love <fx@gnu.org>
parents:
diff changeset
835 Show a summary of available commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
836
Dave Love <fx@gnu.org>
parents:
diff changeset
837 @item 0-9,-
Dave Love <fx@gnu.org>
parents:
diff changeset
838 Prefix argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
839
Dave Love <fx@gnu.org>
parents:
diff changeset
840 @tablesubheading{Moving around}
Dave Love <fx@gnu.org>
parents:
diff changeset
841 @item n
Dave Love <fx@gnu.org>
parents:
diff changeset
842 Go to next label.
Dave Love <fx@gnu.org>
parents:
diff changeset
843
Dave Love <fx@gnu.org>
parents:
diff changeset
844 @item p
Dave Love <fx@gnu.org>
parents:
diff changeset
845 Go to previous label.
Dave Love <fx@gnu.org>
parents:
diff changeset
846
Dave Love <fx@gnu.org>
parents:
diff changeset
847 @item b
Dave Love <fx@gnu.org>
parents:
diff changeset
848 Jump back to the position where you last left the selection buffer.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
849 Normally this should get you back to the last referenced label.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
850
Dave Love <fx@gnu.org>
parents:
diff changeset
851 @item C-c C-n
Dave Love <fx@gnu.org>
parents:
diff changeset
852 Goto next section heading.
Dave Love <fx@gnu.org>
parents:
diff changeset
853
Dave Love <fx@gnu.org>
parents:
diff changeset
854 @item C-c C-p
Dave Love <fx@gnu.org>
parents:
diff changeset
855 Goto previous section heading.
Dave Love <fx@gnu.org>
parents:
diff changeset
856
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
857 @item N z
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
858 Jump to section N, using the prefix arg. For example @kbd{3 z} jumps to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
859 section 3.
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
860
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
861 @tablesubheading{Displaying Context}
Dave Love <fx@gnu.org>
parents:
diff changeset
862 @item @key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
863 Show the surroundings of the definition of the current label in another
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
864 window. See also the @kbd{f} key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
865
Dave Love <fx@gnu.org>
parents:
diff changeset
866 @item f
Dave Love <fx@gnu.org>
parents:
diff changeset
867 @vindex reftex-revisit-to-follow
Dave Love <fx@gnu.org>
parents:
diff changeset
868 Toggle follow mode. When follow mode is active, the other window will
Dave Love <fx@gnu.org>
parents:
diff changeset
869 always display the full context of the current label. This is similar
Dave Love <fx@gnu.org>
parents:
diff changeset
870 to pressing @key{SPC} after each cursor motion. Note that only context
Dave Love <fx@gnu.org>
parents:
diff changeset
871 in files already visited is shown. @b{RefTeX} will not visit a file
Dave Love <fx@gnu.org>
parents:
diff changeset
872 just for follow mode. See, however, the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
873 @code{reftex-revisit-to-follow}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
874
Dave Love <fx@gnu.org>
parents:
diff changeset
875 @item .
Dave Love <fx@gnu.org>
parents:
diff changeset
876 Show insertion point in another window. This is the point from where you
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
877 called @code{reftex-reference}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
878
Dave Love <fx@gnu.org>
parents:
diff changeset
879 @tablesubheading{Selecting a label and creating the reference}
Dave Love <fx@gnu.org>
parents:
diff changeset
880 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
881 Insert a reference to the label at point into the buffer from which the
Dave Love <fx@gnu.org>
parents:
diff changeset
882 selection process was started. When entries have been marked, @key{RET}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
883 references all marked labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
884
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
885 @item mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
886 @vindex reftex-highlight-selection
Dave Love <fx@gnu.org>
parents:
diff changeset
887 Clicking with mouse button 2 on a label will accept it like @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
888 would. See also variable @code{reftex-highlight-selection}, @ref{Options
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
889 (Misc)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
890
Dave Love <fx@gnu.org>
parents:
diff changeset
891 @vindex reftex-multiref-punctuation
Dave Love <fx@gnu.org>
parents:
diff changeset
892 @item m - + ,
Dave Love <fx@gnu.org>
parents:
diff changeset
893 Mark the current entry. When several entries have been marked, pressing
Dave Love <fx@gnu.org>
parents:
diff changeset
894 @kbd{RET} will accept all of them and place them into several
Dave Love <fx@gnu.org>
parents:
diff changeset
895 @code{\ref} macros. The special markers @samp{,-+} also store a
Dave Love <fx@gnu.org>
parents:
diff changeset
896 separator to be inserted before the corresponding reference. So marking
Dave Love <fx@gnu.org>
parents:
diff changeset
897 six entries with the keys @samp{m , , - , +} will give a reference list
Dave Love <fx@gnu.org>
parents:
diff changeset
898 like this (see the variable @code{reftex-multiref-punctuation})
Dave Love <fx@gnu.org>
parents:
diff changeset
899 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
900 In eqs. (1), (2), (3)--(4), (5) and (6)
Dave Love <fx@gnu.org>
parents:
diff changeset
901 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
902
Dave Love <fx@gnu.org>
parents:
diff changeset
903 @item u
Dave Love <fx@gnu.org>
parents:
diff changeset
904 Unmark a marked entry.
Dave Love <fx@gnu.org>
parents:
diff changeset
905
Dave Love <fx@gnu.org>
parents:
diff changeset
906 @c FIXME: Do we need `A' as well for consistency?
Dave Love <fx@gnu.org>
parents:
diff changeset
907 @cindex LaTeX packages, @code{saferef}
Dave Love <fx@gnu.org>
parents:
diff changeset
908 @cindex @code{saferef}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
909 @item a
Dave Love <fx@gnu.org>
parents:
diff changeset
910 Accept the marked entries and put all labels as a comma-separated list
Dave Love <fx@gnu.org>
parents:
diff changeset
911 into one @emph{single} @code{\ref} macro. Some packages like
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
912 @file{saferef.sty} support multiple references in this way.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
913
Dave Love <fx@gnu.org>
parents:
diff changeset
914 @item l
Dave Love <fx@gnu.org>
parents:
diff changeset
915 Use the last referenced label(s) again. This is equivalent to moving to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
916 that label and pressing @key{RET}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
917
Dave Love <fx@gnu.org>
parents:
diff changeset
918 @item @key{TAB}
Dave Love <fx@gnu.org>
parents:
diff changeset
919 Enter a label with completion. This may also be a label which does not
Dave Love <fx@gnu.org>
parents:
diff changeset
920 yet exist in the document.
Dave Love <fx@gnu.org>
parents:
diff changeset
921
Dave Love <fx@gnu.org>
parents:
diff changeset
922 @item v
Dave Love <fx@gnu.org>
parents:
diff changeset
923 @cindex @code{varioref}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
924 @cindex @code{\vref}
Dave Love <fx@gnu.org>
parents:
diff changeset
925 @cindex LaTeX packages, @code{varioref}
Dave Love <fx@gnu.org>
parents:
diff changeset
926 Toggle between @code{\ref} and @code{\vref} macro for references. The
Dave Love <fx@gnu.org>
parents:
diff changeset
927 @code{\vref} macro is defined in the @code{varioref} LaTeX package.
Dave Love <fx@gnu.org>
parents:
diff changeset
928 With this key you can force @b{Ref@TeX{}} to insert a @code{\vref}
Dave Love <fx@gnu.org>
parents:
diff changeset
929 macro. The current state of this flag is displayed by the @samp{S<>}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
930 indicator in the mode line of the selection buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
931
Dave Love <fx@gnu.org>
parents:
diff changeset
932 @item V
Dave Love <fx@gnu.org>
parents:
diff changeset
933 @cindex @code{fancyref}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
934 @cindex @code{\fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
935 @cindex @code{\Fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
936 @cindex LaTeX packages, @code{fancyref}
Dave Love <fx@gnu.org>
parents:
diff changeset
937 Cycle between @code{\ref}, @code{\fref} and @code{\Fref}. The
Dave Love <fx@gnu.org>
parents:
diff changeset
938 @code{\fref} and @code{\Fref} macros are defined in the @code{fancyref}
Dave Love <fx@gnu.org>
parents:
diff changeset
939 LaTeX package. With this key you can force @b{Ref@TeX{}} to insert a
Dave Love <fx@gnu.org>
parents:
diff changeset
940 @code{\fref} or @code{\Fref} macro. The current state of this flag is
Dave Love <fx@gnu.org>
parents:
diff changeset
941 displayed by the @samp{S<>} indicator in the mode line of the
Dave Love <fx@gnu.org>
parents:
diff changeset
942 selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
943
Dave Love <fx@gnu.org>
parents:
diff changeset
944 @tablesubheading{Exiting}
Dave Love <fx@gnu.org>
parents:
diff changeset
945
Dave Love <fx@gnu.org>
parents:
diff changeset
946 @item q
Dave Love <fx@gnu.org>
parents:
diff changeset
947 Exit the selection process without inserting any reference into the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
948 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
949
Dave Love <fx@gnu.org>
parents:
diff changeset
950 @tablesubheading{Controlling what gets displayed}
Dave Love <fx@gnu.org>
parents:
diff changeset
951 @vindex reftex-label-menu-flags
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
952 The defaults for the following flags can be configured with the variable
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
953 @code{reftex-label-menu-flags} (@pxref{Options (Referencing Labels)}).
Dave Love <fx@gnu.org>
parents:
diff changeset
954
Dave Love <fx@gnu.org>
parents:
diff changeset
955 @item c
Dave Love <fx@gnu.org>
parents:
diff changeset
956 Toggle the display of the one-line label definition context in the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
957 selection buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
958
Dave Love <fx@gnu.org>
parents:
diff changeset
959 @item F
Dave Love <fx@gnu.org>
parents:
diff changeset
960 Toggle the display of the file borders of a multifile document in the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
961 selection buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
962
Dave Love <fx@gnu.org>
parents:
diff changeset
963 @item t
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
964 Toggle the display of the table of contents in the selection buffer.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
965 With prefix @var{arg}, change the maximum level of toc entries displayed
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
966 to @var{arg}. Chapters are level 1, section are level 2.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
967
Dave Love <fx@gnu.org>
parents:
diff changeset
968 @item #
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
969 Toggle the display of a label counter in the selection buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
970
Dave Love <fx@gnu.org>
parents:
diff changeset
971 @item %
Dave Love <fx@gnu.org>
parents:
diff changeset
972 Toggle the display of labels hidden in comments in the selection
Dave Love <fx@gnu.org>
parents:
diff changeset
973 buffers. Sometimes, you may have commented out parts of your document.
Dave Love <fx@gnu.org>
parents:
diff changeset
974 If these parts contain label definitions, @b{Ref@TeX{}} can still display
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
975 and reference these labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
976
Dave Love <fx@gnu.org>
parents:
diff changeset
977 @tablesubheading{Updating the buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
978 @item g
Dave Love <fx@gnu.org>
parents:
diff changeset
979 Update the menu. This will rebuilt the menu from the internal label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
980 list, but not reparse the document (see @kbd{r}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
981
Dave Love <fx@gnu.org>
parents:
diff changeset
982 @item r
Dave Love <fx@gnu.org>
parents:
diff changeset
983 @vindex reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
984 Reparse the document to update the information on all labels and rebuild
Dave Love <fx@gnu.org>
parents:
diff changeset
985 the menu. If the variable @code{reftex-enable-partial-scans} is
Dave Love <fx@gnu.org>
parents:
diff changeset
986 non-@code{nil} and your document is a multifile document, this will
Dave Love <fx@gnu.org>
parents:
diff changeset
987 reparse only a part of the document (the file in which the label at
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
988 point was defined).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
989
Dave Love <fx@gnu.org>
parents:
diff changeset
990 @item C-u r
Dave Love <fx@gnu.org>
parents:
diff changeset
991 Reparse the @emph{entire} document.
Dave Love <fx@gnu.org>
parents:
diff changeset
992
Dave Love <fx@gnu.org>
parents:
diff changeset
993 @item s
Dave Love <fx@gnu.org>
parents:
diff changeset
994 Switch the label category. After prompting for another label category,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
995 a menu for that category will be shown.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
996
Dave Love <fx@gnu.org>
parents:
diff changeset
997 @item x
Dave Love <fx@gnu.org>
parents:
diff changeset
998 Reference a label from an external document. With the LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
999 @code{xr} it is possible to reference labels defined in another
Dave Love <fx@gnu.org>
parents:
diff changeset
1000 document. This key will switch to the label menu of an external
Dave Love <fx@gnu.org>
parents:
diff changeset
1001 document and let you select a label from there (@pxref{xr (LaTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1002 package),,xr}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1003
Dave Love <fx@gnu.org>
parents:
diff changeset
1004 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1005
Dave Love <fx@gnu.org>
parents:
diff changeset
1006 @vindex reftex-select-label-map
Dave Love <fx@gnu.org>
parents:
diff changeset
1007 In order to define additional commands for the selection process, the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1008 keymap @code{reftex-select-label-map} may be used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1009
Dave Love <fx@gnu.org>
parents:
diff changeset
1010 @node Builtin Label Environments, Defining Label Environments, Referencing Labels, Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1011 @section Builtin Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1012 @cindex Builtin label environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1013 @cindex Label environments, builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
1014 @cindex Environments, builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
1015 @vindex reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1016 @vindex reftex-label-alist-builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
1017
Dave Love <fx@gnu.org>
parents:
diff changeset
1018 @b{Ref@TeX{}} needs to be aware of the environments which can be referenced
Dave Love <fx@gnu.org>
parents:
diff changeset
1019 with a label (i.e. which carry their own counters). By default, @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
1020 recognizes all labeled environments and macros discussed in @cite{The
Dave Love <fx@gnu.org>
parents:
diff changeset
1021 LaTeX Companion by Goossens, Mittelbach & Samarin, Addison-Wesley
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1022 1994.}. These are:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1023
Dave Love <fx@gnu.org>
parents:
diff changeset
1024 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
1025 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1026 @cindex @code{figure}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1027 @cindex @code{figure*}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1028 @cindex @code{table}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1029 @cindex @code{table*}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1030 @cindex @code{equation}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1031 @cindex @code{eqnarray}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1032 @cindex @code{enumerate}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1033 @cindex @code{\footnote}, LaTeX macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1034 @cindex LaTeX macro @code{footnote}
Dave Love <fx@gnu.org>
parents:
diff changeset
1035 @cindex LaTeX core
Dave Love <fx@gnu.org>
parents:
diff changeset
1036 @code{figure}, @code{figure*}, @code{table}, @code{table*}, @code{equation},
Dave Love <fx@gnu.org>
parents:
diff changeset
1037 @code{eqnarray}, @code{enumerate}, the @code{\footnote} macro (this is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1038 the LaTeX core stuff)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1039 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1040 @cindex AMS-LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1041 @cindex @code{amsmath}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1042 @cindex LaTeX packages, @code{amsmath}
Dave Love <fx@gnu.org>
parents:
diff changeset
1043 @cindex @code{align}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1044 @cindex @code{gather}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1045 @cindex @code{multline}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1046 @cindex @code{flalign}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1047 @cindex @code{alignat}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1048 @cindex @code{xalignat}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1049 @cindex @code{xxalignat}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1050 @cindex @code{subequations}, AMS-LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1051 @code{align}, @code{gather}, @code{multline}, @code{flalign},
Dave Love <fx@gnu.org>
parents:
diff changeset
1052 @code{alignat}, @code{xalignat}, @code{xxalignat}, @code{subequations}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1053 (from AMS-LaTeX's @file{amsmath.sty} package)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1054 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1055 @cindex @code{endnote}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1056 @cindex LaTeX packages, @code{endnote}
Dave Love <fx@gnu.org>
parents:
diff changeset
1057 @cindex @code{\endnote}, LaTeX macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1058 the @code{\endnote} macro (from @file{endnotes.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1059 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1060 @cindex @code{fancybox}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1061 @cindex LaTeX packages, @code{fancybox}
Dave Love <fx@gnu.org>
parents:
diff changeset
1062 @cindex @code{Beqnarray}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1063 @code{Beqnarray} (@file{fancybox.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1064 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1065 @cindex @code{floatfig}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1066 @cindex LaTeX packages, @code{floatfig}
Dave Love <fx@gnu.org>
parents:
diff changeset
1067 @cindex @code{floatingfig}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1068 @code{floatingfig} (@file{floatfig.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1069 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1070 @cindex @code{longtable}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1071 @cindex LaTeX packages, @code{longtable}
Dave Love <fx@gnu.org>
parents:
diff changeset
1072 @cindex @code{longtable}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1073 @code{longtable} (@file{longtable.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1074 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1075 @cindex @code{picinpar}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1076 @cindex LaTeX packages, @code{picinpar}
Dave Love <fx@gnu.org>
parents:
diff changeset
1077 @cindex @code{figwindow}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1078 @cindex @code{tabwindow}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1079 @code{figwindow}, @code{tabwindow} (@file{picinpar.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1080 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1081 @cindex @code{sidecap}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1082 @cindex LaTeX packages, @code{sidecap}
Dave Love <fx@gnu.org>
parents:
diff changeset
1083 @cindex @code{SCfigure}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1084 @cindex @code{SCtable}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1085 @code{SCfigure}, @code{SCtable} (@file{sidecap.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1086 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1087 @cindex @code{rotating}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1088 @cindex LaTeX packages, @code{rotating}
Dave Love <fx@gnu.org>
parents:
diff changeset
1089 @cindex @code{sidewaysfigure}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1090 @cindex @code{sidewaystable}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1091 @code{sidewaysfigure}, @code{sidewaystable} (@file{rotating.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1092 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1093 @cindex @code{subfig}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1094 @cindex LaTeX packages, @code{subfigure}
Dave Love <fx@gnu.org>
parents:
diff changeset
1095 @cindex @code{subfigure}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1096 @cindex @code{subfigure*}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1097 @code{subfigure}, @code{subfigure*}, the @code{\subfigure} macro
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1098 (@file{subfigure.sty})
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1099 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1100 @cindex @code{supertab}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1101 @cindex LaTeX packages, @code{supertab}
Dave Love <fx@gnu.org>
parents:
diff changeset
1102 @cindex @code{supertabular}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1103 @code{supertabular} (@file{supertab.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1104 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1105 @cindex @code{wrapfig}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1106 @cindex LaTeX packages, @code{wrapfig}
Dave Love <fx@gnu.org>
parents:
diff changeset
1107 @cindex @code{wrapfigure}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1108 @code{wrapfigure} (@file{wrapfig.sty})
Dave Love <fx@gnu.org>
parents:
diff changeset
1109 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
1110
Dave Love <fx@gnu.org>
parents:
diff changeset
1111 If you want to use other labeled environments, defined with
Dave Love <fx@gnu.org>
parents:
diff changeset
1112 @code{\newtheorem}, @b{Ref@TeX{}} needs to be configured to recognize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1113 them (@pxref{Defining Label Environments}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1114
Dave Love <fx@gnu.org>
parents:
diff changeset
1115 @node Defining Label Environments, Reference Info, Builtin Label Environments, Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1116 @section Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1117 @cindex Label environments, defining
Dave Love <fx@gnu.org>
parents:
diff changeset
1118
Dave Love <fx@gnu.org>
parents:
diff changeset
1119 @vindex reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1120 @b{Ref@TeX{}} can be configured to recognize additional labeled
Dave Love <fx@gnu.org>
parents:
diff changeset
1121 environments and macros. This is done with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
1122 @code{reftex-label-alist} (@pxref{Options (Defining Label
Dave Love <fx@gnu.org>
parents:
diff changeset
1123 Environments)}). If you are not familiar with Lisp, you can use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1124 @code{custom} library to configure this rather complex variable. To do
Dave Love <fx@gnu.org>
parents:
diff changeset
1125 this, use
Dave Love <fx@gnu.org>
parents:
diff changeset
1126
Dave Love <fx@gnu.org>
parents:
diff changeset
1127 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1128 @kbd{M-x customize-variable @key{RET} reftex-label-alist @key{RET}}
Dave Love <fx@gnu.org>
parents:
diff changeset
1129 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1130
Dave Love <fx@gnu.org>
parents:
diff changeset
1131 @vindex reftex-label-alist-builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
1132 Here we will discuss a few examples, in order to make things clearer.
Dave Love <fx@gnu.org>
parents:
diff changeset
1133 It can also be instructive to look at the constant
Dave Love <fx@gnu.org>
parents:
diff changeset
1134 @code{reftex-label-alist-builtin} which contains the entries for
Dave Love <fx@gnu.org>
parents:
diff changeset
1135 all the builtin environments and macros (@pxref{Builtin Label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1136 Environments}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1137
Dave Love <fx@gnu.org>
parents:
diff changeset
1138 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1139 * Theorem and Axiom:: Defined with @code{\newenvironment}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1140 * Quick Equation:: When a macro sets the label type.
Dave Love <fx@gnu.org>
parents:
diff changeset
1141 * Figure Wrapper:: When a macro argument is a label.
Dave Love <fx@gnu.org>
parents:
diff changeset
1142 * Adding Magic Words:: Other words for other languages.
Dave Love <fx@gnu.org>
parents:
diff changeset
1143 * Using \eqref:: How to switch to this AMS-LaTeX macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
1144 * Non-Standard Environments:: Environments without \begin and \end
Dave Love <fx@gnu.org>
parents:
diff changeset
1145 * Putting it Together:: How to combine many entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
1146 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1147
Dave Love <fx@gnu.org>
parents:
diff changeset
1148 @node Theorem and Axiom, Quick Equation, , Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1149 @subsection Theorem and Axiom Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1150 @cindex @code{theorem}, newtheorem
Dave Love <fx@gnu.org>
parents:
diff changeset
1151 @cindex @code{axiom}, newtheorem
Dave Love <fx@gnu.org>
parents:
diff changeset
1152 @cindex @code{\newtheorem}
Dave Love <fx@gnu.org>
parents:
diff changeset
1153
Dave Love <fx@gnu.org>
parents:
diff changeset
1154 Suppose you are using @code{\newtheorem} in LaTeX in order to define two
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1155 new environments, @code{theorem} and @code{axiom}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1156
Dave Love <fx@gnu.org>
parents:
diff changeset
1157 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1158 \newtheorem@{axiom@}@{Axiom@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1159 \newtheorem@{theorem@}@{Theorem@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1160 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1161
Dave Love <fx@gnu.org>
parents:
diff changeset
1162 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1163 to be used like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
1164
Dave Love <fx@gnu.org>
parents:
diff changeset
1165 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1166 \begin@{axiom@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1167 \label@{ax:first@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1168 ....
Dave Love <fx@gnu.org>
parents:
diff changeset
1169 \end@{axiom@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1170 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1171
Dave Love <fx@gnu.org>
parents:
diff changeset
1172 So we need to tell @b{Ref@TeX{}} that @code{theorem} and @code{axiom} are new
Dave Love <fx@gnu.org>
parents:
diff changeset
1173 labeled environments which define their own label categories. We can
Dave Love <fx@gnu.org>
parents:
diff changeset
1174 either use Lisp to do this (e.g. in @file{.emacs}) or use the custom
Dave Love <fx@gnu.org>
parents:
diff changeset
1175 library. With Lisp it would look like this
Dave Love <fx@gnu.org>
parents:
diff changeset
1176
Dave Love <fx@gnu.org>
parents:
diff changeset
1177 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1178 (setq reftex-label-alist
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1179 '(("axiom" ?a "ax:" "~\\ref@{%s@}" nil ("axiom" "ax.") -2)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1180 ("theorem" ?h "thr:" "~\\ref@{%s@}" t ("theorem" "th.") -3)))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1181 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1182
Dave Love <fx@gnu.org>
parents:
diff changeset
1183 The type indicator characters @code{?a} and @code{?h} are used for
Dave Love <fx@gnu.org>
parents:
diff changeset
1184 prompts when @b{Ref@TeX{}} queries for a label type. @code{?h}
Dave Love <fx@gnu.org>
parents:
diff changeset
1185 was chosen for @code{theorem} since @code{?t} is already taken by
Dave Love <fx@gnu.org>
parents:
diff changeset
1186 @code{table}. Note that also @code{?s}, @code{?f}, @code{?e},
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1187 @code{?i}, @code{?n} are already used for standard environments.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1188
Dave Love <fx@gnu.org>
parents:
diff changeset
1189 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1190 The labels for Axioms and Theorems will have the prefixes @samp{ax:} and
Dave Love <fx@gnu.org>
parents:
diff changeset
1191 @samp{thr:}, respectively. @xref{AUCTeX}, for information on how
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1192 AUCTeX can use RefTeX to automatically create labels when a new environment
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1193 is inserted into a buffer. Additionally, the following needs to be
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1194 added to one's .emacs file before AUCTeX will automatically create
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1195 labels for the new environments.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1196
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1197 @lisp
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1198 (add-hook 'LaTeX-mode-hook
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1199 (lambda ()
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1200 (LaTeX-add-environments
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1201 '("axiom" LaTeX-env-label)
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1202 '("theorem" LaTeX-env-label))))
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1203 @end lisp
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1204
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1205
Dave Love <fx@gnu.org>
parents:
diff changeset
1206 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1207 The @samp{~\ref@{%s@}} is a format string indicating how to insert
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1208 references to these labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1209
Dave Love <fx@gnu.org>
parents:
diff changeset
1210 @noindent
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1211 The next item indicates how to grab context of the label definition.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1212 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
1213 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1214 @code{t} means to get it from a default location (from the beginning of
Dave Love <fx@gnu.org>
parents:
diff changeset
1215 a @code{\macro} or after the @code{\begin} statement). @code{t} is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1216 @emph{not} a good choice for eqnarray and similar environments.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1217 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1218 @code{nil} means to use the text right after the label definition.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1219 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
1220 For more complex ways of getting context, see the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
1221 @code{reftex-label-alist} (@ref{Options (Defining Label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1222 Environments)}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1223 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
1224
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1225 The following list of strings is used to guess the correct label type
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1226 from the word before point when creating a reference. E.g. if you
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1227 write: @samp{As we have shown in Theorem} and then press @kbd{C-c )},
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1228 @b{Ref@TeX{}} will know that you are looking for a theorem label and
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1229 restrict the menu to only these labels without even asking.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1230
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1231 The final item in each entry is the level at which the environment
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1232 should produce entries in the table of context buffer. If the number is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1233 positive, the environment will produce numbered entries (like
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1234 @code{\section}), if it is negative the entries will be unnumbered (like
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1235 @code{\section*}). Use this only for environments which structure the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1236 document similar to sectioning commands. For everything else, omit the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1237 item.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1238
Dave Love <fx@gnu.org>
parents:
diff changeset
1239 To do the same configuration with @code{customize}, you need to click on
Dave Love <fx@gnu.org>
parents:
diff changeset
1240 the @code{[INS]} button twice to create two templates and fill them in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1241 like this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1242
Dave Love <fx@gnu.org>
parents:
diff changeset
1243 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1244 Reftex Label Alist: [Hide]
Dave Love <fx@gnu.org>
parents:
diff changeset
1245 [INS] [DEL] Package or Detailed : [Value Menu] Detailed:
Dave Love <fx@gnu.org>
parents:
diff changeset
1246 Environment or \macro : [Value Menu] String: axiom
Dave Love <fx@gnu.org>
parents:
diff changeset
1247 Type specification : [Value Menu] Char : a
Dave Love <fx@gnu.org>
parents:
diff changeset
1248 Label prefix string : [Value Menu] String: ax:
Dave Love <fx@gnu.org>
parents:
diff changeset
1249 Label reference format: [Value Menu] String: ~\ref@{%s@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1250 Context method : [Value Menu] After label
Dave Love <fx@gnu.org>
parents:
diff changeset
1251 Magic words:
Dave Love <fx@gnu.org>
parents:
diff changeset
1252 [INS] [DEL] String: axiom
Dave Love <fx@gnu.org>
parents:
diff changeset
1253 [INS] [DEL] String: ax.
Dave Love <fx@gnu.org>
parents:
diff changeset
1254 [INS]
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1255 [X] Make TOC entry : [Value Menu] Level: -2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1256 [INS] [DEL] Package or Detailed : [Value Menu] Detailed:
Dave Love <fx@gnu.org>
parents:
diff changeset
1257 Environment or \macro : [Value Menu] String: theorem
Dave Love <fx@gnu.org>
parents:
diff changeset
1258 Type specification : [Value Menu] Char : h
Dave Love <fx@gnu.org>
parents:
diff changeset
1259 Label prefix string : [Value Menu] String: thr:
Dave Love <fx@gnu.org>
parents:
diff changeset
1260 Label reference format: [Value Menu] String: ~\ref@{%s@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1261 Context method : [Value Menu] Default position
Dave Love <fx@gnu.org>
parents:
diff changeset
1262 Magic words:
Dave Love <fx@gnu.org>
parents:
diff changeset
1263 [INS] [DEL] String: theorem
Dave Love <fx@gnu.org>
parents:
diff changeset
1264 [INS] [DEL] String: theor.
Dave Love <fx@gnu.org>
parents:
diff changeset
1265 [INS] [DEL] String: th.
Dave Love <fx@gnu.org>
parents:
diff changeset
1266 [INS]
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1267 [X] Make TOC entry : [Value Menu] Level: -3
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1268 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1269
Dave Love <fx@gnu.org>
parents:
diff changeset
1270 @vindex reftex-insert-label-flags
Dave Love <fx@gnu.org>
parents:
diff changeset
1271 @vindex reftex-label-menu-flags
Dave Love <fx@gnu.org>
parents:
diff changeset
1272 Depending on how you would like the label insertion and selection for
Dave Love <fx@gnu.org>
parents:
diff changeset
1273 the new environments to work, you might want to add the letters @samp{a}
Dave Love <fx@gnu.org>
parents:
diff changeset
1274 and @samp{h} to some of the flags in the variables
Dave Love <fx@gnu.org>
parents:
diff changeset
1275 @code{reftex-insert-label-flags} (@pxref{Options (Creating Labels)})
Dave Love <fx@gnu.org>
parents:
diff changeset
1276 and @code{reftex-label-menu-flags} (@pxref{Options (Referencing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1277 Labels)}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1278
Dave Love <fx@gnu.org>
parents:
diff changeset
1279
Dave Love <fx@gnu.org>
parents:
diff changeset
1280 @node Quick Equation, Figure Wrapper, Theorem and Axiom , Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1281 @subsection Quick Equation Macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1282 @cindex Quick equation macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1283 @cindex Macros as environment wrappers
Dave Love <fx@gnu.org>
parents:
diff changeset
1284
Dave Love <fx@gnu.org>
parents:
diff changeset
1285 Suppose you would like to have a macro for quick equations. It
Dave Love <fx@gnu.org>
parents:
diff changeset
1286 could be defined like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
1287
Dave Love <fx@gnu.org>
parents:
diff changeset
1288 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1289 \newcommand@{\quickeq@}[1]@{\begin@{equation@} #1 \end@{equation@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1290 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1291
Dave Love <fx@gnu.org>
parents:
diff changeset
1292 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1293 and used like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
1294
Dave Love <fx@gnu.org>
parents:
diff changeset
1295 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1296 Einstein's equation is \quickeq@{E=mc^2 \label@{eq:einstein@}@}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1297 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1298
Dave Love <fx@gnu.org>
parents:
diff changeset
1299 We need to tell @b{Ref@TeX{}} that any label defined in the argument of the
Dave Love <fx@gnu.org>
parents:
diff changeset
1300 @code{\quickeq} is an equation label. Here is how to do this with lisp:
Dave Love <fx@gnu.org>
parents:
diff changeset
1301
Dave Love <fx@gnu.org>
parents:
diff changeset
1302 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1303 (setq reftex-label-alist '(("\\quickeq@{@}" ?e nil nil 1 nil)))
Dave Love <fx@gnu.org>
parents:
diff changeset
1304 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1305
Dave Love <fx@gnu.org>
parents:
diff changeset
1306 The first element in this list is now the macro with empty braces as an
Dave Love <fx@gnu.org>
parents:
diff changeset
1307 @emph{image} of the macro arguments. @code{?e} indicates that this is
Dave Love <fx@gnu.org>
parents:
diff changeset
1308 an equation label, the different @code{nil} elements indicate to use the
Dave Love <fx@gnu.org>
parents:
diff changeset
1309 default values for equations. The @samp{1} as the fifth element
Dave Love <fx@gnu.org>
parents:
diff changeset
1310 indicates that the context of the label definition should be the 1st
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1311 argument of the macro.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1312
Dave Love <fx@gnu.org>
parents:
diff changeset
1313 Here is again how this would look in the customization buffer:
Dave Love <fx@gnu.org>
parents:
diff changeset
1314
Dave Love <fx@gnu.org>
parents:
diff changeset
1315 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1316 Reftex Label Alist: [Hide]
Dave Love <fx@gnu.org>
parents:
diff changeset
1317 [INS] [DEL] Package or Detailed : [Value Menu] Detailed:
Dave Love <fx@gnu.org>
parents:
diff changeset
1318 Environment or \macro : [Value Menu] String: \quickeq@{@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1319 Type specification : [Value Menu] Char : e
Dave Love <fx@gnu.org>
parents:
diff changeset
1320 Label prefix string : [Value Menu] Default
Dave Love <fx@gnu.org>
parents:
diff changeset
1321 Label reference format: [Value Menu] Default
Dave Love <fx@gnu.org>
parents:
diff changeset
1322 Context method : [Value Menu] Macro arg nr: 1
Dave Love <fx@gnu.org>
parents:
diff changeset
1323 Magic words:
Dave Love <fx@gnu.org>
parents:
diff changeset
1324 [INS]
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1325 [ ] Make TOC entry : [Value Menu] No entry
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1326 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1327
Dave Love <fx@gnu.org>
parents:
diff changeset
1328 @node Figure Wrapper, Adding Magic Words, Quick Equation, Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1329 @subsection Figure Wrapping Macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1330 @cindex Macros as environment wrappers
Dave Love <fx@gnu.org>
parents:
diff changeset
1331 @cindex Figure wrapping macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1332
Dave Love <fx@gnu.org>
parents:
diff changeset
1333 Suppose you want to make figures not directly with the figure
Dave Love <fx@gnu.org>
parents:
diff changeset
1334 environment, but with a macro like
Dave Love <fx@gnu.org>
parents:
diff changeset
1335
Dave Love <fx@gnu.org>
parents:
diff changeset
1336 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1337 \newcommand@{\myfig@}[5][tbp]@{%
Dave Love <fx@gnu.org>
parents:
diff changeset
1338 \begin@{figure@}[#1]
Dave Love <fx@gnu.org>
parents:
diff changeset
1339 \epsimp[#5]@{#2@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1340 \caption@{#3@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1341 \label@{#4@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1342 \end@{figure@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1343 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1344
Dave Love <fx@gnu.org>
parents:
diff changeset
1345 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1346 which would be called like
Dave Love <fx@gnu.org>
parents:
diff changeset
1347
Dave Love <fx@gnu.org>
parents:
diff changeset
1348 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1349 \myfig[htp]@{filename@}@{caption text@}@{label@}@{1@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1350 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1351
Dave Love <fx@gnu.org>
parents:
diff changeset
1352 Now we need to tell @b{Ref@TeX{}} that the 4th argument of the
Dave Love <fx@gnu.org>
parents:
diff changeset
1353 @code{\myfig} macro @emph{is itself} a figure label, and where to find
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1354 the context.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1355
Dave Love <fx@gnu.org>
parents:
diff changeset
1356 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1357 (setq reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1358 '(("\\myfig[]@{@}@{@}@{*@}@{@}" ?f nil nil 3)))
Dave Love <fx@gnu.org>
parents:
diff changeset
1359 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1360
Dave Love <fx@gnu.org>
parents:
diff changeset
1361 The empty pairs of brackets indicate the different arguments of the
Dave Love <fx@gnu.org>
parents:
diff changeset
1362 @code{\myfig} macro. The @samp{*} marks the label argument. @code{?f}
Dave Love <fx@gnu.org>
parents:
diff changeset
1363 indicates that this is a figure label which will be listed together with
Dave Love <fx@gnu.org>
parents:
diff changeset
1364 labels from normal figure environments. The @code{nil} entries for
Dave Love <fx@gnu.org>
parents:
diff changeset
1365 prefix and reference format mean to use the defaults for figure labels.
Dave Love <fx@gnu.org>
parents:
diff changeset
1366 The @samp{3} for the context method means to grab the 3rd macro argument
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1367 - the caption.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1368
Dave Love <fx@gnu.org>
parents:
diff changeset
1369 As a side effect of this configuration, @code{reftex-label} will now
Dave Love <fx@gnu.org>
parents:
diff changeset
1370 insert the required naked label (without the @code{\label} macro) when
Dave Love <fx@gnu.org>
parents:
diff changeset
1371 point is directly after the opening parenthesis of a @code{\myfig} macro
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1372 argument.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1373
Dave Love <fx@gnu.org>
parents:
diff changeset
1374 Again, here the configuration in the customization buffer:
Dave Love <fx@gnu.org>
parents:
diff changeset
1375
Dave Love <fx@gnu.org>
parents:
diff changeset
1376 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1377 [INS] [DEL] Package or Detailed : [Value Menu] Detailed:
Dave Love <fx@gnu.org>
parents:
diff changeset
1378 Environment or \macro : [Value Menu] String: \myfig[]@{@}@{@}@{*@}@{@}
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
1379 Type specification : [Value Menu] Char : f
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1380 Label prefix string : [Value Menu] Default
Dave Love <fx@gnu.org>
parents:
diff changeset
1381 Label reference format: [Value Menu] Default
Dave Love <fx@gnu.org>
parents:
diff changeset
1382 Context method : [Value Menu] Macro arg nr: 3
Dave Love <fx@gnu.org>
parents:
diff changeset
1383 Magic words:
Dave Love <fx@gnu.org>
parents:
diff changeset
1384 [INS]
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1385 [ ] Make TOC entry : [Value Menu] No entry
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1386 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1387
Dave Love <fx@gnu.org>
parents:
diff changeset
1388 @node Adding Magic Words, Using \eqref, Figure Wrapper, Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1389 @subsection Adding Magic Words
Dave Love <fx@gnu.org>
parents:
diff changeset
1390 @cindex Magic words
Dave Love <fx@gnu.org>
parents:
diff changeset
1391 @cindex German magic words
Dave Love <fx@gnu.org>
parents:
diff changeset
1392 @cindex Label category
Dave Love <fx@gnu.org>
parents:
diff changeset
1393
Dave Love <fx@gnu.org>
parents:
diff changeset
1394 Sometimes you don't want to define a new label environment or macro, but
Dave Love <fx@gnu.org>
parents:
diff changeset
1395 just change the information associated with a label category. Maybe you
Dave Love <fx@gnu.org>
parents:
diff changeset
1396 want to add some magic words, for another language. Changing only the
Dave Love <fx@gnu.org>
parents:
diff changeset
1397 information associated with a label category is done by giving
Dave Love <fx@gnu.org>
parents:
diff changeset
1398 @code{nil} for the environment name and then specify the items you want
Dave Love <fx@gnu.org>
parents:
diff changeset
1399 to define. Here is an example which adds German magic words to all
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1400 predefined label categories.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1401
Dave Love <fx@gnu.org>
parents:
diff changeset
1402 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1403 (setq reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1404 '((nil ?s nil nil nil ("Kapitel" "Kap." "Abschnitt" "Teil"))
Dave Love <fx@gnu.org>
parents:
diff changeset
1405 (nil ?e nil nil nil ("Gleichung" "Gl."))
Dave Love <fx@gnu.org>
parents:
diff changeset
1406 (nil ?t nil nil nil ("Tabelle"))
Dave Love <fx@gnu.org>
parents:
diff changeset
1407 (nil ?f nil nil nil ("Figur" "Abbildung" "Abb."))
Dave Love <fx@gnu.org>
parents:
diff changeset
1408 (nil ?n nil nil nil ("Anmerkung" "Anm."))
Dave Love <fx@gnu.org>
parents:
diff changeset
1409 (nil ?i nil nil nil ("Punkt"))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1410 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1411
Dave Love <fx@gnu.org>
parents:
diff changeset
1412 @node Using \eqref, Non-Standard Environments, Adding Magic Words, Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1413 @subsection Using @code{\eqref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1414 @cindex @code{\eqref}, AMS-LaTeX macro
Dave Love <fx@gnu.org>
parents:
diff changeset
1415 @cindex AMS-LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1416 @cindex Label category
Dave Love <fx@gnu.org>
parents:
diff changeset
1417
Dave Love <fx@gnu.org>
parents:
diff changeset
1418 Another case where one only wants to change the information associated
Dave Love <fx@gnu.org>
parents:
diff changeset
1419 with the label category is to change the macro which is used for
Dave Love <fx@gnu.org>
parents:
diff changeset
1420 referencing the label. When working with the AMS-LaTeX stuff, you might
Dave Love <fx@gnu.org>
parents:
diff changeset
1421 prefer @code{\eqref} for doing equation references. Here is how to
Dave Love <fx@gnu.org>
parents:
diff changeset
1422 do this:
Dave Love <fx@gnu.org>
parents:
diff changeset
1423
Dave Love <fx@gnu.org>
parents:
diff changeset
1424 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1425 (setq reftex-label-alist '((nil ?e nil "~\\eqref@{%s@}" nil nil)))
Dave Love <fx@gnu.org>
parents:
diff changeset
1426 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1427
Dave Love <fx@gnu.org>
parents:
diff changeset
1428 @b{Ref@TeX{}} has also a predefined symbol for this special purpose. The
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1429 following is equivalent to the line above.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1430
Dave Love <fx@gnu.org>
parents:
diff changeset
1431 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1432 (setq reftex-label-alist '(AMSTeX))
Dave Love <fx@gnu.org>
parents:
diff changeset
1433 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1434
Dave Love <fx@gnu.org>
parents:
diff changeset
1435 Note that this is automatically done by the @file{amsmath.el} style file
Dave Love <fx@gnu.org>
parents:
diff changeset
1436 of AUCTeX (@pxref{Style Files}) - so if you use AUCTeX,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1437 this configuration will not be necessary.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1438
Dave Love <fx@gnu.org>
parents:
diff changeset
1439 @node Non-Standard Environments, Putting it Together, Using \eqref, Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1440 @subsection Non-standard Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1441 @cindex Non-standard environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1442 @cindex Environments without @code{\begin}
Dave Love <fx@gnu.org>
parents:
diff changeset
1443 @cindex Special parser functions
Dave Love <fx@gnu.org>
parents:
diff changeset
1444 @cindex Parser functions, for special environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1445
Dave Love <fx@gnu.org>
parents:
diff changeset
1446 Some LaTeX packages define environment-like structures without using the
Dave Love <fx@gnu.org>
parents:
diff changeset
1447 standard @samp{\begin..\end} structure. @b{Ref@TeX{}} cannot parse
Dave Love <fx@gnu.org>
parents:
diff changeset
1448 these directly, but you can write your own special-purpose parser and
Dave Love <fx@gnu.org>
parents:
diff changeset
1449 use it instead of the name of an environment in an entry for
Dave Love <fx@gnu.org>
parents:
diff changeset
1450 @code{reftex-label-alist}. The function should check if point is
Dave Love <fx@gnu.org>
parents:
diff changeset
1451 currently in the special environment it was written to detect. If so,
Dave Love <fx@gnu.org>
parents:
diff changeset
1452 it must return a buffer position indicating the start of this
Dave Love <fx@gnu.org>
parents:
diff changeset
1453 environment. The return value must be @code{nil} on failure to detect
Dave Love <fx@gnu.org>
parents:
diff changeset
1454 the environment. The function is called with one argument @var{bound}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1455 If non-@code{nil}, @var{bound} is a boundary for backwards searches
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1456 which should be observed. We will discuss two examples.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1457
Dave Love <fx@gnu.org>
parents:
diff changeset
1458 @cindex LaTeX commands, abbreviated
Dave Love <fx@gnu.org>
parents:
diff changeset
1459
Dave Love <fx@gnu.org>
parents:
diff changeset
1460 Some people define abbreviations for
Dave Love <fx@gnu.org>
parents:
diff changeset
1461 environments, like @code{\be} for @code{\begin@{equation@}}, and
Dave Love <fx@gnu.org>
parents:
diff changeset
1462 @code{\ee} for @code{\end@{equation@}}. The parser function would have
Dave Love <fx@gnu.org>
parents:
diff changeset
1463 to search backward for these macros. When the first match is
Dave Love <fx@gnu.org>
parents:
diff changeset
1464 @code{\ee}, point is not in this environment. When the first match is
Dave Love <fx@gnu.org>
parents:
diff changeset
1465 @code{\be}, point is in this environment and the function must return
Dave Love <fx@gnu.org>
parents:
diff changeset
1466 the beginning of the match. To avoid scanning too far, we can also look
46272
2406cf2da1d4 Fix typo.
Juanma Barranquero <lekktu@gmail.com>
parents: 40705
diff changeset
1467 for empty lines which cannot occur inside an equation environment.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1468 Here is the setup:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1469
Dave Love <fx@gnu.org>
parents:
diff changeset
1470 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1471 ;; Setup entry in reftex-label-alist, using all defaults for equations
Dave Love <fx@gnu.org>
parents:
diff changeset
1472 (setq reftex-label-alist '((detect-be-ee ?e nil nil nil nil)))
Dave Love <fx@gnu.org>
parents:
diff changeset
1473
Dave Love <fx@gnu.org>
parents:
diff changeset
1474 (defun detect-be-ee (bound)
Dave Love <fx@gnu.org>
parents:
diff changeset
1475 ;; Search backward for the macros or an empty line
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
1476 (if (re-search-backward
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1477 "\\(^[ \t]*\n\\|\\\\ee\\>\\)\\|\\(\\\\be\\>\\)" bound t)
Dave Love <fx@gnu.org>
parents:
diff changeset
1478 (if (match-beginning 2)
Dave Love <fx@gnu.org>
parents:
diff changeset
1479 (match-beginning 2) ; Return start of environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1480 nil) ; Return nil because env is closed
Dave Love <fx@gnu.org>
parents:
diff changeset
1481 nil)) ; Return nil for not found
Dave Love <fx@gnu.org>
parents:
diff changeset
1482 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1483
Dave Love <fx@gnu.org>
parents:
diff changeset
1484 @cindex @code{linguex}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1485 @cindex LaTeX packages, @code{linguex}
Dave Love <fx@gnu.org>
parents:
diff changeset
1486 A more complex example is the @file{linguex.sty} package which defines
Dave Love <fx@gnu.org>
parents:
diff changeset
1487 list macros @samp{\ex.}, @samp{\a.}, @samp{\b.} etc. for lists which are
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1488 terminated by @samp{\z.} or by an empty line.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1489
Dave Love <fx@gnu.org>
parents:
diff changeset
1490 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1491 \ex. \label@{ex:12@} Some text in an exotic language ...
Dave Love <fx@gnu.org>
parents:
diff changeset
1492 \a. \label@{ex:13@} more stuff
Dave Love <fx@gnu.org>
parents:
diff changeset
1493 \b. \label@{ex:14@} still more stuff
Dave Love <fx@gnu.org>
parents:
diff changeset
1494 \a. List on a deeper level
Dave Love <fx@gnu.org>
parents:
diff changeset
1495 \b. Another item
Dave Love <fx@gnu.org>
parents:
diff changeset
1496 \b. and the third one
Dave Love <fx@gnu.org>
parents:
diff changeset
1497 \z.
Dave Love <fx@gnu.org>
parents:
diff changeset
1498 \b. Third item on this level.
Dave Love <fx@gnu.org>
parents:
diff changeset
1499
Dave Love <fx@gnu.org>
parents:
diff changeset
1500 ... text after the empty line terminating all lists
Dave Love <fx@gnu.org>
parents:
diff changeset
1501 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1502
Dave Love <fx@gnu.org>
parents:
diff changeset
1503 The difficulty is that the @samp{\a.} lists can nest and that an empty
Dave Love <fx@gnu.org>
parents:
diff changeset
1504 line terminates all list levels in one go. So we have to count nesting
Dave Love <fx@gnu.org>
parents:
diff changeset
1505 levels between @samp{\a.} and @samp{\z.}. Here is the implementation
Dave Love <fx@gnu.org>
parents:
diff changeset
1506 for @b{Ref@TeX{}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1507
Dave Love <fx@gnu.org>
parents:
diff changeset
1508 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1509 (setq reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
1510 '((detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex."))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1511
Dave Love <fx@gnu.org>
parents:
diff changeset
1512 (defun detect-linguex (bound)
Dave Love <fx@gnu.org>
parents:
diff changeset
1513 (let ((cnt 0))
Dave Love <fx@gnu.org>
parents:
diff changeset
1514 (catch 'exit
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
1515 (while
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1516 ;; Search backward for all possible delimiters
Dave Love <fx@gnu.org>
parents:
diff changeset
1517 (re-search-backward
Dave Love <fx@gnu.org>
parents:
diff changeset
1518 (concat "\\(^[ \t]*\n\\)\\|\\(\\\\z\\.\\)\\|"
Dave Love <fx@gnu.org>
parents:
diff changeset
1519 "\\(\\ex[ig]?\\.\\)\\|\\(\\\\a\\.\\)")
Dave Love <fx@gnu.org>
parents:
diff changeset
1520 nil t)
Dave Love <fx@gnu.org>
parents:
diff changeset
1521 ;; Check which delimiter was matched.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
1522 (cond
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1523 ((match-beginning 1)
Dave Love <fx@gnu.org>
parents:
diff changeset
1524 ;; empty line terminates all - return nil
Dave Love <fx@gnu.org>
parents:
diff changeset
1525 (throw 'exit nil))
Dave Love <fx@gnu.org>
parents:
diff changeset
1526 ((match-beginning 2)
Dave Love <fx@gnu.org>
parents:
diff changeset
1527 ;; \z. terminates one list level - decrease nesting count
Dave Love <fx@gnu.org>
parents:
diff changeset
1528 (decf cnt))
Dave Love <fx@gnu.org>
parents:
diff changeset
1529 ((match-beginning 3)
Dave Love <fx@gnu.org>
parents:
diff changeset
1530 ;; \ex. : return match unless there was a \z. on this level
Dave Love <fx@gnu.org>
parents:
diff changeset
1531 (throw 'exit (if (>= cnt 0) (match-beginning 3) nil)))
Dave Love <fx@gnu.org>
parents:
diff changeset
1532 ((match-beginning 4)
Dave Love <fx@gnu.org>
parents:
diff changeset
1533 ;; \a. : return match when on level 0, otherwise
Dave Love <fx@gnu.org>
parents:
diff changeset
1534 ;; increment nesting count
Dave Love <fx@gnu.org>
parents:
diff changeset
1535 (if (>= cnt 0)
Dave Love <fx@gnu.org>
parents:
diff changeset
1536 (throw 'exit (match-beginning 4))
Dave Love <fx@gnu.org>
parents:
diff changeset
1537 (incf cnt))))))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1538 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1539
Dave Love <fx@gnu.org>
parents:
diff changeset
1540 @node Putting it Together, , Non-Standard Environments, Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
1541 @subsection Putting it all together
Dave Love <fx@gnu.org>
parents:
diff changeset
1542
Dave Love <fx@gnu.org>
parents:
diff changeset
1543 When you have to put several entries into @code{reftex-label-alist}, just
Dave Love <fx@gnu.org>
parents:
diff changeset
1544 put them after each other in a list, or create that many templates in
Dave Love <fx@gnu.org>
parents:
diff changeset
1545 the customization buffer. Here is a lisp example which uses several of
Dave Love <fx@gnu.org>
parents:
diff changeset
1546 the entries described above:
Dave Love <fx@gnu.org>
parents:
diff changeset
1547
Dave Love <fx@gnu.org>
parents:
diff changeset
1548 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1549 (setq reftex-label-alist
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1550 '(("axiom" ?a "ax:" "~\\ref@{%s@}" nil ("axiom" "ax.") -2)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1551 ("theorem" ?h "thr:" "~\\ref@{%s@}" t ("theorem" "theor." "th.") -3)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1552 ("\\quickeq@{@}" ?e nil nil 1 nil)
Dave Love <fx@gnu.org>
parents:
diff changeset
1553 AMSTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1554 ("\\myfig[]@{@}@{@}@{*@}@{@}" ?f nil nil 3)
Dave Love <fx@gnu.org>
parents:
diff changeset
1555 (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex."))))
Dave Love <fx@gnu.org>
parents:
diff changeset
1556 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1557
Dave Love <fx@gnu.org>
parents:
diff changeset
1558 @node Reference Info, xr (LaTeX package), Defining Label Environments, Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1559 @section Reference Info
Dave Love <fx@gnu.org>
parents:
diff changeset
1560 @findex reftex-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
1561 @findex reftex-mouse-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
1562 @cindex Cross-references, displaying
Dave Love <fx@gnu.org>
parents:
diff changeset
1563 @cindex Reference info
Dave Love <fx@gnu.org>
parents:
diff changeset
1564 @cindex Displaying cross-references
Dave Love <fx@gnu.org>
parents:
diff changeset
1565 @cindex Viewing cross-references
Dave Love <fx@gnu.org>
parents:
diff changeset
1566 @kindex C-c &
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
1567 @kindex S-mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1568
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1569 When point is idle for more than @code{reftex-idle-time} seconds on the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1570 argument of a @code{\ref} macro, the echo area will display some
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1571 information about the label referenced there. Note that the information
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1572 is only displayed if the echo area is not occupied by a different
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1573 message.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1574
Dave Love <fx@gnu.org>
parents:
diff changeset
1575 @b{Ref@TeX{}} can also display the label definition corresponding to a
Dave Love <fx@gnu.org>
parents:
diff changeset
1576 @code{\ref} macro, or all reference locations corresponding to a
Dave Love <fx@gnu.org>
parents:
diff changeset
1577 @code{\label} macro. @xref{Viewing Cross-References}, for more
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1578 information.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1579
Dave Love <fx@gnu.org>
parents:
diff changeset
1580 @node xr (LaTeX package), varioref (LaTeX package), Reference Info, Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1581 @section @code{xr}: Cross-Document References
Dave Love <fx@gnu.org>
parents:
diff changeset
1582 @cindex @code{xr}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1583 @cindex LaTeX packages, @code{xr}
Dave Love <fx@gnu.org>
parents:
diff changeset
1584 @cindex @code{\externaldocument}
Dave Love <fx@gnu.org>
parents:
diff changeset
1585 @cindex External documents
Dave Love <fx@gnu.org>
parents:
diff changeset
1586 @cindex References to external documents
Dave Love <fx@gnu.org>
parents:
diff changeset
1587 @cindex Cross-document references
Dave Love <fx@gnu.org>
parents:
diff changeset
1588
Dave Love <fx@gnu.org>
parents:
diff changeset
1589 The LaTeX package @code{xr} makes it possible to create references to
Dave Love <fx@gnu.org>
parents:
diff changeset
1590 labels defined in external documents. The preamble of a document using
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1591 @code{xr} will contain something like this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1592
Dave Love <fx@gnu.org>
parents:
diff changeset
1593 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1594 \usepackage@{xr@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1595 \externaldocument[V1-]@{volume1@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1596 \externaldocument[V3-]@{volume3@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1597 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1598
Dave Love <fx@gnu.org>
parents:
diff changeset
1599 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
1600 and we can make references to any labels defined in these
Dave Love <fx@gnu.org>
parents:
diff changeset
1601 external documents by using the prefixes @samp{V1-} and @samp{V3-},
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1602 respectively.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1603
Dave Love <fx@gnu.org>
parents:
diff changeset
1604 @b{Ref@TeX{}} can be used to create such references as well. Start the
Dave Love <fx@gnu.org>
parents:
diff changeset
1605 referencing process normally, by pressing @kbd{C-c )}. Select a label
Dave Love <fx@gnu.org>
parents:
diff changeset
1606 type if necessary. When you see the label selection buffer, pressing
Dave Love <fx@gnu.org>
parents:
diff changeset
1607 @kbd{x} will switch to the label selection buffer of one of the external
Dave Love <fx@gnu.org>
parents:
diff changeset
1608 documents. You may then select a label as before and @b{Ref@TeX{}} will
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1609 insert it along with the required prefix.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1610
Dave Love <fx@gnu.org>
parents:
diff changeset
1611 For this kind of inter-document cross-references, saving of parsing
Dave Love <fx@gnu.org>
parents:
diff changeset
1612 information and the use of multiple selection buffers can mean a large
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1613 speed-up (@pxref{Optimizations}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1614
Dave Love <fx@gnu.org>
parents:
diff changeset
1615 @node varioref (LaTeX package), fancyref (LaTeX package), xr (LaTeX package), Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1616 @section @code{varioref}: Variable Page References
Dave Love <fx@gnu.org>
parents:
diff changeset
1617 @cindex @code{varioref}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1618 @cindex @code{\vref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1619 @cindex LaTeX packages, @code{varioref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1620 @vindex reftex-vref-is-default
Dave Love <fx@gnu.org>
parents:
diff changeset
1621 @code{varioref} is a frequently used LaTeX package to create
Dave Love <fx@gnu.org>
parents:
diff changeset
1622 cross--references with page information. When you want to make a
Dave Love <fx@gnu.org>
parents:
diff changeset
1623 reference with the @code{\vref} macro, just press the @kbd{v} key in the
Dave Love <fx@gnu.org>
parents:
diff changeset
1624 selection buffer to toggle between @code{\ref} and @code{\vref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1625 (@pxref{Referencing Labels}). The mode line of the selection buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
1626 shows the current status of this switch. If you find that you almost
Dave Love <fx@gnu.org>
parents:
diff changeset
1627 always use @code{\vref}, you may want to make it the default by
Dave Love <fx@gnu.org>
parents:
diff changeset
1628 customizing the variable @code{reftex-vref-is-default}. If this
Dave Love <fx@gnu.org>
parents:
diff changeset
1629 toggling seems too inconvenient, you can also use the command
Dave Love <fx@gnu.org>
parents:
diff changeset
1630 @code{reftex-varioref-vref}@footnote{bind it to @kbd{C-c v}.}.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1631 Or use AUCTeX to create your macros (@pxref{AUCTeX}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1632
Dave Love <fx@gnu.org>
parents:
diff changeset
1633 @node fancyref (LaTeX package), , varioref (LaTeX package), Labels and References
Dave Love <fx@gnu.org>
parents:
diff changeset
1634 @section @code{fancyref}: Fancy Cross References
Dave Love <fx@gnu.org>
parents:
diff changeset
1635 @cindex @code{fancyref}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1636 @cindex @code{\fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1637 @cindex @code{\Fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1638 @cindex LaTeX packages, @code{fancyref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1639 @vindex reftex-fref-is-default
Dave Love <fx@gnu.org>
parents:
diff changeset
1640 @code{fancyref} is a LaTeX package where a macro call like
Dave Love <fx@gnu.org>
parents:
diff changeset
1641 @code{\fref@{@var{fig:map-of-germany}@}} creates not only the number of
Dave Love <fx@gnu.org>
parents:
diff changeset
1642 the referenced counter but also the complete text around it, like
Dave Love <fx@gnu.org>
parents:
diff changeset
1643 @samp{Figure 3 on the preceding page}. In order to make it work you
Dave Love <fx@gnu.org>
parents:
diff changeset
1644 need to use label prefixes like @samp{fig:} consistently - something
Dave Love <fx@gnu.org>
parents:
diff changeset
1645 @b{Ref@TeX{}} does automatically. When you want to make a reference
Dave Love <fx@gnu.org>
parents:
diff changeset
1646 with the @code{\fref} macro, just press the @kbd{V} key in the selection
Dave Love <fx@gnu.org>
parents:
diff changeset
1647 buffer to cycle between @code{\ref}, @code{\fref} and @code{\Fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1648 (@pxref{Referencing Labels}). The mode line of the selection buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
1649 shows the current status of this switch. If this cycling seems
Dave Love <fx@gnu.org>
parents:
diff changeset
1650 inconvenient, you can also use the commands @code{reftex-fancyref-fref}
Dave Love <fx@gnu.org>
parents:
diff changeset
1651 and @code{reftex-fancyref-Fref}@footnote{bind them to @kbd{C-c
Dave Love <fx@gnu.org>
parents:
diff changeset
1652 f} and @kbd{C-c F}.}. Or use AUCTeX to create your macros
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1653 (@pxref{AUCTeX}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1654
Dave Love <fx@gnu.org>
parents:
diff changeset
1655 @node Citations, Index Support, Labels and References, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
1656 @chapter Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1657 @cindex Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1658 @cindex @code{\cite}
Dave Love <fx@gnu.org>
parents:
diff changeset
1659
Dave Love <fx@gnu.org>
parents:
diff changeset
1660 Citations in LaTeX are done with the @code{\cite} macro or variations of
Dave Love <fx@gnu.org>
parents:
diff changeset
1661 it. The argument of the macro is a citation key which identifies an
Dave Love <fx@gnu.org>
parents:
diff changeset
1662 article or book in either a BibTeX database file or in an explicit
Dave Love <fx@gnu.org>
parents:
diff changeset
1663 @code{thebibliography} environment in the document. @b{Ref@TeX{}}'s
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1664 support for citations helps to select the correct key quickly.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1665
Dave Love <fx@gnu.org>
parents:
diff changeset
1666 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1667 * Creating Citations:: How to create them.
Dave Love <fx@gnu.org>
parents:
diff changeset
1668 * Citation Styles:: Natbib, Harvard, Chicago and Co.
Dave Love <fx@gnu.org>
parents:
diff changeset
1669 * Citation Info:: View the corresponding database entry.
Dave Love <fx@gnu.org>
parents:
diff changeset
1670 * Chapterbib and Bibunits:: Multiple bibliographies in a Document.
Dave Love <fx@gnu.org>
parents:
diff changeset
1671 * Citations Outside LaTeX:: How to make citations in Emails etc.
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
1672 * BibTeX Database Subsets:: Extract parts of a big database.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1673 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
1674
Dave Love <fx@gnu.org>
parents:
diff changeset
1675 @node Creating Citations, Citation Styles, , Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1676 @section Creating Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1677 @cindex Creating citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1678 @cindex Citations, creating
Dave Love <fx@gnu.org>
parents:
diff changeset
1679 @findex reftex-citation
Dave Love <fx@gnu.org>
parents:
diff changeset
1680 @kindex C-c [
Dave Love <fx@gnu.org>
parents:
diff changeset
1681 @cindex Selection buffer, citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1682 @cindex Selection process
Dave Love <fx@gnu.org>
parents:
diff changeset
1683
Dave Love <fx@gnu.org>
parents:
diff changeset
1684 In order to create a citation, press @kbd{C-c [}. @b{Ref@TeX{}} then
Dave Love <fx@gnu.org>
parents:
diff changeset
1685 prompts for a regular expression which will be used to search through
Dave Love <fx@gnu.org>
parents:
diff changeset
1686 the database and present the list of matches to choose from in a
Dave Love <fx@gnu.org>
parents:
diff changeset
1687 selection process similar to that for selecting labels
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1688 (@pxref{Referencing Labels}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1689
Dave Love <fx@gnu.org>
parents:
diff changeset
1690 The regular expression uses an extended syntax: @samp{&&} defines a
Dave Love <fx@gnu.org>
parents:
diff changeset
1691 logic @code{and} for regular expressions. For example
Dave Love <fx@gnu.org>
parents:
diff changeset
1692 @samp{Einstein&&Bose} will match all articles which mention
Dave Love <fx@gnu.org>
parents:
diff changeset
1693 Bose-Einstein condensation, or which are co-authored by Bose and
Dave Love <fx@gnu.org>
parents:
diff changeset
1694 Einstein. When entering the regular expression, you can complete on
46918
82d113655734 Minor spelling and grammar corrections.
Paul Eggert <eggert@twinsun.com>
parents: 46684
diff changeset
1695 known citation keys. RefTeX also offers a default when prompting for a
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
1696 regular expression. This default is the word before the cursor or the
46918
82d113655734 Minor spelling and grammar corrections.
Paul Eggert <eggert@twinsun.com>
parents: 46684
diff changeset
1697 word before the current @samp{\cite} command. Sometimes this may be a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1698 good search key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1699
Dave Love <fx@gnu.org>
parents:
diff changeset
1700 @cindex @code{\bibliography}
Dave Love <fx@gnu.org>
parents:
diff changeset
1701 @cindex @code{thebibliography}, LaTeX environment
Dave Love <fx@gnu.org>
parents:
diff changeset
1702 @cindex @code{BIBINPUTS}, environment variable
Dave Love <fx@gnu.org>
parents:
diff changeset
1703 @cindex @code{TEXBIB}, environment variable
Dave Love <fx@gnu.org>
parents:
diff changeset
1704 @b{Ref@TeX{}} prefers to use BibTeX database files specified with a
Dave Love <fx@gnu.org>
parents:
diff changeset
1705 @code{\bibliography} macro to collect its information. Just like
Dave Love <fx@gnu.org>
parents:
diff changeset
1706 BibTeX, it will search for the specified files in the current directory
Dave Love <fx@gnu.org>
parents:
diff changeset
1707 and along the path given in the environment variable @code{BIBINPUTS}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1708 If you do not use BibTeX, but the document contains an explicit
Dave Love <fx@gnu.org>
parents:
diff changeset
1709 @code{thebibliography} environment, @b{Ref@TeX{}} will collect its
Dave Love <fx@gnu.org>
parents:
diff changeset
1710 information from there. Note that in this case the information
Dave Love <fx@gnu.org>
parents:
diff changeset
1711 presented in the selection buffer will just be a copy of relevant
Dave Love <fx@gnu.org>
parents:
diff changeset
1712 @code{\bibitem} entries, not the structured listing available with
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1713 BibTeX database files.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1714
Dave Love <fx@gnu.org>
parents:
diff changeset
1715 @kindex ?
Dave Love <fx@gnu.org>
parents:
diff changeset
1716 In the selection buffer, the following keys provide special commands. A
Dave Love <fx@gnu.org>
parents:
diff changeset
1717 summary of this information is always available from the selection
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1718 process by pressing @kbd{?}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1719
Dave Love <fx@gnu.org>
parents:
diff changeset
1720 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
1721 @tablesubheading{General}
Dave Love <fx@gnu.org>
parents:
diff changeset
1722 @item ?
Dave Love <fx@gnu.org>
parents:
diff changeset
1723 Show a summary of available commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
1724
Dave Love <fx@gnu.org>
parents:
diff changeset
1725 @item 0-9,-
Dave Love <fx@gnu.org>
parents:
diff changeset
1726 Prefix argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
1727
Dave Love <fx@gnu.org>
parents:
diff changeset
1728 @tablesubheading{Moving around}
Dave Love <fx@gnu.org>
parents:
diff changeset
1729 @item n
Dave Love <fx@gnu.org>
parents:
diff changeset
1730 Go to next article.
Dave Love <fx@gnu.org>
parents:
diff changeset
1731
Dave Love <fx@gnu.org>
parents:
diff changeset
1732 @item p
Dave Love <fx@gnu.org>
parents:
diff changeset
1733 Go to previous article.
Dave Love <fx@gnu.org>
parents:
diff changeset
1734
Dave Love <fx@gnu.org>
parents:
diff changeset
1735 @tablesubheading{Access to full database entries}
Dave Love <fx@gnu.org>
parents:
diff changeset
1736 @item @key{SPC}
Dave Love <fx@gnu.org>
parents:
diff changeset
1737 Show the database entry corresponding to the article at point, in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1738 another window. See also the @kbd{f} key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1739
Dave Love <fx@gnu.org>
parents:
diff changeset
1740 @item f
Dave Love <fx@gnu.org>
parents:
diff changeset
1741 Toggle follow mode. When follow mode is active, the other window will
Dave Love <fx@gnu.org>
parents:
diff changeset
1742 always display the full database entry of the current article. This is
Dave Love <fx@gnu.org>
parents:
diff changeset
1743 equivalent to pressing @key{SPC} after each cursor motion. With BibTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1744 entries, follow mode can be rather slow.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1745
Dave Love <fx@gnu.org>
parents:
diff changeset
1746 @tablesubheading{Selecting entries and creating the citation}
Dave Love <fx@gnu.org>
parents:
diff changeset
1747 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
1748 Insert a citation referencing the article at point into the buffer from
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1749 which the selection process was started.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1750
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
1751 @item mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1752 @vindex reftex-highlight-selection
Dave Love <fx@gnu.org>
parents:
diff changeset
1753 Clicking with mouse button 2 on a citation will accept it like @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
1754 would. See also variable @code{reftex-highlight-selection}, @ref{Options
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1755 (Misc)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1756
Dave Love <fx@gnu.org>
parents:
diff changeset
1757 @item m
Dave Love <fx@gnu.org>
parents:
diff changeset
1758 Mark the current entry. When one or several entries are marked,
Dave Love <fx@gnu.org>
parents:
diff changeset
1759 pressing @kbd{a} or @kbd{A} accepts all marked entries. Also,
Dave Love <fx@gnu.org>
parents:
diff changeset
1760 @key{RET} behaves like the @kbd{a} key.
Dave Love <fx@gnu.org>
parents:
diff changeset
1761
Dave Love <fx@gnu.org>
parents:
diff changeset
1762 @item u
Dave Love <fx@gnu.org>
parents:
diff changeset
1763 Unmark a marked entry.
Dave Love <fx@gnu.org>
parents:
diff changeset
1764
Dave Love <fx@gnu.org>
parents:
diff changeset
1765 @item a
Dave Love <fx@gnu.org>
parents:
diff changeset
1766 Accept all (marked) entries in the selection buffer and create a single
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1767 @code{\cite} macro referring to them.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1768
Dave Love <fx@gnu.org>
parents:
diff changeset
1769 @item A
Dave Love <fx@gnu.org>
parents:
diff changeset
1770 Accept all (marked) entries in the selection buffer and create a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1771 separate @code{\cite} macro for each of it.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1772
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1773 @item e
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1774 Create a new BibTeX database file which contains all @i{marked} entries
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1775 in the selection buffer. If no entries are marked, all entries are
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
1776 selected.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1777
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1778 @item E
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1779 Create a new BibTeX database file which contains all @i{unmarked}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1780 entries in the selection buffer. If no entries are marked, all entries
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
1781 are selected.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1782
Dave Love <fx@gnu.org>
parents:
diff changeset
1783 @item @key{TAB}
Dave Love <fx@gnu.org>
parents:
diff changeset
1784 Enter a citation key with completion. This may also be a key which does
Dave Love <fx@gnu.org>
parents:
diff changeset
1785 not yet exist.
Dave Love <fx@gnu.org>
parents:
diff changeset
1786
Dave Love <fx@gnu.org>
parents:
diff changeset
1787 @item .
Dave Love <fx@gnu.org>
parents:
diff changeset
1788 Show insertion point in another window. This is the point from where you
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1789 called @code{reftex-citation}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1790
Dave Love <fx@gnu.org>
parents:
diff changeset
1791 @tablesubheading{Exiting}
Dave Love <fx@gnu.org>
parents:
diff changeset
1792 @item q
Dave Love <fx@gnu.org>
parents:
diff changeset
1793 Exit the selection process without inserting a citation into the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1794 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1795
Dave Love <fx@gnu.org>
parents:
diff changeset
1796 @tablesubheading{Updating the buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
1797
Dave Love <fx@gnu.org>
parents:
diff changeset
1798 @item g
Dave Love <fx@gnu.org>
parents:
diff changeset
1799 Start over with a new regular expression. The full database will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1800 rescanned with the new expression (see also @kbd{r}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1801
Dave Love <fx@gnu.org>
parents:
diff changeset
1802 @c FIXME: Should we use something else here? r is usually rescan!
Dave Love <fx@gnu.org>
parents:
diff changeset
1803 @item r
Dave Love <fx@gnu.org>
parents:
diff changeset
1804 Refine the current selection with another regular expression. This will
Dave Love <fx@gnu.org>
parents:
diff changeset
1805 @emph{not} rescan the entire database, but just the already selected
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1806 entries.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1807
Dave Love <fx@gnu.org>
parents:
diff changeset
1808 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
1809
Dave Love <fx@gnu.org>
parents:
diff changeset
1810 @vindex reftex-select-bib-map
Dave Love <fx@gnu.org>
parents:
diff changeset
1811 In order to define additional commands for this selection process, the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1812 keymap @code{reftex-select-bib-map} may be used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1813
Dave Love <fx@gnu.org>
parents:
diff changeset
1814 @node Citation Styles, Citation Info, Creating Citations, Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1815 @section Citation Styles
Dave Love <fx@gnu.org>
parents:
diff changeset
1816 @cindex Citation styles
Dave Love <fx@gnu.org>
parents:
diff changeset
1817 @cindex Citation styles, @code{natbib}
Dave Love <fx@gnu.org>
parents:
diff changeset
1818 @cindex Citation styles, @code{harvard}
Dave Love <fx@gnu.org>
parents:
diff changeset
1819 @cindex Citation styles, @code{chicago}
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1820 @cindex Citation styles, @code{jurabib}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1821 @cindex @code{natbib}, citation style
Dave Love <fx@gnu.org>
parents:
diff changeset
1822 @cindex @code{harvard}, citation style
Dave Love <fx@gnu.org>
parents:
diff changeset
1823 @cindex @code{chicago}, citation style
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1824 @cindex @code{jurabib}, citation style
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1825
Dave Love <fx@gnu.org>
parents:
diff changeset
1826 @vindex reftex-cite-format
Dave Love <fx@gnu.org>
parents:
diff changeset
1827 The standard LaTeX macro @code{\cite} works well with numeric or simple
Dave Love <fx@gnu.org>
parents:
diff changeset
1828 key citations. To deal with the more complex task of author-year
Dave Love <fx@gnu.org>
parents:
diff changeset
1829 citations as used in many natural sciences, a variety of packages has
Dave Love <fx@gnu.org>
parents:
diff changeset
1830 been developed which define derived forms of the @code{\cite} macro.
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1831 @b{Ref@TeX{}} can be configured to produce these citation macros as well
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1832 by setting the variable @code{reftex-cite-format}. For the most
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1833 commonly used packages (@code{natbib}, @code{harvard}, @code{chicago},
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1834 @code{jurabib}) this may be done from the menu, under
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1835 @code{Ref->Citation Styles}. Since there are usually several macros to
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1836 create the citations, executing @code{reftex-citation} (@kbd{C-c [})
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1837 starts by prompting for the correct macro. For the Natbib style, this
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
1838 looks like this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1839
Dave Love <fx@gnu.org>
parents:
diff changeset
1840 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
1841 SELECT A CITATION FORMAT
Dave Love <fx@gnu.org>
parents:
diff changeset
1842
Dave Love <fx@gnu.org>
parents:
diff changeset
1843 [^M] \cite@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1844 [t] \citet@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1845 [T] \citet*@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1846 [p] \citep@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1847 [P] \citep*@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1848 [e] \citep[e.g.][]@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1849 [s] \citep[see][]@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1850 [a] \citeauthor@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1851 [A] \citeauthor*@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1852 [y] \citeyear@{%l@}
Dave Love <fx@gnu.org>
parents:
diff changeset
1853 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
1854
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1855 @vindex reftex-cite-prompt-optional-args
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1856 If cite formats contain empty paris of square brackets, RefTeX can
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1857 will prompt for values of these optional arguments if you call the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1858 @code{reftex-citation} command with a @kbd{C-u} prefix.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1859 Following the most generic of these packages, @code{natbib}, the builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
1860 citation packages always accept the @kbd{t} key for a @emph{textual}
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
1861 citation (like: @code{Jones et al. (1997) have shown...}) as well as
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1862 the @kbd{p} key for a parenthetical citation (like: @code{As shown
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1863 earlier (Jones et al, 1997)}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1864
Dave Love <fx@gnu.org>
parents:
diff changeset
1865 To make one of these styles the default, customize the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
1866 @code{reftex-cite-format} or put into @file{.emacs}:
Dave Love <fx@gnu.org>
parents:
diff changeset
1867
Dave Love <fx@gnu.org>
parents:
diff changeset
1868 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1869 (setq reftex-cite-format 'natbib)
Dave Love <fx@gnu.org>
parents:
diff changeset
1870 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1871
Dave Love <fx@gnu.org>
parents:
diff changeset
1872 You can also use AUCTeX style files to automatically set the
Dave Love <fx@gnu.org>
parents:
diff changeset
1873 citation style based on the @code{usepackage} commands in a given
Dave Love <fx@gnu.org>
parents:
diff changeset
1874 document. @xref{Style Files}, for information on how to set up the style
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1875 files correctly.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1876
Dave Love <fx@gnu.org>
parents:
diff changeset
1877 @node Citation Info, Chapterbib and Bibunits, Citation Styles, Citations, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
1878 @section Citation Info
Dave Love <fx@gnu.org>
parents:
diff changeset
1879 @cindex Displaying citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1880 @cindex Citations, displaying
Dave Love <fx@gnu.org>
parents:
diff changeset
1881 @cindex Citation info
Dave Love <fx@gnu.org>
parents:
diff changeset
1882 @cindex Viewing citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1883 @kindex C-c &
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
1884 @kindex S-mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1885 @findex reftex-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
1886 @findex reftex-mouse-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
1887
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1888 When point is idle for more than @code{reftex-idle-time} seconds on the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1889 argument of a @code{\cite} macro, the echo area will display some
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1890 information about the article cited there. Note that the information is
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
1891 only displayed if the echo area is not occupied by a different message.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1892
Dave Love <fx@gnu.org>
parents:
diff changeset
1893 @b{Ref@TeX{}} can also display the @code{\bibitem} or BibTeX database
Dave Love <fx@gnu.org>
parents:
diff changeset
1894 entry corresponding to a @code{\cite} macro, or all citation locations
Dave Love <fx@gnu.org>
parents:
diff changeset
1895 corresponding to a @code{\bibitem} or BibTeX database entry.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1896 @xref{Viewing Cross-References}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1897
Dave Love <fx@gnu.org>
parents:
diff changeset
1898 @node Chapterbib and Bibunits, Citations Outside LaTeX, Citation Info, Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
1899 @section Chapterbib and Bibunits
Dave Love <fx@gnu.org>
parents:
diff changeset
1900 @cindex @code{chapterbib}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1901 @cindex @code{bibunits}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
1902 @cindex Bibliographies, multiple
Dave Love <fx@gnu.org>
parents:
diff changeset
1903
Dave Love <fx@gnu.org>
parents:
diff changeset
1904 @code{chapterbib} and @code{bibunits} are two LaTeX packages which
Dave Love <fx@gnu.org>
parents:
diff changeset
1905 produce multiple bibliographies in a document. This is no problem for
Dave Love <fx@gnu.org>
parents:
diff changeset
1906 @b{Ref@TeX{}} as long as all bibliographies use the same BibTeX database
Dave Love <fx@gnu.org>
parents:
diff changeset
1907 files. If they do not, it is best to have each document part in a
Dave Love <fx@gnu.org>
parents:
diff changeset
1908 separate file (as it is required for @code{chapterbib} anyway). Then
Dave Love <fx@gnu.org>
parents:
diff changeset
1909 @b{Ref@TeX{}} will still scan the locally relevant databases correctly. If
Dave Love <fx@gnu.org>
parents:
diff changeset
1910 you have multiple bibliographies within a @emph{single file}, this may
Dave Love <fx@gnu.org>
parents:
diff changeset
1911 or may not be the case.
Dave Love <fx@gnu.org>
parents:
diff changeset
1912
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1913 @node Citations Outside LaTeX, BibTeX Database Subsets, Chapterbib and Bibunits, Citations
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1914 @section Citations outside LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1915 @cindex Citations outside LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1916 @vindex reftex-default-bibliography
Dave Love <fx@gnu.org>
parents:
diff changeset
1917
Dave Love <fx@gnu.org>
parents:
diff changeset
1918 The command @code{reftex-citation} can also be executed outside a LaTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
1919 buffer. This can be useful to reference articles in the mail buffer and
Dave Love <fx@gnu.org>
parents:
diff changeset
1920 other documents. You should @emph{not} enter @code{reftex-mode} for
Dave Love <fx@gnu.org>
parents:
diff changeset
1921 this, just execute the command. The list of BibTeX files will in this
Dave Love <fx@gnu.org>
parents:
diff changeset
1922 case be taken from the variable @code{reftex-default-bibliography}.
Dave Love <fx@gnu.org>
parents:
diff changeset
1923 Setting the variable @code{reftex-cite-format} to the symbol
Dave Love <fx@gnu.org>
parents:
diff changeset
1924 @code{locally} does a decent job of putting all relevant information
Dave Love <fx@gnu.org>
parents:
diff changeset
1925 about a citation directly into the buffer. Here is the lisp code to add
Dave Love <fx@gnu.org>
parents:
diff changeset
1926 the @kbd{C-c [} binding to the mail buffer. It also provides a local
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1927 binding for @code{reftex-cite-format}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1928
Dave Love <fx@gnu.org>
parents:
diff changeset
1929 @lisp
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1930 (add-hook 'mail-setup-hook
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1931 (lambda () (define-key mail-mode-map "\C-c["
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1932 (lambda () (interactive)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1933 (require 'reftex)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1934 (let ((reftex-cite-format 'locally))
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1935 (reftex-citation))))))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1936 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
1937
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1938 @node BibTeX Database Subsets, , Citations Outside LaTeX, Citations
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1939 @section Database Subsets
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1940 @cindex BibTeX database subsets
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1941 @findex reftex-create-bibtex-file
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1942
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1943 @b{Ref@TeX{}} offers two ways to create a new BibTeX database file.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1944
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1945 The first option produces a file which contains only the entries
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1946 actually referenced in the current document. This can be useful if
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1947 the database in only meant for a single document and you want to clean
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1948 it of old and unused ballast. It can also be useful while writing a
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1949 document together with collaborators, in order to avoid sending around
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1950 the entire (possibly very large) database. To create the file, use
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1951 @kbd{M-x reftex-create-bibtex-file}, also available from the menu
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1952 under @code{Ref->Global Actions->Create Bibtex File}. The command will
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1953 prompt for a BibTeX file name and write the extracted entries to that
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1954 file.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1955
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1956 The second option makes use of the selection process started by the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1957 command @kbd{C-c [} (@pxref{Creating Citations}). This command uses a
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1958 regular expression to select entries, and lists them in a formatted
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1959 selection buffer. After pressing the @kbd{e} key (mnemonics: Export),
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1960 the command will prompt for the name of a new BibTeX file and write
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1961 the selected entries to that file. You can also first mark some
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1962 entries in the selection buffer with the @kbd{m} key and then export
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1963 either the @i{marked} entries (with the @kbd{e} key) or the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1964 @i{unmarked} entries (with the @kbd{E} key).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1965
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1966 @node Index Support, Viewing Cross-References, Citations, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
1967 @chapter Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
1968 @cindex Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
1969 @cindex @code{\index}
Dave Love <fx@gnu.org>
parents:
diff changeset
1970
Dave Love <fx@gnu.org>
parents:
diff changeset
1971 LaTeX has builtin support for creating an Index. The LaTeX core
Dave Love <fx@gnu.org>
parents:
diff changeset
1972 supports two different indices, the standard index and a glossary. With
Dave Love <fx@gnu.org>
parents:
diff changeset
1973 the help of special LaTeX packages (@file{multind.sty} or
Dave Love <fx@gnu.org>
parents:
diff changeset
1974 @file{index.sty}), any number of indices can be supported.
Dave Love <fx@gnu.org>
parents:
diff changeset
1975
Dave Love <fx@gnu.org>
parents:
diff changeset
1976 Index entries are created with the @code{\index@{@var{entry}@}} macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
1977 All entries defined in a document are written out to the @file{.aux}
Dave Love <fx@gnu.org>
parents:
diff changeset
1978 file. A separate tool must be used to convert this information into a
Dave Love <fx@gnu.org>
parents:
diff changeset
1979 nicely formatted index. Tools used with LaTeX include @code{MakeIndex}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1980 and @code{xindy}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
1981
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1982 Indexing is a very difficult task. It must follow strict conventions to
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1983 make the index consistent and complete. There are basically two
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1984 approaches one can follow, and both have their merits.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1985
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1986 @enumerate
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1987 @item
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1988 Part of the indexing should already be done with the markup. The
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1989 document structure should be reflected in the index, so when starting
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1990 new sections, the basic topics of the section should be indexed. If the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1991 document contains definitions, theorems or the like, these should all
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1992 correspond to appropriate index entries. This part of the index can
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1993 very well be developed along with the document. Often it is worthwhile
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1994 to define special purpose macros which define an item and at the same
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1995 time make an index entry, possibly with special formatting to make the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1996 reference page in the index bold or underlined. To make @b{Ref@TeX{}}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1997 support for indexing possible, these special macros must be added to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
1998 @b{Ref@TeX{}}'s configuration (@pxref{Defining Index Macros}).
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
1999
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2000 @item
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2001 The rest of the index is often just a collection of where in the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2002 document certain words or phrases are being used. This part is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2003 difficult to develop along with the document, because consistent entries
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2004 for each occurrence are needed and are best selected when the document
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2005 is ready. @b{Ref@TeX{}} supports this with an @emph{index phrases file}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2006 which collects phrases and helps indexing the phrases globally.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2007 @end enumerate
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2008
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2009 Before you start, you need to make sure that @b{Ref@TeX{}} knows about
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2010 the index style being used in the current document. @b{Ref@TeX{}} has
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2011 builtin support for the default @code{\index} and @code{\glossary}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2012 macros. Other LaTeX packages, like the @file{multind} or @file{index}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2013 package, redefine the @code{\index} macro to have an additional
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2014 argument, and @b{Ref@TeX{}} needs to be configured for those. A
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2015 sufficiently new version of AUCTeX (9.10c or later) will do this
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2016 automatically. If you really don't use AUCTeX (you should!), this
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2017 configuration needs to be done by hand with the menu (@code{Ref->Index
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2018 Style}), or globally for all your documents with
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2019
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2020 @lisp
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2021 (setq reftex-index-macros '(multind)) @r{or}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2022 (setq reftex-index-macros '(index))
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2023 @end lisp
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2024
Dave Love <fx@gnu.org>
parents:
diff changeset
2025 @menu
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2026 * Creating Index Entries:: Macros and completion of entries.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2027 * The Index Phrases File:: A special file for global indexing.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2028 * Displaying and Editing the Index:: The index editor.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2029 * Builtin Index Macros:: The index macros RefTeX knows about.
Dave Love <fx@gnu.org>
parents:
diff changeset
2030 * Defining Index Macros:: ... and macros it doesn't.
Dave Love <fx@gnu.org>
parents:
diff changeset
2031 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
2032
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2033 @node Creating Index Entries, The Index Phrases File, , Index Support
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2034 @section Creating Index Entries
Dave Love <fx@gnu.org>
parents:
diff changeset
2035 @cindex Creating index entries
Dave Love <fx@gnu.org>
parents:
diff changeset
2036 @cindex Index entries, creating
Dave Love <fx@gnu.org>
parents:
diff changeset
2037 @kindex C-c <
Dave Love <fx@gnu.org>
parents:
diff changeset
2038 @findex reftex-index
Dave Love <fx@gnu.org>
parents:
diff changeset
2039 @kindex C-c /
Dave Love <fx@gnu.org>
parents:
diff changeset
2040 @findex reftex-index-selection-or-word
Dave Love <fx@gnu.org>
parents:
diff changeset
2041
Dave Love <fx@gnu.org>
parents:
diff changeset
2042 In order to index the current selection or the word at the cursor press
Dave Love <fx@gnu.org>
parents:
diff changeset
2043 @kbd{C-c /} (@code{reftex-index-selection-or-word}). This causes the
Dave Love <fx@gnu.org>
parents:
diff changeset
2044 selection or word @samp{@var{word}} to be replaced with
Dave Love <fx@gnu.org>
parents:
diff changeset
2045 @samp{\index@{@var{word}@}@var{word}}. The macro which is used
Dave Love <fx@gnu.org>
parents:
diff changeset
2046 (@code{\index} by default) can be configured with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
2047 @code{reftex-index-default-macro}. When the command is called with a
Dave Love <fx@gnu.org>
parents:
diff changeset
2048 prefix argument (@kbd{C-u C-c /}), you get a chance to edit the
Dave Love <fx@gnu.org>
parents:
diff changeset
2049 generated index entry. Use this to change the case of the word or to
Dave Love <fx@gnu.org>
parents:
diff changeset
2050 make the entry a subentry, for example by entering
Dave Love <fx@gnu.org>
parents:
diff changeset
2051 @samp{main!sub!@var{word}}. When called with two raw @kbd{C-u} prefixes
Dave Love <fx@gnu.org>
parents:
diff changeset
2052 (@kbd{C-u C-u C-c /}), you will be asked for the index macro as well.
Dave Love <fx@gnu.org>
parents:
diff changeset
2053 When there is nothing selected and no word at point, this command will
Dave Love <fx@gnu.org>
parents:
diff changeset
2054 just call @code{reftex-index}, described below.
Dave Love <fx@gnu.org>
parents:
diff changeset
2055
Dave Love <fx@gnu.org>
parents:
diff changeset
2056 In order to create a general index entry, press @kbd{C-c <}
Dave Love <fx@gnu.org>
parents:
diff changeset
2057 (@code{reftex-index}). @b{Ref@TeX{}} will prompt for one of the
Dave Love <fx@gnu.org>
parents:
diff changeset
2058 available index macros and for its arguments. Completion will be
Dave Love <fx@gnu.org>
parents:
diff changeset
2059 available for the index entry and, if applicable, the index tag. The
Dave Love <fx@gnu.org>
parents:
diff changeset
2060 index tag is a string identifying one of multiple indices. With the
Dave Love <fx@gnu.org>
parents:
diff changeset
2061 @file{multind} and @file{index} packages, this tag is the first argument
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2062 to the redefined @code{\index} macro.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2063
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2064 @node The Index Phrases File, Displaying and Editing the Index, Creating Index Entries, Index Support
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2065 @section The Index Phrases File
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2066 @cindex Index phrase file
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2067 @cindex Phrase file
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2068 @kindex C-c |
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2069 @findex reftex-index-visit-phrases-buffer
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2070 @cindex Macro definition lines, in phrase buffer
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2071
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2072 @b{Ref@TeX{}} maintains a file in which phrases can be collected for
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2073 later indexing. The file is located in the same directory as the master
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2074 file of the document and has the extension @file{.rip} (@b{R}eftex
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2075 @b{I}ndex @b{P}hrases). You can create or visit the file with @kbd{C-c
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2076 |} (@code{reftex-index-visit-phrases-buffer}). If the file is empty it
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2077 is initialized by inserting a file header which contains the definition
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2078 of the available index macros. This list is initialized from
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2079 @code{reftex-index-macros} (@pxref{Defining Index Macros}). You can
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2080 edit the header as needed, but if you define new LaTeX indexing macros,
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2081 don't forget to add them to @code{reftex-index-macros} as well. Here is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2082 a phrase file header example:
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2083
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2084 @example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2085 % -*- mode: reftex-index-phrases -*-
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2086 % Key Macro Format Repeat
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2087 %----------------------------------------------------------
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2088 >>>INDEX_MACRO_DEFINITION: i \index@{%s@} t
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2089 >>>INDEX_MACRO_DEFINITION: I \index*@{%s@} nil
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2090 >>>INDEX_MACRO_DEFINITION: g \glossary@{%s@} t
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2091 >>>INDEX_MACRO_DEFINITION: n \index*[name]@{%s@} nil
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2092 %----------------------------------------------------------
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2093 @end example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2094
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2095 The macro definition lines consist of a unique letter identifying a
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2096 macro, a format string and the @var{repeat} flag, all separated by
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2097 @key{TAB}. The format string shows how the macro is to be applied, the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2098 @samp{%s} will be replaced with the index entry. The repeat flag
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2099 indicates if @var{word} is indexed by the macro as
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2100 @samp{\index@{@var{word}@}} (@var{repeat} = @code{nil}) or as
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2101 @samp{\index@{@var{word}@}@var{word}} (@var{repeat} = @code{t}). In the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2102 above example it is assumed that the macro @code{\index*@{@var{word}@}}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2103 already typesets its argument in the text, so that it is unnecessary to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2104 repeat @var{word} outside the macro.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2105
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2106 @menu
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2107 * Collecting Phrases:: Collecting from document or external.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2108 * Consistency Checks:: Check for duplicates etc.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2109 * Global Indexing:: The interactive indexing process.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2110 @end menu
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2111
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2112 @node Collecting Phrases, Consistency Checks, , The Index Phrases File
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2113 @subsection Collecting Phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2114 @cindex Collecting index phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2115 @cindex Index phrases, collection
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2116 @cindex Phrases, collecting
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2117
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2118 Phrases for indexing can be collected while writing the document. The
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2119 command @kbd{C-c \} (@code{reftex-index-phrase-selection-or-word})
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2120 copies the current selection (if active) or the word near point into the
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2121 phrases buffer. It then selects this buffer, so that the phrase line
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2122 can be edited. To return to the LaTeX document, press @kbd{C-c C-c}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2123 (@code{reftex-index-phrases-save-and-return}).
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2124
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2125 You can also prepare the list of index phrases in a different way and
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2126 copy it into the phrases file. For example you might want to start from
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2127 a word list of the document and remove all words which should not be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2128 indexed.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2129
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2130 The phrase lines in the phrase buffer must have a specific format.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2131 @b{Ref@TeX{}} will use font-lock to indicate if a line has the proper
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2132 format. A phrase line looks like this:
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2133
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2134 @example
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2135 [@var{key}] <TABs> @var{phrase} [<TABs> @var{arg}[&&@var{arg}]... [ || @var{arg}]...]
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2136 @end example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2137
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2138 @code{<TABs>} stands for white space containing at least one @key{TAB}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2139 @var{key} must be at the start of the line and is the character
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2140 identifying one of the macros defined in the file header. It is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2141 optional - when omitted, the first macro definition line in the file
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2142 will be used for this phrase. The @var{phrase} is the phrase to be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2143 searched for when indexing. It may contain several words separated by
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2144 spaces. By default the search phrase is also the text entered as
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2145 argument of the index macro. If you want the index entry to be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2146 different from the search phrase, enter another @key{TAB} and the index
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2147 argument @var{arg}. If you want to have each match produce several
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2148 index entries, separate the different index arguments with @samp{ &&
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2149 }@footnote{@samp{&&} with optional spaces, see
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2150 @code{reftex-index-phrases-logical-and-regexp}.}. If you want to be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2151 able to choose at each match between several different index arguments,
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2152 separate them with @samp{ || }@footnote{@samp{||} with optional spaces,
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2153 see @code{reftex-index-phrases-logical-or-regexp}.}. Here is an
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2154 example:
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2155
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2156 @example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2157 %--------------------------------------------------------------------
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2158 I Sun
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2159 i Planet Planets
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2160 i Vega Stars!Vega
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2161 Jupiter Planets!Jupiter
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2162 i Mars Planets!Mars || Gods!Mars || Chocolate Bars!Mars
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2163 i Pluto Planets!Pluto && Kuiper Belt Objects!Pluto
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2164 @end example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2165
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2166
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2167 So @samp{Sun} will be indexed directly as @samp{\index*@{Sun@}}, while
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2168 @samp{Planet} will be indexed as @samp{\index@{Planets@}Planet}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2169 @samp{Vega} will be indexed as a subitem of @samp{Stars}. The
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2170 @samp{Jupiter} line will also use the @samp{i} macro as it was the first
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2171 macro definition in the file header (see above example). At each
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2172 occurrence of @samp{Mars} you will be able choose between indexing it as
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2173 a subitem of @samp{Planets}, @samp{Gods} or @samp{Chocolate Bars}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2174 Finally, every occurrence of @samp{Pluto} will be indexed as
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2175 @samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2176 and will therefore create two different index entries.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2177
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2178 @node Consistency Checks, Global Indexing, Collecting Phrases, The Index Phrases File
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2179 @subsection Consistency Checks
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2180 @cindex Index phrases, consistency checks
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2181 @cindex Phrases, consistency checks
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2182 @cindex Consistency check for index phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2183
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2184 @kindex C-c C-s
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2185 Before indexing the phrases in the phrases buffer, they should be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2186 checked carefully for consistency. A first step is to sort the phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2187 alphabetically - this is done with the command @kbd{C-c C-s}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2188 (@code{reftex-index-sort-phrases}). It will sort all phrases in the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2189 buffer alphabetically by search phrase. If you want to group certain
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2190 phrases and only sort within the groups, insert empty lines between the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2191 groups. Sorting will only change the sequence of phrases within each
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2192 group (see the variable @code{reftex-index-phrases-sort-in-blocks}).
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2193
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2194 @kindex C-c C-i
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2195 A useful command is @kbd{C-c C-i} (@code{reftex-index-phrases-info})
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2196 which lists information about the phrase at point, including an example
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2197 of how the index entry will look like and the number of expected matches
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2198 in the document.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2199
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2200 @kindex C-c C-t
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2201 Another important check is to find out if there are double or
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2202 overlapping entries in the buffer. For example if you are first
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2203 searching and indexing @samp{Mars} and then @samp{Planet Mars}, the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2204 second phrase will not match because of the index macro inserted before
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2205 @samp{Mars} earlier. The command @kbd{C-c C-t}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2206 (@code{reftex-index-find-next-conflict-phrase}) finds the next phrase in
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2207 the buffer which is either duplicate or a subphrase of another phrase.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2208 In order to check the whole buffer like this, start at the beginning and
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2209 execute this command repeatedly.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2210
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2211 @node Global Indexing, , Consistency Checks, The Index Phrases File
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2212 @subsection Global Indexing
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2213 @cindex Global indexing
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2214 @cindex Indexing, global
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2215 @cindex Indexing, from @file{phrases} buffer
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2216
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2217 Once the index phrases have been collected and organized, you are set
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2218 for global indexing. I recommend to do this only on an otherwise
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2219 finished document. Global indexing starts from the phrases buffer.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2220 There are several commands which start indexing: @kbd{C-c C-x} acts on
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2221 the current phrase line, @kbd{C-c C-r} on all lines in the current
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2222 region and @kbd{C-c C-a} on all phrase lines in the buffer. It is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2223 probably good to do indexing in small chunks since your concentration
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2224 may not last long enough to do everything in one go.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2225
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2226 @b{Ref@TeX{}} will start at the first phrase line and search the phrase
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2227 globally in the whole document. At each match it will stop, compute the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2228 replacement string and offer you the following choices@footnote{Windows
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2229 users: Restrict yourself to the described keys during indexing. Pressing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2230 @key{Help} at the indexing prompt can apparently hang Emacs.}:
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2231
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2232 @table @kbd
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2233 @item y
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2234 Replace this match with the proposed string.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2235 @item n
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2236 Skip this match.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2237 @item !
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2238 Replace this and all further matches in this file.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2239 @item q
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2240 Skip this match, start with next file.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2241 @item Q
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2242 Skip this match, start with next phrase.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2243 @item o
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2244 Select a different indexing macro for this match.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2245 @item 1-9
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2246 Select one of multiple index keys (those separated with @samp{||}).
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2247 @item e
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2248 Edit the replacement text.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2249 @item C-r
40705
421e0a91a1d1 Replace M-C- with C-M-
Eli Zaretskii <eliz@gnu.org>
parents: 39267
diff changeset
2250 Recursive edit. Use @kbd{C-M-c} to return to the indexing process.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2251 @item s
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2252 Save this buffer and ask again about the current match.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2253 @item S
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2254 Save all document buffers and ask again about the current match.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2255 @item C-g
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2256 Abort the indexing process.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2257 @end table
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2258
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2259 The @samp{Find and Index in Document} menu in the phrases buffer also
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2260 lists a few options for the indexing process. The options have
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2261 associated customization variables to set the defaults (@pxref{Options
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2262 (Index Support)}). Here is a short explanation of what the options do:
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2263
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2264 @table @i
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2265 @item Match Whole Words
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2266 When searching for index phrases, make sure whole words are matched.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2267 This should probably always be on.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2268 @item Case Sensitive Search
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2269 Search case sensitively for phrases. I recommend to have this setting
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2270 off, in order to match the capitalized words at the beginning of a
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2271 sentence, and even typos. You can always say @emph{no} at a match you
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2272 do not like.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2273 @item Wrap Long Lines
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2274 Inserting index macros increases the line length. Turn this option on
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2275 to allow @b{Ref@TeX{}} to wrap long lines.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2276 @item Skip Indexed Matches
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2277 When this is on, @b{Ref@TeX{}} will at each match try to figure out if
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2278 this match is already indexed. A match is considered indexed if it is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2279 either the argument of an index macro, or if an index macro is directly
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2280 (without whitespace separation) before or after the match. Index macros
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2281 are those configured in @code{reftex-index-macros}. Intended for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2282 re-indexing a documents after changes have been made.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2283 @end table
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2284
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2285 Even though indexing should be the last thing you do to a document, you
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2286 are bound to make changes afterwards. Indexing then has to be applied
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2287 to the changed regions. The command
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2288 @code{reftex-index-phrases-apply-to-region} is designed for this
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2289 purpose. When called from a LaTeX document with active region, it will
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2290 apply @code{reftex-index-all-phrases} to the current region.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2291
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2292 @node Displaying and Editing the Index, Builtin Index Macros, The Index Phrases File, Index Support
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2293 @section Displaying and Editing the Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2294 @cindex Displaying the Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2295 @cindex Editing the Index
Dave Love <fx@gnu.org>
parents:
diff changeset
2296 @cindex Index entries, creating
Dave Love <fx@gnu.org>
parents:
diff changeset
2297 @cindex Index, displaying
Dave Love <fx@gnu.org>
parents:
diff changeset
2298 @cindex Index, editing
Dave Love <fx@gnu.org>
parents:
diff changeset
2299 @kindex C-c >
Dave Love <fx@gnu.org>
parents:
diff changeset
2300 @findex reftex-display-index
Dave Love <fx@gnu.org>
parents:
diff changeset
2301
Dave Love <fx@gnu.org>
parents:
diff changeset
2302 In order to compile and display the index, press @kbd{C-c >}. If the
Dave Love <fx@gnu.org>
parents:
diff changeset
2303 document uses multiple indices, @b{Ref@TeX{}} will ask you to select
Dave Love <fx@gnu.org>
parents:
diff changeset
2304 one. Then, all index entries will be sorted alphabetically and
Dave Love <fx@gnu.org>
parents:
diff changeset
2305 displayed in a special buffer, the @file{*Index*} buffer. From that
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2306 buffer you can check and edit each entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2307
Dave Love <fx@gnu.org>
parents:
diff changeset
2308 The index can be restricted to the current section or the region. Then
Dave Love <fx@gnu.org>
parents:
diff changeset
2309 only entries in that part of the document will go into the compiled
Dave Love <fx@gnu.org>
parents:
diff changeset
2310 index. To restrict to the current section, use a numeric prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
2311 @samp{2}, thus press @kbd{C-u 2 C-c >}. To restrict to the current
Dave Love <fx@gnu.org>
parents:
diff changeset
2312 region, make the region active and use a numeric prefix @samp{3} (press
Dave Love <fx@gnu.org>
parents:
diff changeset
2313 @kbd{C-u 3 C-c >}). From within the @file{*Index*} buffer the
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2314 restriction can be moved from one section to the next by pressing the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2315 @kbd{<} and @kbd{>} keys.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2316
Dave Love <fx@gnu.org>
parents:
diff changeset
2317 One caveat: @b{Ref@TeX{}} finds the definition point of an index entry
Dave Love <fx@gnu.org>
parents:
diff changeset
2318 by searching near the buffer position where it had found to macro during
Dave Love <fx@gnu.org>
parents:
diff changeset
2319 scanning. If you have several identical index entries in the same
Dave Love <fx@gnu.org>
parents:
diff changeset
2320 buffer and significant changes have shifted the entries around, you must
Dave Love <fx@gnu.org>
parents:
diff changeset
2321 rescan the buffer to ensure the correspondence between the
Dave Love <fx@gnu.org>
parents:
diff changeset
2322 @file{*Index*} buffer and the definition locations. It is therefore
Dave Love <fx@gnu.org>
parents:
diff changeset
2323 advisable to rescan the document (with @kbd{r} or @kbd{C-u r})
Dave Love <fx@gnu.org>
parents:
diff changeset
2324 frequently while editing the index from the @file{*Index*}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2325 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2326
Dave Love <fx@gnu.org>
parents:
diff changeset
2327 @kindex ?
Dave Love <fx@gnu.org>
parents:
diff changeset
2328 Here is a list of special commands available in the @file{*Index*} buffer. A
Dave Love <fx@gnu.org>
parents:
diff changeset
2329 summary of this information is always available by pressing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2330 @kbd{?}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2331
Dave Love <fx@gnu.org>
parents:
diff changeset
2332 @table @kbd
Dave Love <fx@gnu.org>
parents:
diff changeset
2333 @tablesubheading{General}
Dave Love <fx@gnu.org>
parents:
diff changeset
2334 @item ?
Dave Love <fx@gnu.org>
parents:
diff changeset
2335 Display a summary of commands.
Dave Love <fx@gnu.org>
parents:
diff changeset
2336
Dave Love <fx@gnu.org>
parents:
diff changeset
2337 @item 0-9, -
Dave Love <fx@gnu.org>
parents:
diff changeset
2338 Prefix argument.
Dave Love <fx@gnu.org>
parents:
diff changeset
2339
Dave Love <fx@gnu.org>
parents:
diff changeset
2340 @tablesubheading{Moving around}
Dave Love <fx@gnu.org>
parents:
diff changeset
2341 @item ! A..Z
Dave Love <fx@gnu.org>
parents:
diff changeset
2342 Pressing any capital letter will jump to the corresponding section in
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2343 the @file{*Index*} buffer. The exclamation mark is special and jumps to
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2344 the first entries alphabetically sorted below @samp{A}. These are
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2345 usually non-alphanumeric characters.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2346 @item n
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2347 Go to next entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2348 @item p
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2349 Go to previous entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2350
Dave Love <fx@gnu.org>
parents:
diff changeset
2351 @tablesubheading{Access to document locations}
Dave Love <fx@gnu.org>
parents:
diff changeset
2352 @item @key{SPC}
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2353 Show the place in the document where this index entry is defined.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2354
Dave Love <fx@gnu.org>
parents:
diff changeset
2355 @item @key{TAB}
Dave Love <fx@gnu.org>
parents:
diff changeset
2356 Go to the definition of the current index entry in another
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2357 window.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2358
Dave Love <fx@gnu.org>
parents:
diff changeset
2359 @item @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
2360 Go to the definition of the current index entry and hide the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2361 @file{*Index*} buffer window.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2362
Dave Love <fx@gnu.org>
parents:
diff changeset
2363 @item f
Dave Love <fx@gnu.org>
parents:
diff changeset
2364 @vindex reftex-index-follow-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
2365 @vindex reftex-revisit-to-follow
Dave Love <fx@gnu.org>
parents:
diff changeset
2366 Toggle follow mode. When follow mode is active, the other window will
Dave Love <fx@gnu.org>
parents:
diff changeset
2367 always show the location corresponding to the line in the @file{*Index*}
Dave Love <fx@gnu.org>
parents:
diff changeset
2368 buffer at point. This is similar to pressing @key{SPC} after each
Dave Love <fx@gnu.org>
parents:
diff changeset
2369 cursor motion. The default for this flag can be set with the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
2370 @code{reftex-index-follow-mode}. Note that only context in files
Dave Love <fx@gnu.org>
parents:
diff changeset
2371 already visited is shown. @b{Ref@TeX{}} will not visit a file just for
Dave Love <fx@gnu.org>
parents:
diff changeset
2372 follow mode. See, however, the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2373 @code{reftex-revisit-to-follow}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2374
Dave Love <fx@gnu.org>
parents:
diff changeset
2375 @tablesubheading{Entry editing}
Dave Love <fx@gnu.org>
parents:
diff changeset
2376 @item e
Dave Love <fx@gnu.org>
parents:
diff changeset
2377 Edit the current index entry. In the minibuffer, you can edit the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2378 index macro which defines this entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2379
Dave Love <fx@gnu.org>
parents:
diff changeset
2380 @item C-k
Dave Love <fx@gnu.org>
parents:
diff changeset
2381 Kill the index entry. Currently not implemented because I don't know
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2382 how to implement an @code{undo} function for this.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2383
Dave Love <fx@gnu.org>
parents:
diff changeset
2384 @item *
Dave Love <fx@gnu.org>
parents:
diff changeset
2385 Edit the @var{key} part of the entry. This is the initial part of the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2386 entry which determines the location of the entry in the index.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2387
Dave Love <fx@gnu.org>
parents:
diff changeset
2388 @item |
Dave Love <fx@gnu.org>
parents:
diff changeset
2389 Edit the @var{attribute} part of the entry. This is the part after the
Dave Love <fx@gnu.org>
parents:
diff changeset
2390 vertical bar. With @code{MakeIndex}, this part is an encapsulating
Dave Love <fx@gnu.org>
parents:
diff changeset
2391 macro. With @code{xindy}, it is called @emph{attribute} and is a
Dave Love <fx@gnu.org>
parents:
diff changeset
2392 property of the index entry that can lead to special formatting. When
Dave Love <fx@gnu.org>
parents:
diff changeset
2393 called with @kbd{C-u} prefix, kill the entire @var{attribute}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2394 part.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2395
Dave Love <fx@gnu.org>
parents:
diff changeset
2396 @item @@
Dave Love <fx@gnu.org>
parents:
diff changeset
2397 Edit the @var{visual} part of the entry. This is the part after the
Dave Love <fx@gnu.org>
parents:
diff changeset
2398 @samp{@@} which is used by @code{MakeIndex} to change the visual
Dave Love <fx@gnu.org>
parents:
diff changeset
2399 appearance of the entry in the index. When called with @kbd{C-u}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2400 prefix, kill the entire @var{visual} part.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2401
Dave Love <fx@gnu.org>
parents:
diff changeset
2402 @item (
Dave Love <fx@gnu.org>
parents:
diff changeset
2403 Toggle the beginning of page range property @samp{|(} of the
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2404 entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2405
Dave Love <fx@gnu.org>
parents:
diff changeset
2406 @item )
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2407 Toggle the end of page range property @samp{|)} of the entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2408
Dave Love <fx@gnu.org>
parents:
diff changeset
2409 @item _
Dave Love <fx@gnu.org>
parents:
diff changeset
2410 Make the current entry a subentry. This command will prompt for the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2411 superordinate entry and insert it.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2412
Dave Love <fx@gnu.org>
parents:
diff changeset
2413 @item ^
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2414 Remove the highest superordinate entry. If the current entry is a
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2415 subitem (@samp{aaa!bbb!ccc}), this function moves it up the hierarchy
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2416 (@samp{bbb!ccc}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2417
Dave Love <fx@gnu.org>
parents:
diff changeset
2418 @tablesubheading{Exiting}
Dave Love <fx@gnu.org>
parents:
diff changeset
2419 @item q
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2420 Hide the @file{*Index*} buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2421
Dave Love <fx@gnu.org>
parents:
diff changeset
2422 @item k
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2423 Kill the @file{*Index*} buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2424
Dave Love <fx@gnu.org>
parents:
diff changeset
2425 @item C-c =
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2426 Switch to the Table of Contents buffer of this document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2427
Dave Love <fx@gnu.org>
parents:
diff changeset
2428 @tablesubheading{Controlling what gets displayed}
Dave Love <fx@gnu.org>
parents:
diff changeset
2429 @item c
Dave Love <fx@gnu.org>
parents:
diff changeset
2430 @vindex reftex-index-include-context
Dave Love <fx@gnu.org>
parents:
diff changeset
2431 Toggle the display of short context in the @file{*Index*} buffer. The
Dave Love <fx@gnu.org>
parents:
diff changeset
2432 default for this flag can be set with the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2433 @code{reftex-index-include-context}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2434
Dave Love <fx@gnu.org>
parents:
diff changeset
2435 @item @}
Dave Love <fx@gnu.org>
parents:
diff changeset
2436 Restrict the index to a single document section. The corresponding
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2437 section number will be displayed in the @code{R<>} indicator in the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2438 mode line and in the header of the @file{*Index*} buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2439
Dave Love <fx@gnu.org>
parents:
diff changeset
2440 @item @{
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2441 Widen the index to contain all entries of the document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2442
Dave Love <fx@gnu.org>
parents:
diff changeset
2443 @item <
Dave Love <fx@gnu.org>
parents:
diff changeset
2444 When the index is currently restricted, move the restriction to the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2445 previous section.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2446
Dave Love <fx@gnu.org>
parents:
diff changeset
2447 @item >
Dave Love <fx@gnu.org>
parents:
diff changeset
2448 When the index is currently restricted, move the restriction to the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2449 next section.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2450
Dave Love <fx@gnu.org>
parents:
diff changeset
2451 @tablesubheading{Updating the buffer}
Dave Love <fx@gnu.org>
parents:
diff changeset
2452 @item g
Dave Love <fx@gnu.org>
parents:
diff changeset
2453 Rebuild the @file{*Index*} buffer. This does @emph{not} rescan the
Dave Love <fx@gnu.org>
parents:
diff changeset
2454 document. However, it sorts the entries again, so that edited entries
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2455 will move to the correct position.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2456
Dave Love <fx@gnu.org>
parents:
diff changeset
2457 @item r
Dave Love <fx@gnu.org>
parents:
diff changeset
2458 @vindex reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
2459 Reparse the LaTeX document and rebuild the @file{*Index*} buffer. When
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2460 @code{reftex-enable-partial-scans} is non-@code{nil}, rescan only the file this
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2461 location is defined in, not the entire document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2462
Dave Love <fx@gnu.org>
parents:
diff changeset
2463 @item C-u r
Dave Love <fx@gnu.org>
parents:
diff changeset
2464 Reparse the @emph{entire} LaTeX document and rebuild the @file{*Index*}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2465 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2466
Dave Love <fx@gnu.org>
parents:
diff changeset
2467 @item s
Dave Love <fx@gnu.org>
parents:
diff changeset
2468 Switch to a different index (for documents with multiple
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2469 indices).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2470 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2471
Dave Love <fx@gnu.org>
parents:
diff changeset
2472
Dave Love <fx@gnu.org>
parents:
diff changeset
2473 @node Builtin Index Macros, Defining Index Macros, Displaying and Editing the Index, Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
2474 @section Builtin Index Macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2475 @cindex Builtin index macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2476 @cindex Index macros, builtin
Dave Love <fx@gnu.org>
parents:
diff changeset
2477 @vindex reftex-index-macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2478 @cindex @code{multind}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
2479 @cindex @code{index}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
2480 @cindex LaTeX packages, @code{multind}
Dave Love <fx@gnu.org>
parents:
diff changeset
2481 @cindex LaTeX packages, @code{index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2482
Dave Love <fx@gnu.org>
parents:
diff changeset
2483 @b{Ref@TeX{}} by default recognizes the @code{\index} and
Dave Love <fx@gnu.org>
parents:
diff changeset
2484 @code{\glossary} macros which are defined in the LaTeX core. It has
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2485 also builtin support for the re-implementations of @code{\index}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2486 in the @file{multind} and @file{index} packages. However, since
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2487 the different definitions of the @code{\index} macro are incompatible,
Dave Love <fx@gnu.org>
parents:
diff changeset
2488 you will have to explicitly specify the index style used.
Dave Love <fx@gnu.org>
parents:
diff changeset
2489 @xref{Creating Index Entries}, for information on how to do that.
Dave Love <fx@gnu.org>
parents:
diff changeset
2490
Dave Love <fx@gnu.org>
parents:
diff changeset
2491 @node Defining Index Macros, , Builtin Index Macros, Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
2492 @section Defining Index Macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2493 @cindex Defining Index Macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2494 @cindex Index macros, defining
Dave Love <fx@gnu.org>
parents:
diff changeset
2495 @vindex reftex-index-macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2496
Dave Love <fx@gnu.org>
parents:
diff changeset
2497 When writing a document with an index you will probably define
Dave Love <fx@gnu.org>
parents:
diff changeset
2498 additional macros which make entries into the index.
Dave Love <fx@gnu.org>
parents:
diff changeset
2499 Let's look at an example.
Dave Love <fx@gnu.org>
parents:
diff changeset
2500
Dave Love <fx@gnu.org>
parents:
diff changeset
2501 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
2502 \newcommand@{\ix@}[1]@{#1\index@{#1@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2503 \newcommand@{\nindex@}[1]@{\textit@{#1@}\index[name]@{#1@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2504 \newcommand@{\astobj@}[1]@{\index@{Astronomical Objects!#1@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2505 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
2506
Dave Love <fx@gnu.org>
parents:
diff changeset
2507 The first macro @code{\ix} typesets its argument in the text and places
Dave Love <fx@gnu.org>
parents:
diff changeset
2508 it into the index. The second macro @code{\nindex} typesets its
Dave Love <fx@gnu.org>
parents:
diff changeset
2509 argument in the text and places it into a separate index with the tag
Dave Love <fx@gnu.org>
parents:
diff changeset
2510 @samp{name}@footnote{We are using the syntax of the @file{index} package
Dave Love <fx@gnu.org>
parents:
diff changeset
2511 here.}. The last macro also places its argument into the index, but as
Dave Love <fx@gnu.org>
parents:
diff changeset
2512 subitems under the main index entry @samp{Astronomical Objects}. Here
Dave Love <fx@gnu.org>
parents:
diff changeset
2513 is how to make @b{Ref@TeX{}} recognize and correctly interpret these
Dave Love <fx@gnu.org>
parents:
diff changeset
2514 macros, first with Emacs Lisp.
Dave Love <fx@gnu.org>
parents:
diff changeset
2515
Dave Love <fx@gnu.org>
parents:
diff changeset
2516 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2517 (setq reftex-index-macros
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2518 '(("\\ix@{*@}" "idx" ?x "" nil nil)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2519 ("\\nindex@{*@}" "name" ?n "" nil nil)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2520 ("\\astobj@{*@}" "idx" ?o "Astronomical Objects!" nil t)))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2521 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2522
Dave Love <fx@gnu.org>
parents:
diff changeset
2523 Note that the index tag is @samp{idx} for the main index, and
Dave Love <fx@gnu.org>
parents:
diff changeset
2524 @samp{name} for the name index. @samp{idx} and @samp{glo} are reserved
Dave Love <fx@gnu.org>
parents:
diff changeset
2525 for the default index and for the glossary.
Dave Love <fx@gnu.org>
parents:
diff changeset
2526
Dave Love <fx@gnu.org>
parents:
diff changeset
2527 The character arguments @code{?x}, @code{?n}, and @code{?o} are for
Dave Love <fx@gnu.org>
parents:
diff changeset
2528 quick identification of these macros when @b{Ref@TeX{}} inserts new
Dave Love <fx@gnu.org>
parents:
diff changeset
2529 index entries with @code{reftex-index}. These codes need to be
Dave Love <fx@gnu.org>
parents:
diff changeset
2530 unique. @code{?i}, @code{?I}, and @code{?g} are reserved for the
Dave Love <fx@gnu.org>
parents:
diff changeset
2531 @code{\index}, @code{\index*}, and @code{\glossary} macros,
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2532 respectively.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2533
Dave Love <fx@gnu.org>
parents:
diff changeset
2534 The following string is empty unless your macro adds a superordinate
Dave Love <fx@gnu.org>
parents:
diff changeset
2535 entry to the index key - this is the case for the @code{\astobj} macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
2536
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2537 The next entry can be a hook function to exclude certain matches, it
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2538 almost always can be @code{nil}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2539
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2540 The final element in the list indicates if the text being indexed needs
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2541 to be repeated outside the macro. For the normal index macros, this
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2542 should be @code{t}. Only if the macro typesets the entry in the text
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2543 (like @code{\ix} and @code{\nindex} in the example do), this should be
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2544 @code{nil}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2545
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2546 To do the same thing with customize, you need to fill in the templates
Dave Love <fx@gnu.org>
parents:
diff changeset
2547 like this:
Dave Love <fx@gnu.org>
parents:
diff changeset
2548
Dave Love <fx@gnu.org>
parents:
diff changeset
2549 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
2550 Repeat:
Dave Love <fx@gnu.org>
parents:
diff changeset
2551 [INS] [DEL] List:
Dave Love <fx@gnu.org>
parents:
diff changeset
2552 Macro with args: \ix@{*@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2553 Index Tag : [Value Menu] String: idx
Dave Love <fx@gnu.org>
parents:
diff changeset
2554 Access Key : x
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2555 Key Prefix :
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2556 Exclusion hook : nil
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2557 Repeat Outside : [Toggle] off (nil)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2558 [INS] [DEL] List:
Dave Love <fx@gnu.org>
parents:
diff changeset
2559 Macro with args: \nindex@{*@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2560 Index Tag : [Value Menu] String: name
Dave Love <fx@gnu.org>
parents:
diff changeset
2561 Access Key : n
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2562 Key Prefix :
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2563 Exclusion hook : nil
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2564 Repeat Outside : [Toggle] off (nil)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2565 [INS] [DEL] List:
Dave Love <fx@gnu.org>
parents:
diff changeset
2566 Macro with args: \astobj@{*@}
Dave Love <fx@gnu.org>
parents:
diff changeset
2567 Index Tag : [Value Menu] String: idx
Dave Love <fx@gnu.org>
parents:
diff changeset
2568 Access Key : o
Dave Love <fx@gnu.org>
parents:
diff changeset
2569 Key Prefix : Astronomical Objects!
Dave Love <fx@gnu.org>
parents:
diff changeset
2570 Exclusion hook : nil
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2571 Repeat Outside : [Toggle] on (non-nil)
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2572 [INS]
Dave Love <fx@gnu.org>
parents:
diff changeset
2573 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
2574
Dave Love <fx@gnu.org>
parents:
diff changeset
2575 With the macro @code{\ix} defined, you may want to change the default
Dave Love <fx@gnu.org>
parents:
diff changeset
2576 macro used for indexing a text phrase (@pxref{Creating Index Entries}).
Dave Love <fx@gnu.org>
parents:
diff changeset
2577 This would be done like this
Dave Love <fx@gnu.org>
parents:
diff changeset
2578
Dave Love <fx@gnu.org>
parents:
diff changeset
2579 @lisp
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2580 (setq reftex-index-default-macro '(?x "idx"))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2581 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2582
Dave Love <fx@gnu.org>
parents:
diff changeset
2583 which specifies that the macro identified with the character @code{?x} (the
Dave Love <fx@gnu.org>
parents:
diff changeset
2584 @code{\ix} macro) should be used for indexing phrases and words already
Dave Love <fx@gnu.org>
parents:
diff changeset
2585 in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}).
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2586 The index tag is "idx".
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2587
Dave Love <fx@gnu.org>
parents:
diff changeset
2588 @node Viewing Cross-References, RefTeXs Menu, Index Support, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
2589 @chapter Viewing Cross--References
Dave Love <fx@gnu.org>
parents:
diff changeset
2590 @findex reftex-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
2591 @findex reftex-mouse-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
2592 @kindex C-c &
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2593 @kindex S-mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2594
Dave Love <fx@gnu.org>
parents:
diff changeset
2595 @b{Ref@TeX{}} can display cross--referencing information. This means,
Dave Love <fx@gnu.org>
parents:
diff changeset
2596 if two document locations are linked, @b{Ref@TeX{}} can display the
Dave Love <fx@gnu.org>
parents:
diff changeset
2597 matching location(s) in another window. The @code{\label} and @code{\ref}
Dave Love <fx@gnu.org>
parents:
diff changeset
2598 macros are one way of establishing such a link. Also, a @code{\cite}
Dave Love <fx@gnu.org>
parents:
diff changeset
2599 macro is linked to the corresponding @code{\bibitem} macro or a BibTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2600 database entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2601
Dave Love <fx@gnu.org>
parents:
diff changeset
2602 The feature is invoked by pressing @kbd{C-c &}
Dave Love <fx@gnu.org>
parents:
diff changeset
2603 (@code{reftex-view-crossref}) while point is on the @var{key} argument
Dave Love <fx@gnu.org>
parents:
diff changeset
2604 of a macro involved in cross--referencing. You can also click with
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2605 @kbd{S-mouse-2} on the macro argument. Here is what will happen for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2606 individual classes of macros:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2607
Dave Love <fx@gnu.org>
parents:
diff changeset
2608 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
2609
Dave Love <fx@gnu.org>
parents:
diff changeset
2610 @item @code{\ref}
Dave Love <fx@gnu.org>
parents:
diff changeset
2611 @cindex @code{\ref}
Dave Love <fx@gnu.org>
parents:
diff changeset
2612 Display the corresponding label definition. All usual
Dave Love <fx@gnu.org>
parents:
diff changeset
2613 variants@footnote{all macros that start with @samp{ref} or end with
Dave Love <fx@gnu.org>
parents:
diff changeset
2614 @samp{ref} or @samp{refrange}} of the @code{\ref} macro are active for
Dave Love <fx@gnu.org>
parents:
diff changeset
2615 cross--reference display. This works also for labels defined in an
Dave Love <fx@gnu.org>
parents:
diff changeset
2616 external document when the current document refers to them through the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2617 @code{xr} interface (@pxref{xr (LaTeX package)}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2618
Dave Love <fx@gnu.org>
parents:
diff changeset
2619 @item @code{\label}
Dave Love <fx@gnu.org>
parents:
diff changeset
2620 @cindex @code{\label}
Dave Love <fx@gnu.org>
parents:
diff changeset
2621 @vindex reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
2622 Display a document location which references this label. Pressing
Dave Love <fx@gnu.org>
parents:
diff changeset
2623 @kbd{C-c &} several times moves through the entire document and finds
Dave Love <fx@gnu.org>
parents:
diff changeset
2624 all locations. Not only the @code{\label} macro but also other macros
Dave Love <fx@gnu.org>
parents:
diff changeset
2625 with label arguments (as configured with @code{reftex-label-alist}) are
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2626 active for cross--reference display.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2627
Dave Love <fx@gnu.org>
parents:
diff changeset
2628 @item @code{\cite}
Dave Love <fx@gnu.org>
parents:
diff changeset
2629 @cindex @code{\cite}
Dave Love <fx@gnu.org>
parents:
diff changeset
2630 Display the corresponding BibTeX database entry or @code{\bibitem}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2631 All usual variants@footnote{all macros that either start or end with
Dave Love <fx@gnu.org>
parents:
diff changeset
2632 @samp{cite}} of the @code{\cite} macro are active for cross--reference
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2633 display.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2634
Dave Love <fx@gnu.org>
parents:
diff changeset
2635 @item @code{\bibitem}
Dave Love <fx@gnu.org>
parents:
diff changeset
2636 @cindex @code{\bibitem}
Dave Love <fx@gnu.org>
parents:
diff changeset
2637 Display a document location which cites this article. Pressing
Dave Love <fx@gnu.org>
parents:
diff changeset
2638 @kbd{C-c &} several times moves through the entire document and finds
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2639 all locations.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2640
Dave Love <fx@gnu.org>
parents:
diff changeset
2641 @item BibTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
2642 @cindex BibTeX buffer, viewing cite locations from
Dave Love <fx@gnu.org>
parents:
diff changeset
2643 @cindex Viewing cite locations from BibTeX buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
2644 @kbd{C-c &} is also active in BibTeX buffers. All locations in a
Dave Love <fx@gnu.org>
parents:
diff changeset
2645 document where the database entry at point is cited will be displayed.
Dave Love <fx@gnu.org>
parents:
diff changeset
2646 On first use, @b{Ref@TeX{}} will prompt for a buffer which belongs to
Dave Love <fx@gnu.org>
parents:
diff changeset
2647 the document you want to search. Subsequent calls will use the same
Dave Love <fx@gnu.org>
parents:
diff changeset
2648 document, until you break this link with a prefix argument to @kbd{C-c
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2649 &}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2650
Dave Love <fx@gnu.org>
parents:
diff changeset
2651 @item @code{\index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2652 @cindex @code{\index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2653 Display other locations in the document which are marked by an index
Dave Love <fx@gnu.org>
parents:
diff changeset
2654 macro with the same key argument. Along with the standard @code{\index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2655 and @code{\glossary} macros, all macros configured in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2656 @code{reftex-index-macros} will be recognized.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2657 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
2658
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2659 @vindex reftex-view-crossref-extra
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2660 While the display of cross referencing information for the above
Dave Love <fx@gnu.org>
parents:
diff changeset
2661 mentioned macros is hard--coded, you can configure additional relations
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2662 in the variable @code{reftex-view-crossref-extra}.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2663
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2664 @iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
2665 @chapter All the Rest
Dave Love <fx@gnu.org>
parents:
diff changeset
2666 @end iftex
Dave Love <fx@gnu.org>
parents:
diff changeset
2667
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2668 @node RefTeXs Menu, Key Bindings, Viewing Cross-References, Top
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2669 @section @b{Ref@TeX{}}'s Menu
Dave Love <fx@gnu.org>
parents:
diff changeset
2670 @cindex RefTeXs Menu
Dave Love <fx@gnu.org>
parents:
diff changeset
2671 @cindex Menu, in the menu bar
Dave Love <fx@gnu.org>
parents:
diff changeset
2672
Dave Love <fx@gnu.org>
parents:
diff changeset
2673 @b{Ref@TeX{}} installs a @code{Ref} menu in the menu bar on systems
Dave Love <fx@gnu.org>
parents:
diff changeset
2674 which support this. From this menu you can access all of
Dave Love <fx@gnu.org>
parents:
diff changeset
2675 @b{Ref@TeX{}}'s commands and a few of its options. There is also a
Dave Love <fx@gnu.org>
parents:
diff changeset
2676 @code{Customize} submenu which can be used to access @b{Ref@TeX{}}'s
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2677 entire set of options.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2678
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2679 @node Key Bindings, Faces, RefTeXs Menu, Top
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2680 @section Default Key Bindings
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2681 @cindex Key Bindings, summary
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2682
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2683 Here is a summary of the available key bindings.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2684
Dave Love <fx@gnu.org>
parents:
diff changeset
2685 @kindex C-c =
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2686 @kindex C-c -
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2687 @kindex C-c (
Dave Love <fx@gnu.org>
parents:
diff changeset
2688 @kindex C-c )
Dave Love <fx@gnu.org>
parents:
diff changeset
2689 @kindex C-c [
Dave Love <fx@gnu.org>
parents:
diff changeset
2690 @kindex C-c &
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2691 @kindex S-mouse-2
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2692 @kindex C-c /
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2693 @kindex C-c \
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2694 @kindex C-c |
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2695 @kindex C-c <
Dave Love <fx@gnu.org>
parents:
diff changeset
2696 @kindex C-c >
Dave Love <fx@gnu.org>
parents:
diff changeset
2697 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
2698 @kbd{C-c =} @code{reftex-toc}
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2699 @kbd{C-c -} @code{reftex-toc-recenter}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2700 @kbd{C-c (} @code{reftex-label}
Dave Love <fx@gnu.org>
parents:
diff changeset
2701 @kbd{C-c )} @code{reftex-reference}
Dave Love <fx@gnu.org>
parents:
diff changeset
2702 @kbd{C-c [} @code{reftex-citation}
Dave Love <fx@gnu.org>
parents:
diff changeset
2703 @kbd{C-c &} @code{reftex-view-crossref}
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2704 @kbd{S-mouse-2} @code{reftex-mouse-view-crossref}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2705 @kbd{C-c /} @code{reftex-index-selection-or-word}
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2706 @kbd{C-c \} @code{reftex-index-phrase-selection-or-word}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
2707 @kbd{C-c |} @code{reftex-index-visit-phrases-buffer}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2708 @kbd{C-c <} @code{reftex-index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2709 @kbd{C-c >} @code{reftex-display-index}
Dave Love <fx@gnu.org>
parents:
diff changeset
2710 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
2711
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
2712 Note that the @kbd{S-mouse-2} binding is only provided if this key is
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2713 not already used by some other package. @b{Ref@TeX{}} will not override an
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2714 existing binding to @kbd{S-mouse-2}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2715
Dave Love <fx@gnu.org>
parents:
diff changeset
2716 Personally, I also bind some functions in the users @kbd{C-c} map for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2717 easier access.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2718
Dave Love <fx@gnu.org>
parents:
diff changeset
2719 @c FIXME: Do we need bindings for the Index macros here as well?
Dave Love <fx@gnu.org>
parents:
diff changeset
2720 @c C-c i C-c I or so????
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2721 @c How about key bindings for reftex-reset-mode and reftex-parse-document?
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2722 @kindex C-c t
Dave Love <fx@gnu.org>
parents:
diff changeset
2723 @kindex C-c l
Dave Love <fx@gnu.org>
parents:
diff changeset
2724 @kindex C-c r
Dave Love <fx@gnu.org>
parents:
diff changeset
2725 @kindex C-c c
Dave Love <fx@gnu.org>
parents:
diff changeset
2726 @kindex C-c v
Dave Love <fx@gnu.org>
parents:
diff changeset
2727 @kindex C-c s
Dave Love <fx@gnu.org>
parents:
diff changeset
2728 @kindex C-c g
Dave Love <fx@gnu.org>
parents:
diff changeset
2729 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
2730 @kbd{C-c t} @code{reftex-toc}
Dave Love <fx@gnu.org>
parents:
diff changeset
2731 @kbd{C-c l} @code{reftex-label}
Dave Love <fx@gnu.org>
parents:
diff changeset
2732 @kbd{C-c r} @code{reftex-reference}
Dave Love <fx@gnu.org>
parents:
diff changeset
2733 @kbd{C-c c} @code{reftex-citation}
Dave Love <fx@gnu.org>
parents:
diff changeset
2734 @kbd{C-c v} @code{reftex-view-crossref}
Dave Love <fx@gnu.org>
parents:
diff changeset
2735 @kbd{C-c s} @code{reftex-search-document}
Dave Love <fx@gnu.org>
parents:
diff changeset
2736 @kbd{C-c g} @code{reftex-grep-document}
Dave Love <fx@gnu.org>
parents:
diff changeset
2737 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
2738
Dave Love <fx@gnu.org>
parents:
diff changeset
2739 @noindent These keys are reserved for the user, so I cannot bind them by
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2740 default. If you want to have these key bindings available, set in your
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2741 @file{.emacs} file:
Dave Love <fx@gnu.org>
parents:
diff changeset
2742
Dave Love <fx@gnu.org>
parents:
diff changeset
2743 @vindex reftex-extra-bindings
Dave Love <fx@gnu.org>
parents:
diff changeset
2744 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2745 (setq reftex-extra-bindings t)
Dave Love <fx@gnu.org>
parents:
diff changeset
2746 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2747
Dave Love <fx@gnu.org>
parents:
diff changeset
2748 @vindex reftex-load-hook
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2749 Changing and adding to @b{Ref@TeX{}}'s key bindings is best done in the hook
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2750 @code{reftex-load-hook}. For information on the keymaps
Dave Love <fx@gnu.org>
parents:
diff changeset
2751 which should be used to add keys, see @ref{Keymaps and Hooks}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2752
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
2753 @node Faces, AUCTeX, Key Bindings, Top
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2754 @section Faces
Dave Love <fx@gnu.org>
parents:
diff changeset
2755 @cindex Faces
Dave Love <fx@gnu.org>
parents:
diff changeset
2756
Dave Love <fx@gnu.org>
parents:
diff changeset
2757 @b{Ref@TeX{}} uses faces when available to structure the selection and
Dave Love <fx@gnu.org>
parents:
diff changeset
2758 table of contents buffers. It does not create its own faces, but uses
Dave Love <fx@gnu.org>
parents:
diff changeset
2759 the ones defined in @file{font-lock.el}. Therefore, @b{Ref@TeX{}} will
Dave Love <fx@gnu.org>
parents:
diff changeset
2760 use faces only when @code{font-lock} is loaded. This seems to be
Dave Love <fx@gnu.org>
parents:
diff changeset
2761 reasonable because people who like faces will very likely have it
Dave Love <fx@gnu.org>
parents:
diff changeset
2762 loaded. If you wish to turn off fontification or change the involved
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2763 faces, see @ref{Options (Fontification)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2764
Dave Love <fx@gnu.org>
parents:
diff changeset
2765 @node Multifile Documents, Language Support, AUCTeX, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
2766 @section Multifile Documents
Dave Love <fx@gnu.org>
parents:
diff changeset
2767 @cindex Multifile documents
Dave Love <fx@gnu.org>
parents:
diff changeset
2768 @cindex Documents, spread over files
Dave Love <fx@gnu.org>
parents:
diff changeset
2769
Dave Love <fx@gnu.org>
parents:
diff changeset
2770 The following is relevant when working with documents spread over many
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2771 files:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2772
Dave Love <fx@gnu.org>
parents:
diff changeset
2773 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
2774 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2775 @b{Ref@TeX{}} has full support for multifile documents. You can edit parts of
Dave Love <fx@gnu.org>
parents:
diff changeset
2776 several (multifile) documents at the same time without conflicts.
Dave Love <fx@gnu.org>
parents:
diff changeset
2777 @b{Ref@TeX{}} provides functions to run @code{grep}, @code{search} and
Dave Love <fx@gnu.org>
parents:
diff changeset
2778 @code{query-replace} on all files which are part of a multifile
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2779 document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2780
Dave Love <fx@gnu.org>
parents:
diff changeset
2781 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2782 @vindex tex-main-file
Dave Love <fx@gnu.org>
parents:
diff changeset
2783 @vindex TeX-master
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2784 All files belonging to a multifile document should define a File
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2785 Variable (@code{TeX-master} for AUCTeX or @code{tex-main-file} for the
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2786 standard Emacs LaTeX mode) containing the name of the master file. For
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2787 example, to set the file variable @code{TeX-master}, include something
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2788 like the following at the end of each TeX file:
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2789
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2790 @example
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2791 %%% Local Variables: ***
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2792 %%% mode:latex ***
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2793 %%% TeX-master: "thesis.tex" ***
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2794 %%% End: ***
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2795 @end example
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2796
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2797 AUCTeX with the setting
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2798
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2799 @lisp
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2800 (setq-default TeX-master nil)
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2801 @end lisp
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2802
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2803 will actually ask you for each new file about the master file and insert
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2804 this comment automatically. For more details see the documentation of
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2805 the AUCTeX (@pxref{Multifile,,,auctex, The AUC TeX User Manual}), the
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2806 documentation about the Emacs (La)TeX mode (@pxref{TeX Print,,,emacs,
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
2807 The GNU Emacs Manual}) and the Emacs documentation on File Variables
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2808 (@pxref{File Variables,,,emacs, The GNU Emacs Manual}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2809
Dave Love <fx@gnu.org>
parents:
diff changeset
2810 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2811 The context of a label definition must be found in the same file as the
Dave Love <fx@gnu.org>
parents:
diff changeset
2812 label itself in order to be processed correctly by @b{Ref@TeX{}}. The only
Dave Love <fx@gnu.org>
parents:
diff changeset
2813 exception is that section labels referring to a section statement
Dave Love <fx@gnu.org>
parents:
diff changeset
2814 outside the current file can still use that section title as
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2815 context.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2816 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
2817
Dave Love <fx@gnu.org>
parents:
diff changeset
2818 @node Language Support, Finding Files, Multifile Documents, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
2819 @section Language Support
Dave Love <fx@gnu.org>
parents:
diff changeset
2820 @cindex Language support
Dave Love <fx@gnu.org>
parents:
diff changeset
2821
Dave Love <fx@gnu.org>
parents:
diff changeset
2822 Some parts of @b{Ref@TeX{}} are language dependent. The default
Dave Love <fx@gnu.org>
parents:
diff changeset
2823 settings work well for English. If you are writing in a different
Dave Love <fx@gnu.org>
parents:
diff changeset
2824 language, the following hints may be useful:
Dave Love <fx@gnu.org>
parents:
diff changeset
2825
Dave Love <fx@gnu.org>
parents:
diff changeset
2826 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
2827 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2828 @vindex reftex-derive-label-parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
2829 @vindex reftex-abbrev-parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
2830 The mechanism to derive a label from context includes the abbreviation
Dave Love <fx@gnu.org>
parents:
diff changeset
2831 of words and omission of unimportant words. These mechanisms may have
Dave Love <fx@gnu.org>
parents:
diff changeset
2832 to be changed for other languages. See the variables
Dave Love <fx@gnu.org>
parents:
diff changeset
2833 @code{reftex-derive-label-parameters} and @code{reftex-abbrev-parameters}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2834
Dave Love <fx@gnu.org>
parents:
diff changeset
2835 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2836 @vindex reftex-translate-to-ascii-function
Dave Love <fx@gnu.org>
parents:
diff changeset
2837 @vindex reftex-label-illegal-re
Dave Love <fx@gnu.org>
parents:
diff changeset
2838 Also, when a label is derived from context, @b{Ref@TeX{}} clears the
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
2839 context string from non-ASCII characters in order to make a valid label.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2840 If there should ever be a version of @TeX{} which allows extended
Dave Love <fx@gnu.org>
parents:
diff changeset
2841 characters @emph{in labels}, then we will have to look at the
Dave Love <fx@gnu.org>
parents:
diff changeset
2842 variables @code{reftex-translate-to-ascii-function} and
Dave Love <fx@gnu.org>
parents:
diff changeset
2843 @code{reftex-label-illegal-re}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2844
Dave Love <fx@gnu.org>
parents:
diff changeset
2845 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2846 When a label is referenced, @b{Ref@TeX{}} looks at the word before point
Dave Love <fx@gnu.org>
parents:
diff changeset
2847 to guess which label type is required. These @emph{magic words} are
Dave Love <fx@gnu.org>
parents:
diff changeset
2848 different in every language. For an example of how to add magic words,
Dave Love <fx@gnu.org>
parents:
diff changeset
2849 see @ref{Adding Magic Words}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2850
Dave Love <fx@gnu.org>
parents:
diff changeset
2851 @vindex reftex-multiref-punctuation
Dave Love <fx@gnu.org>
parents:
diff changeset
2852 @vindex reftex-cite-punctuation
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2853 @item
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2854 @b{Ref@TeX{}} inserts ``punctuation'' for multiple references and
Dave Love <fx@gnu.org>
parents:
diff changeset
2855 for the author list in citations. Some of this may be language
Dave Love <fx@gnu.org>
parents:
diff changeset
2856 dependent. See the variables @code{reftex-multiref-punctuation} and
Dave Love <fx@gnu.org>
parents:
diff changeset
2857 @code{reftex-cite-punctuation}.
Dave Love <fx@gnu.org>
parents:
diff changeset
2858 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
2859
Dave Love <fx@gnu.org>
parents:
diff changeset
2860 @node Finding Files, Optimizations, Language Support, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
2861 @section Finding Files
Dave Love <fx@gnu.org>
parents:
diff changeset
2862 @cindex Finding files
Dave Love <fx@gnu.org>
parents:
diff changeset
2863
Dave Love <fx@gnu.org>
parents:
diff changeset
2864 In order to find files included in a document via @code{\input} or
Dave Love <fx@gnu.org>
parents:
diff changeset
2865 @code{\include}, @b{Ref@TeX{}} searches all directories specified in the
Dave Love <fx@gnu.org>
parents:
diff changeset
2866 environment variable @code{TEXINPUTS}. Similarly, it will search the
Dave Love <fx@gnu.org>
parents:
diff changeset
2867 path specified in the variables @code{BIBINPUTS} and @code{TEXBIB} for
Dave Love <fx@gnu.org>
parents:
diff changeset
2868 BibTeX database files.
Dave Love <fx@gnu.org>
parents:
diff changeset
2869
Dave Love <fx@gnu.org>
parents:
diff changeset
2870 When searching, @b{Ref@TeX{}} will also expand recursive path
Dave Love <fx@gnu.org>
parents:
diff changeset
2871 definitions (directories ending in @samp{//} or @samp{!!}). But it will
Dave Love <fx@gnu.org>
parents:
diff changeset
2872 only search and expand directories @emph{explicitly} given in these
Dave Love <fx@gnu.org>
parents:
diff changeset
2873 variables. This may cause problems under the following circumstances:
Dave Love <fx@gnu.org>
parents:
diff changeset
2874
Dave Love <fx@gnu.org>
parents:
diff changeset
2875 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
2876 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2877 Most TeX system have a default search path for both TeX files and BibTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
2878 files which is defined in some setup file. Usually this default path is
Dave Love <fx@gnu.org>
parents:
diff changeset
2879 for system files which @b{Ref@TeX{}} does not need to see. But if your
Dave Love <fx@gnu.org>
parents:
diff changeset
2880 document needs TeX files or BibTeX database files in a directory only
Dave Love <fx@gnu.org>
parents:
diff changeset
2881 given in the default search path, @b{Ref@TeX{}} will fail to find them.
Dave Love <fx@gnu.org>
parents:
diff changeset
2882 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2883 Some TeX systems do not use environment variables at all in order to
Dave Love <fx@gnu.org>
parents:
diff changeset
2884 specify the search path. Both default and user search path are then
Dave Love <fx@gnu.org>
parents:
diff changeset
2885 defined in setup files.
Dave Love <fx@gnu.org>
parents:
diff changeset
2886 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
2887
Dave Love <fx@gnu.org>
parents:
diff changeset
2888 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
2889 There are three ways to solve this problem:
Dave Love <fx@gnu.org>
parents:
diff changeset
2890
Dave Love <fx@gnu.org>
parents:
diff changeset
2891 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
2892 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2893 Specify all relevant directories explicitly in the environment
Dave Love <fx@gnu.org>
parents:
diff changeset
2894 variables. If for some reason you don't want to mess with the default
Dave Love <fx@gnu.org>
parents:
diff changeset
2895 variables @code{TEXINPUTS} and @code{BIBINPUTS}, define your own
Dave Love <fx@gnu.org>
parents:
diff changeset
2896 variables and configure @b{Ref@TeX{}} to use them instead:
Dave Love <fx@gnu.org>
parents:
diff changeset
2897
Dave Love <fx@gnu.org>
parents:
diff changeset
2898 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2899 (setq reftex-texpath-environment-variables '("MYTEXINPUTS"))
Dave Love <fx@gnu.org>
parents:
diff changeset
2900 (setq reftex-bibpath-environment-variables '("MYBIBINPUTS"))
Dave Love <fx@gnu.org>
parents:
diff changeset
2901 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2902
Dave Love <fx@gnu.org>
parents:
diff changeset
2903 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2904 Specify the full search path directly in @b{Ref@TeX{}}'s variables.
Dave Love <fx@gnu.org>
parents:
diff changeset
2905
Dave Love <fx@gnu.org>
parents:
diff changeset
2906 @lisp
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2907 (setq reftex-texpath-environment-variables
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2908 '("./inp:/home/cd/tex//:/usr/local/tex//"))
Dave Love <fx@gnu.org>
parents:
diff changeset
2909 (setq reftex-bibpath-environment-variables
Dave Love <fx@gnu.org>
parents:
diff changeset
2910 '("/home/cd/tex/lit/"))
Dave Love <fx@gnu.org>
parents:
diff changeset
2911 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2912
Dave Love <fx@gnu.org>
parents:
diff changeset
2913 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2914 Some TeX systems provide stand--alone programs to do the file search just
Dave Love <fx@gnu.org>
parents:
diff changeset
2915 like TeX and BibTeX. E.g. Thomas Esser's @code{teTeX} uses the
Dave Love <fx@gnu.org>
parents:
diff changeset
2916 @code{kpathsearch} library which provides the command @code{kpsewhich}
Dave Love <fx@gnu.org>
parents:
diff changeset
2917 to search for files. @b{Ref@TeX{}} can be configured to use this
Dave Love <fx@gnu.org>
parents:
diff changeset
2918 program. Note that the exact syntax of the @code{kpsewhich}
Dave Love <fx@gnu.org>
parents:
diff changeset
2919 command depends upon the version of that program.
Dave Love <fx@gnu.org>
parents:
diff changeset
2920
Dave Love <fx@gnu.org>
parents:
diff changeset
2921 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2922 (setq reftex-use-external-file-finders t)
Dave Love <fx@gnu.org>
parents:
diff changeset
2923 (setq reftex-external-file-finders
37038
528310f62c34 (Finding Files): Fix an example.
Gerd Moellmann <gerd@gnu.org>
parents: 36509
diff changeset
2924 '(("tex" . "kpsewhich -format=.tex %f")
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2925 ("bib" . "kpsewhich -format=.bib %f")))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2926 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2927 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
2928
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2929 @cindex Noweb files
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2930 @vindex reftex-file-extensions
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2931 @vindex TeX-file-extensions
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2932 Some people like to use RefTeX with noweb files, which usually have the
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2933 extension @file{.nw}. In order to deal with such files, the new
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2934 extension must be added to the list of valid extensions in the variable
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2935 @code{reftex-file-extensions}. When working with AUCTeX as major mode,
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2936 the new extension must also be known to AUCTeX via the variable
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2937 @code{TeX-file-extension}. For example:
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2938
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2939 @lisp
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2940 (setq reftex-file-extensions
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2941 '(("nw" "tex" ".tex" ".ltx") ("bib" ".bib")))
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
2942 (setq TeX-file-extensions
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2943 '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2944 @end lisp
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
2945
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2946 @node Optimizations, Problems and Work-Arounds, Finding Files, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
2947 @section Optimizations
Dave Love <fx@gnu.org>
parents:
diff changeset
2948 @cindex Optimizations
Dave Love <fx@gnu.org>
parents:
diff changeset
2949
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2950 @b{Note added 2002. Computers have gotten a lot faster, so most of the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2951 optimizations discussed below will not be necessary on new machines. I
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2952 am leaving this stuff in the manual for people who want to write thick
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2953 books, where some of it still might be useful.}
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
2954
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2955 Implementing the principle of least surprises, the default settings of
Dave Love <fx@gnu.org>
parents:
diff changeset
2956 @b{Ref@TeX{}} ensure a safe ride for beginners and casual users. However,
Dave Love <fx@gnu.org>
parents:
diff changeset
2957 when using @b{Ref@TeX{}} for a large project and/or on a small computer,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2958 there are ways to improve speed or memory usage.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2959
Dave Love <fx@gnu.org>
parents:
diff changeset
2960 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
2961 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2962 @b{Removing Lookup Buffers}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
2963 @cindex Removing lookup buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2964 @b{Ref@TeX{}} will load other parts of a multifile document as well as BibTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
2965 database files for lookup purposes. These buffers are kept, so that
Dave Love <fx@gnu.org>
parents:
diff changeset
2966 subsequent use of the same files is fast. If you can't afford keeping
Dave Love <fx@gnu.org>
parents:
diff changeset
2967 these buffers around, and if you can live with a speed penalty, try
Dave Love <fx@gnu.org>
parents:
diff changeset
2968
Dave Love <fx@gnu.org>
parents:
diff changeset
2969 @vindex reftex-keep-temporary-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
2970 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2971 (setq reftex-keep-temporary-buffers nil)
Dave Love <fx@gnu.org>
parents:
diff changeset
2972 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2973
Dave Love <fx@gnu.org>
parents:
diff changeset
2974 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
2975 @b{Partial Document Scans}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
2976 @cindex Partial documents scans
Dave Love <fx@gnu.org>
parents:
diff changeset
2977 @cindex Document scanning, partial
Dave Love <fx@gnu.org>
parents:
diff changeset
2978 A @kbd{C-u} prefix on the major @b{Ref@TeX{}} commands @code{reftex-label}
Dave Love <fx@gnu.org>
parents:
diff changeset
2979 (@kbd{C-u C-c (}), @code{reftex-reference} (@kbd{C-u C-c )}),
Dave Love <fx@gnu.org>
parents:
diff changeset
2980 @code{reftex-citation} (@kbd{C-u C-c [}), @code{reftex-toc} (@kbd{C-u C-c
Dave Love <fx@gnu.org>
parents:
diff changeset
2981 =}), and @code{reftex-view-crossref} (@kbd{C-u C-c &}) initiates
Dave Love <fx@gnu.org>
parents:
diff changeset
2982 re-parsing of the entire document in order to update the parsing
Dave Love <fx@gnu.org>
parents:
diff changeset
2983 information. For a large document this can be unnecessary, in
Dave Love <fx@gnu.org>
parents:
diff changeset
2984 particular if only one file has changed. @b{Ref@TeX{}} can be configured
Dave Love <fx@gnu.org>
parents:
diff changeset
2985 to do partial scans instead of full ones. @kbd{C-u} re-parsing then
Dave Love <fx@gnu.org>
parents:
diff changeset
2986 does apply only to the current buffer and files included from it.
Dave Love <fx@gnu.org>
parents:
diff changeset
2987 Likewise, the @kbd{r} key in both the label selection buffer and the
Dave Love <fx@gnu.org>
parents:
diff changeset
2988 table-of-contents buffer will only prompt scanning of the file in which
Dave Love <fx@gnu.org>
parents:
diff changeset
2989 the label or section macro near the cursor was defined. Re-parsing of
Dave Love <fx@gnu.org>
parents:
diff changeset
2990 the entire document is still available by using @kbd{C-u C-u} as a
Dave Love <fx@gnu.org>
parents:
diff changeset
2991 prefix, or the capital @kbd{R} key in the menus. To use this feature,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
2992 try
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
2993
Dave Love <fx@gnu.org>
parents:
diff changeset
2994 @vindex reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
2995 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2996 (setq reftex-enable-partial-scans t)
Dave Love <fx@gnu.org>
parents:
diff changeset
2997 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
2998
Dave Love <fx@gnu.org>
parents:
diff changeset
2999 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3000 @b{Saving Parser Information}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3001 @cindex Saving parser information
Dave Love <fx@gnu.org>
parents:
diff changeset
3002 @cindex Parse information, saving to a file
27195
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
3003 @vindex reftex-parse-file-extension
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3004 Even with partial scans enabled, @b{Ref@TeX{}} still has to make one full
Dave Love <fx@gnu.org>
parents:
diff changeset
3005 scan, when you start working with a document. To avoid this, parsing
Dave Love <fx@gnu.org>
parents:
diff changeset
3006 information can be stored in a file. The file @file{MASTER.rel} is used
Dave Love <fx@gnu.org>
parents:
diff changeset
3007 for storing information about a document with master file
Dave Love <fx@gnu.org>
parents:
diff changeset
3008 @file{MASTER.tex}. It is written automatically when you kill a buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
3009 in @code{reftex-mode} or when you exit Emacs. The information is
Dave Love <fx@gnu.org>
parents:
diff changeset
3010 restored when you begin working with a document in a new editing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3011 session. To use this feature, put into @file{.emacs}:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3012
Dave Love <fx@gnu.org>
parents:
diff changeset
3013 @vindex reftex-save-parse-info
Dave Love <fx@gnu.org>
parents:
diff changeset
3014 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3015 (setq reftex-save-parse-info t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3016 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3017
Dave Love <fx@gnu.org>
parents:
diff changeset
3018 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3019 @b{Identifying label types by prefix}@*
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3020 @cindex Parse information, saving to a file
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3021 @vindex reftex-trust-label-prefix
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3022 @b{Ref@TeX{}} normally parses around each label to check in which
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3023 environment this label is located, in order to assign a label type to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3024 the label. If your document contains thousands of labels, document
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3025 parsing will take considerable time. If you have been using label prefixes
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3026 like tab: and fn: consistently, you can tell @b{Ref@TeX{}} to get the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3027 label type directly from the prefix, without additional parsing. This
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3028 will be faster and also allow labels to end up in the correct category
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3029 if for some reason it is not possible to derive the correct type from
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3030 context. For example, to enable this feature for footnote and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3031 equation labels, use
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3032
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3033 @lisp
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3034 (setq reftex-trust-label-prefix '("fn:" "eq:"))
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3035 @end lisp
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3036
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3037 @item
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3038 @b{Automatic Document Scans}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3039 @cindex Automatic document scans
Dave Love <fx@gnu.org>
parents:
diff changeset
3040 @cindex Document scanning, automatic
Dave Love <fx@gnu.org>
parents:
diff changeset
3041 At rare occasions, @b{Ref@TeX{}} will automatically rescan a part of the
Dave Love <fx@gnu.org>
parents:
diff changeset
3042 document. If this gets into your way, it can be turned off with
Dave Love <fx@gnu.org>
parents:
diff changeset
3043
Dave Love <fx@gnu.org>
parents:
diff changeset
3044 @vindex reftex-allow-automatic-rescan
Dave Love <fx@gnu.org>
parents:
diff changeset
3045 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3046 (setq reftex-allow-automatic-rescan nil)
Dave Love <fx@gnu.org>
parents:
diff changeset
3047 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3048
Dave Love <fx@gnu.org>
parents:
diff changeset
3049 @b{Ref@TeX{}} will then occasionally annotate new labels in the selection
Dave Love <fx@gnu.org>
parents:
diff changeset
3050 buffer, saying that their position in the label list in uncertain. A
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3051 manual document scan will fix this.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3052
Dave Love <fx@gnu.org>
parents:
diff changeset
3053 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3054 @b{Multiple Selection Buffers}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3055 @cindex Multiple selection buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
3056 @cindex Selection buffers, multiple
Dave Love <fx@gnu.org>
parents:
diff changeset
3057 Normally, the selection buffer @file{*RefTeX Select*} is re-created for
Dave Love <fx@gnu.org>
parents:
diff changeset
3058 every selection process. In documents with very many labels this can
Dave Love <fx@gnu.org>
parents:
diff changeset
3059 take several seconds. @b{Ref@TeX{}} provides an option to create a
Dave Love <fx@gnu.org>
parents:
diff changeset
3060 separate selection buffer for each label type and to keep this buffer
Dave Love <fx@gnu.org>
parents:
diff changeset
3061 from one selection to the next. These buffers are updated automatically
Dave Love <fx@gnu.org>
parents:
diff changeset
3062 only when a new label has been added in the buffers category with
Dave Love <fx@gnu.org>
parents:
diff changeset
3063 @code{reftex-label}. Updating the buffer takes as long as recreating it
Dave Love <fx@gnu.org>
parents:
diff changeset
3064 - so the time saving is limited to cases where no new labels of that
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3065 category have been added. To turn on this feature, use
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3066
Dave Love <fx@gnu.org>
parents:
diff changeset
3067 @vindex reftex-use-multiple-selection-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
3068 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3069 (setq reftex-use-multiple-selection-buffers t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3070 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3071
Dave Love <fx@gnu.org>
parents:
diff changeset
3072 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3073 @cindex Selection buffers, updating
Dave Love <fx@gnu.org>
parents:
diff changeset
3074 You can also inhibit the automatic updating entirely. Then the
Dave Love <fx@gnu.org>
parents:
diff changeset
3075 selection buffer will always pop up very fast, but may not contain the
Dave Love <fx@gnu.org>
parents:
diff changeset
3076 most recently defined labels. You can always update the buffer by hand,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3077 with the @kbd{g} key. To get this behavior, use instead
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3078
Dave Love <fx@gnu.org>
parents:
diff changeset
3079 @vindex reftex-auto-update-selection-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
3080 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3081 (setq reftex-use-multiple-selection-buffers t
Dave Love <fx@gnu.org>
parents:
diff changeset
3082 reftex-auto-update-selection-buffers nil)
Dave Love <fx@gnu.org>
parents:
diff changeset
3083 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3084 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
3085
Dave Love <fx@gnu.org>
parents:
diff changeset
3086 @need 2000
Dave Love <fx@gnu.org>
parents:
diff changeset
3087 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3088 @b{As a summary}, here are the settings I recommend for heavy use of
Dave Love <fx@gnu.org>
parents:
diff changeset
3089 @b{Ref@TeX{}} with large documents:
Dave Love <fx@gnu.org>
parents:
diff changeset
3090
Dave Love <fx@gnu.org>
parents:
diff changeset
3091 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3092 @group
Dave Love <fx@gnu.org>
parents:
diff changeset
3093 (setq reftex-enable-partial-scans t
Dave Love <fx@gnu.org>
parents:
diff changeset
3094 reftex-save-parse-info t
Dave Love <fx@gnu.org>
parents:
diff changeset
3095 reftex-use-multiple-selection-buffers t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3096 @end group
Dave Love <fx@gnu.org>
parents:
diff changeset
3097 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3098
Dave Love <fx@gnu.org>
parents:
diff changeset
3099 @node AUCTeX, Multifile Documents, Faces, Top
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
3100 @section AUC@TeX{}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3101 @cindex @code{AUCTeX}, Emacs package
Dave Love <fx@gnu.org>
parents:
diff changeset
3102 @cindex Emacs packages, @code{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3103
Dave Love <fx@gnu.org>
parents:
diff changeset
3104 AUCTeX is without doubt the best major mode for editing TeX and LaTeX
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3105 files with Emacs (@pxref{Top,AUCTeX,,auctex, The AUCTeX User Manual}).
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3106 If AUCTeX is not part of your Emacs distribution, you can get
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3107 it@footnote{XEmacs 21.x users may want to install the corresponding
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3108 XEmacs package.} by ftp from the @value{AUCTEXSITE}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3109
Dave Love <fx@gnu.org>
parents:
diff changeset
3110 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
3111 * AUCTeX-RefTeX Interface:: How both packages work together
Dave Love <fx@gnu.org>
parents:
diff changeset
3112 * Style Files:: AUCTeX's style files can support RefTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3113 * Bib-Cite:: Hypertext reading of a document
Dave Love <fx@gnu.org>
parents:
diff changeset
3114 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
3115
Dave Love <fx@gnu.org>
parents:
diff changeset
3116 @node AUCTeX-RefTeX Interface, Style Files, , AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3117 @subsection The AUC@TeX{}-@b{Ref@TeX{}} Interface
Dave Love <fx@gnu.org>
parents:
diff changeset
3118
Dave Love <fx@gnu.org>
parents:
diff changeset
3119 @b{Ref@TeX{}} contains code to interface with AUCTeX. When this
Dave Love <fx@gnu.org>
parents:
diff changeset
3120 interface is turned on, both packages will interact closely. Instead of
Dave Love <fx@gnu.org>
parents:
diff changeset
3121 using @b{Ref@TeX{}}'s commands directly, you can then also use them
Dave Love <fx@gnu.org>
parents:
diff changeset
3122 indirectly as part of the AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3123 environment@footnote{@b{Ref@TeX{}} 4.0 and AUCTeX 9.10c will be
Dave Love <fx@gnu.org>
parents:
diff changeset
3124 needed for all of this to work. Parts of it work also with earlier
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3125 versions.}. The interface is turned on with
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3126
Dave Love <fx@gnu.org>
parents:
diff changeset
3127 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3128 (setq reftex-plug-into-AUCTeX t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3129 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3130
Dave Love <fx@gnu.org>
parents:
diff changeset
3131 If you need finer control about which parts of the interface are used
Dave Love <fx@gnu.org>
parents:
diff changeset
3132 and which not, read the docstring of the variable
Dave Love <fx@gnu.org>
parents:
diff changeset
3133 @code{reftex-plug-into-AUCTeX} or customize it with @kbd{M-x
Dave Love <fx@gnu.org>
parents:
diff changeset
3134 customize-variable @key{RET} reftex-plug-into-AUCTeX @key{RET}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
3135
Dave Love <fx@gnu.org>
parents:
diff changeset
3136 The following list describes the individual parts of the interface.
Dave Love <fx@gnu.org>
parents:
diff changeset
3137
Dave Love <fx@gnu.org>
parents:
diff changeset
3138 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
3139 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3140 @findex reftex-label
Dave Love <fx@gnu.org>
parents:
diff changeset
3141 @vindex LaTeX-label-function, @r{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3142 @kindex C-c C-e
Dave Love <fx@gnu.org>
parents:
diff changeset
3143 @kindex C-c C-s
Dave Love <fx@gnu.org>
parents:
diff changeset
3144 @findex LaTeX-section, @r{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3145 @findex TeX-insert-macro, @r{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3146 @b{AUCTeX calls @code{reftex-label} to insert labels}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3147 When a new section is created with @kbd{C-c C-s}, or a new environment
Dave Love <fx@gnu.org>
parents:
diff changeset
3148 is inserted with @kbd{C-c C-e}, AUCTeX normally prompts for a label to
Dave Love <fx@gnu.org>
parents:
diff changeset
3149 go with it. With the interface, @code{reftex-label} is called instead.
Dave Love <fx@gnu.org>
parents:
diff changeset
3150 For example, if you type @kbd{C-c C-e equation @key{RET}}, AUCTeX and
Dave Love <fx@gnu.org>
parents:
diff changeset
3151 @b{Ref@TeX{}} will insert
Dave Love <fx@gnu.org>
parents:
diff changeset
3152
Dave Love <fx@gnu.org>
parents:
diff changeset
3153 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
3154 \begin@{equation@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3155 \label@{eq:1@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3156
Dave Love <fx@gnu.org>
parents:
diff changeset
3157 \end@{equation@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3158 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
3159
Dave Love <fx@gnu.org>
parents:
diff changeset
3160 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3161 without further prompts.
Dave Love <fx@gnu.org>
parents:
diff changeset
3162
Dave Love <fx@gnu.org>
parents:
diff changeset
3163 Similarly, when you type @kbd{C-c C-s section @key{RET}}, @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
3164 will offer its default label which is derived from the section title.
Dave Love <fx@gnu.org>
parents:
diff changeset
3165
Dave Love <fx@gnu.org>
parents:
diff changeset
3166 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3167 @b{AUCTeX tells @b{Ref@TeX{}} about new sections}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3168 When creating a new section with @kbd{C-c C-s}, @b{Ref@TeX{}} will not
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3169 have to rescan the buffer in order to see it.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3170
Dave Love <fx@gnu.org>
parents:
diff changeset
3171 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3172 @findex reftex-arg-label
Dave Love <fx@gnu.org>
parents:
diff changeset
3173 @findex TeX-arg-label, @r{AUCTeX function}
Dave Love <fx@gnu.org>
parents:
diff changeset
3174 @findex reftex-arg-ref
Dave Love <fx@gnu.org>
parents:
diff changeset
3175 @findex TeX-arg-ref, @r{AUCTeX function}
Dave Love <fx@gnu.org>
parents:
diff changeset
3176 @findex reftex-arg-cite
Dave Love <fx@gnu.org>
parents:
diff changeset
3177 @findex TeX-arg-cite, @r{AUCTeX function}
Dave Love <fx@gnu.org>
parents:
diff changeset
3178 @findex reftex-arg-index
Dave Love <fx@gnu.org>
parents:
diff changeset
3179 @findex TeX-arg-index, @r{AUCTeX function}
Dave Love <fx@gnu.org>
parents:
diff changeset
3180 @findex TeX-insert-macro, @r{AUCTeX function}
Dave Love <fx@gnu.org>
parents:
diff changeset
3181 @kindex C-c @key{RET}
Dave Love <fx@gnu.org>
parents:
diff changeset
3182 @b{@b{Ref@TeX{}} supplies macro arguments}@* When you insert a macro
Dave Love <fx@gnu.org>
parents:
diff changeset
3183 interactively with @kbd{C-c @key{RET}}, AUCTeX normally prompts for
Dave Love <fx@gnu.org>
parents:
diff changeset
3184 macro arguments. Internally, it uses the functions
Dave Love <fx@gnu.org>
parents:
diff changeset
3185 @code{TeX-arg-label}, @code{TeX-arg-cite}, and @code{TeX-arg-index} to
Dave Love <fx@gnu.org>
parents:
diff changeset
3186 prompt for arguments which are labels, citation keys and index entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
3187 The interface takes over these functions@footnote{@code{fset} is used to
Dave Love <fx@gnu.org>
parents:
diff changeset
3188 do this, which is not reversible. However, @b{Ref@TeX{}} implements the
Dave Love <fx@gnu.org>
parents:
diff changeset
3189 old functionality when you later decide to turn off the interface.} and
Dave Love <fx@gnu.org>
parents:
diff changeset
3190 supplies the macro arguments with @b{Ref@TeX{}'s} mechanisms. For
Dave Love <fx@gnu.org>
parents:
diff changeset
3191 example, when you type @kbd{C-c @key{RET} ref @key{RET}}, @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
3192 will supply its label selection process (@pxref{Referencing
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3193 Labels}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3194
Dave Love <fx@gnu.org>
parents:
diff changeset
3195 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3196 @b{@b{Ref@TeX{}} tells AUCTeX about new labels, citation-- and index keys}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3197 @b{Ref@TeX{}} will add all newly created labels to AUCTeX's completion list.
Dave Love <fx@gnu.org>
parents:
diff changeset
3198 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
3199
Dave Love <fx@gnu.org>
parents:
diff changeset
3200 @node Style Files, Bib-Cite, AUCTeX-RefTeX Interface, AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3201 @subsection Style Files
Dave Love <fx@gnu.org>
parents:
diff changeset
3202 @cindex Style files, AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3203 @findex TeX-add-style-hook, @r{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3204 Style files are Emacs Lisp files which are evaluated by AUCTeX in
Dave Love <fx@gnu.org>
parents:
diff changeset
3205 association with the @code{\documentclass} and @code{\usepackage}
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3206 commands of a document (@pxref{Style Files,,,auctex}). Support for
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3207 @b{Ref@TeX{}} in such a style file is useful when the LaTeX style
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3208 defines macros or environments connected with labels, citations, or the
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3209 index. Many style files (e.g. @file{amsmath.el} or @file{natbib.el})
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
3210 distributed with AUCTeX already support @b{Ref@TeX{}} in this
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3211 way.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3212
Dave Love <fx@gnu.org>
parents:
diff changeset
3213 Before calling a @b{Ref@TeX{}} function, the style hook should always
Dave Love <fx@gnu.org>
parents:
diff changeset
3214 test for the availability of the function, so that the style file will
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
3215 also work for people who do not use @b{Ref@TeX{}}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3216
Dave Love <fx@gnu.org>
parents:
diff changeset
3217 Additions made with style files in the way described below remain local
Dave Love <fx@gnu.org>
parents:
diff changeset
3218 to the current document. For example, if one package uses AMSTeX, the
Dave Love <fx@gnu.org>
parents:
diff changeset
3219 style file will make @b{Ref@TeX{}} switch over to @code{\eqref}, but
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3220 this will not affect other documents.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3221
Dave Love <fx@gnu.org>
parents:
diff changeset
3222 @findex reftex-add-label-environments
Dave Love <fx@gnu.org>
parents:
diff changeset
3223 @findex reftex-add-to-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
3224 A style hook may contain calls to
Dave Love <fx@gnu.org>
parents:
diff changeset
3225 @code{reftex-add-label-environments}@footnote{This used to be the
Dave Love <fx@gnu.org>
parents:
diff changeset
3226 function @code{reftex-add-to-label-alist} which is still available as an
Dave Love <fx@gnu.org>
parents:
diff changeset
3227 alias for compatibility.} which defines additions to
Dave Love <fx@gnu.org>
parents:
diff changeset
3228 @code{reftex-label-alist}. The argument taken by this function must have
Dave Love <fx@gnu.org>
parents:
diff changeset
3229 the same format as @code{reftex-label-alist}. The @file{amsmath.el}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3230 style file of AUCTeX for example contains the following:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3231
Dave Love <fx@gnu.org>
parents:
diff changeset
3232 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3233 @group
Dave Love <fx@gnu.org>
parents:
diff changeset
3234 (TeX-add-style-hook "amsmath"
Dave Love <fx@gnu.org>
parents:
diff changeset
3235 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3236 (if (fboundp 'reftex-add-label-environments)
Dave Love <fx@gnu.org>
parents:
diff changeset
3237 (reftex-add-label-environments '(AMSTeX)))))
Dave Love <fx@gnu.org>
parents:
diff changeset
3238 @end group
Dave Love <fx@gnu.org>
parents:
diff changeset
3239 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3240
Dave Love <fx@gnu.org>
parents:
diff changeset
3241 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3242 @findex LaTeX-add-environments, @r{AUCTeX}
Dave Love <fx@gnu.org>
parents:
diff changeset
3243 while a package @code{myprop} defining a @code{proposition} environment
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3244 with @code{\newtheorem} might use
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3245
Dave Love <fx@gnu.org>
parents:
diff changeset
3246 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3247 @group
Dave Love <fx@gnu.org>
parents:
diff changeset
3248 (TeX-add-style-hook "myprop"
Dave Love <fx@gnu.org>
parents:
diff changeset
3249 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3250 (LaTeX-add-environments '("proposition" LaTeX-env-label))
Dave Love <fx@gnu.org>
parents:
diff changeset
3251 (if (fboundp 'reftex-add-label-environments)
Dave Love <fx@gnu.org>
parents:
diff changeset
3252 (reftex-add-label-environments
Dave Love <fx@gnu.org>
parents:
diff changeset
3253 '(("proposition" ?p "prop:" "~\\ref@{%s@}" t
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3254 ("Proposition" "Prop.") -3))))))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3255 @end group
Dave Love <fx@gnu.org>
parents:
diff changeset
3256 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3257
Dave Love <fx@gnu.org>
parents:
diff changeset
3258 @findex reftex-set-cite-format
Dave Love <fx@gnu.org>
parents:
diff changeset
3259 Similarly, a style hook may contain a call to
Dave Love <fx@gnu.org>
parents:
diff changeset
3260 @code{reftex-set-cite-format} to set the citation format. The style
Dave Love <fx@gnu.org>
parents:
diff changeset
3261 file @file{natbib.el} for the Natbib citation style does switch
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3262 @b{Ref@TeX{}}'s citation format like this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3263
Dave Love <fx@gnu.org>
parents:
diff changeset
3264 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3265 (TeX-add-style-hook "natbib"
Dave Love <fx@gnu.org>
parents:
diff changeset
3266 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3267 (if (fboundp 'reftex-set-cite-format)
Dave Love <fx@gnu.org>
parents:
diff changeset
3268 (reftex-set-cite-format 'natbib))))
Dave Love <fx@gnu.org>
parents:
diff changeset
3269 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3270
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
3271 @findex reftex-add-index-macros
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3272 The hook may contain a call to @code{reftex-add-index-macros} to
Dave Love <fx@gnu.org>
parents:
diff changeset
3273 define additional @code{\index}-like macros. The argument must have
Dave Love <fx@gnu.org>
parents:
diff changeset
3274 the same format as @code{reftex-index-macros}. It may be a symbol, to
Dave Love <fx@gnu.org>
parents:
diff changeset
3275 trigger support for one of the builtin index packages. For example,
Dave Love <fx@gnu.org>
parents:
diff changeset
3276 the style @file{multind.el} contains
Dave Love <fx@gnu.org>
parents:
diff changeset
3277
Dave Love <fx@gnu.org>
parents:
diff changeset
3278 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3279 (TeX-add-style-hook "multind"
Dave Love <fx@gnu.org>
parents:
diff changeset
3280 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3281 (and (fboundp 'reftex-add-index-macros)
Dave Love <fx@gnu.org>
parents:
diff changeset
3282 (reftex-add-index-macros '(multind)))))
Dave Love <fx@gnu.org>
parents:
diff changeset
3283 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3284
Dave Love <fx@gnu.org>
parents:
diff changeset
3285 If you have your own package @file{myindex} which defines the
Dave Love <fx@gnu.org>
parents:
diff changeset
3286 following macros to be used with the LaTeX @file{index.sty} file
Dave Love <fx@gnu.org>
parents:
diff changeset
3287 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
3288 \newcommand@{\molec@}[1]@{#1\index@{Molecules!#1@}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3289 \newcommand@{\aindex@}[1]@{#1\index[author]@{#1@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3290 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
3291
Dave Love <fx@gnu.org>
parents:
diff changeset
3292 you could write this in the style file @file{myindex.el}:
Dave Love <fx@gnu.org>
parents:
diff changeset
3293
Dave Love <fx@gnu.org>
parents:
diff changeset
3294 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3295 (TeX-add-style-hook "myindex"
Dave Love <fx@gnu.org>
parents:
diff changeset
3296 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3297 (TeX-add-symbols
Dave Love <fx@gnu.org>
parents:
diff changeset
3298 '("molec" TeX-arg-index)
Dave Love <fx@gnu.org>
parents:
diff changeset
3299 '("aindex" TeX-arg-index))
Dave Love <fx@gnu.org>
parents:
diff changeset
3300 (if (fboundp 'reftex-add-index-macros)
Dave Love <fx@gnu.org>
parents:
diff changeset
3301 (reftex-add-index-macros
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3302 '(("molec@{*@}" "idx" ?m "Molecules!" nil nil)
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3303 ("aindex@{*@}" "author" ?a "" nil nil))))))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3304 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3305
Dave Love <fx@gnu.org>
parents:
diff changeset
3306 @findex reftex-add-section-levels
Dave Love <fx@gnu.org>
parents:
diff changeset
3307 Finally the hook may contain a call to @code{reftex-add-section-levels}
Dave Love <fx@gnu.org>
parents:
diff changeset
3308 to define additional section statements. For example, the FoilTeX class
Dave Love <fx@gnu.org>
parents:
diff changeset
3309 has just two headers, @code{\foilhead} and @code{\rotatefoilhead}. Here
Dave Love <fx@gnu.org>
parents:
diff changeset
3310 is a style file @file{foils.el} that will inform @b{Ref@TeX{}} about these:
Dave Love <fx@gnu.org>
parents:
diff changeset
3311
Dave Love <fx@gnu.org>
parents:
diff changeset
3312 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3313 (TeX-add-style-hook "foils"
Dave Love <fx@gnu.org>
parents:
diff changeset
3314 (lambda ()
Dave Love <fx@gnu.org>
parents:
diff changeset
3315 (if (fboundp 'reftex-add-section-levels)
Dave Love <fx@gnu.org>
parents:
diff changeset
3316 (reftex-add-section-levels '(("foilhead" . 3)
Dave Love <fx@gnu.org>
parents:
diff changeset
3317 ("rotatefoilhead" . 3))))))
Dave Love <fx@gnu.org>
parents:
diff changeset
3318 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3319
Dave Love <fx@gnu.org>
parents:
diff changeset
3320 @node Bib-Cite, , Style Files, AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3321 @subsection Bib-Cite
Dave Love <fx@gnu.org>
parents:
diff changeset
3322 @cindex @code{bib-cite}, Emacs package
Dave Love <fx@gnu.org>
parents:
diff changeset
3323 @cindex Emacs packages, @code{bib-cite}
Dave Love <fx@gnu.org>
parents:
diff changeset
3324
Dave Love <fx@gnu.org>
parents:
diff changeset
3325 Once you have written a document with labels, references and citations,
Dave Love <fx@gnu.org>
parents:
diff changeset
3326 it can be nice to read it like a hypertext document. @b{Ref@TeX{}} has
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3327 support for that: @code{reftex-view-crossref} (bound to @kbd{C-c
37999
8e7df927fd92 Updated to version 4.16
Carsten Dominik <dominik@science.uva.nl>
parents: 37404
diff changeset
3328 &}), @code{reftex-mouse-view-crossref} (bound to @kbd{S-mouse-2}), and
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3329 @code{reftex-search-document}. A somewhat fancier interface with mouse
Dave Love <fx@gnu.org>
parents:
diff changeset
3330 highlighting is provided (among other things) by Peter S. Galbraith's
Dave Love <fx@gnu.org>
parents:
diff changeset
3331 @file{bib-cite.el}. There is some overlap in the functionalities of
Dave Love <fx@gnu.org>
parents:
diff changeset
3332 Bib-cite and @b{Ref@TeX{}}. Bib-cite.el comes bundled with
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3333 AUCTeX.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3334
Dave Love <fx@gnu.org>
parents:
diff changeset
3335 Bib-cite version 3.06 and later can be configured so that bib-cite's
Dave Love <fx@gnu.org>
parents:
diff changeset
3336 mouse functions use @b{Ref@TeX{}} for displaying references and citations.
Dave Love <fx@gnu.org>
parents:
diff changeset
3337 This can be useful in particular when working with the LaTeX @code{xr}
Dave Love <fx@gnu.org>
parents:
diff changeset
3338 package or with an explicit @code{thebibliography} environment (rather
Dave Love <fx@gnu.org>
parents:
diff changeset
3339 than BibTeX). Bib-cite cannot handle those, but @b{Ref@TeX{}} does. To
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3340 make use of this feature, try
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3341
Dave Love <fx@gnu.org>
parents:
diff changeset
3342 @vindex bib-cite-use-reftex-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
3343 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3344 (setq bib-cite-use-reftex-view-crossref t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3345 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3346
Dave Love <fx@gnu.org>
parents:
diff changeset
3347 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
3348 @node Problems and Work-Arounds, Imprint, Optimizations, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
3349 @section Problems and Work-arounds
Dave Love <fx@gnu.org>
parents:
diff changeset
3350 @cindex Problems and work-arounds
Dave Love <fx@gnu.org>
parents:
diff changeset
3351
Dave Love <fx@gnu.org>
parents:
diff changeset
3352 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
3353 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3354 @b{LaTeX commands}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3355 @cindex LaTeX commands, not found
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3356 @code{\input}, @code{\include}, and @code{\section} (etc.) statements
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3357 have to be first on a line (except for white space).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3358
Dave Love <fx@gnu.org>
parents:
diff changeset
3359 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3360 @b{Commented regions}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3361 @cindex Labels, commented out
Dave Love <fx@gnu.org>
parents:
diff changeset
3362 @b{Ref@TeX{}} sees also labels in regions commented out and will refuse to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3363 make duplicates of such labels. This is considered to be a feature.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3364
Dave Love <fx@gnu.org>
parents:
diff changeset
3365 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3366 @b{Wrong section numbers}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3367 @cindex Section numbers, wrong
Dave Love <fx@gnu.org>
parents:
diff changeset
3368 @vindex reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
3369 When using partial scans (@code{reftex-enable-partial-scans}), the section
Dave Love <fx@gnu.org>
parents:
diff changeset
3370 numbers in the table of contents may eventually become wrong. A full
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3371 scan will fix this.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3372
Dave Love <fx@gnu.org>
parents:
diff changeset
3373 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3374 @b{Local settings}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3375 @cindex Settings, local
Dave Love <fx@gnu.org>
parents:
diff changeset
3376 @findex reftex-add-label-environments
Dave Love <fx@gnu.org>
parents:
diff changeset
3377 @findex reftex-set-cite-format
Dave Love <fx@gnu.org>
parents:
diff changeset
3378 @findex reftex-add-section-levels
Dave Love <fx@gnu.org>
parents:
diff changeset
3379 The label environment definitions in @code{reftex-label-alist} are
Dave Love <fx@gnu.org>
parents:
diff changeset
3380 global and apply to all documents. If you need to make definitions
Dave Love <fx@gnu.org>
parents:
diff changeset
3381 local to a document, because they would interfere with settings in other
Dave Love <fx@gnu.org>
parents:
diff changeset
3382 documents, you should use AUCTeX and set up style files with calls to
Dave Love <fx@gnu.org>
parents:
diff changeset
3383 @code{reftex-add-label-environments}, @code{reftex-set-cite-format},
Dave Love <fx@gnu.org>
parents:
diff changeset
3384 @code{reftex-add-index-macros}, and @code{reftex-add-section-levels}.
Dave Love <fx@gnu.org>
parents:
diff changeset
3385 Settings made with these functions remain local to the current
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3386 document. @xref{AUCTeX}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3387
Dave Love <fx@gnu.org>
parents:
diff changeset
3388 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3389 @b{Funny display in selection buffer}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3390 @cindex @code{x-symbol}, Emacs package
Dave Love <fx@gnu.org>
parents:
diff changeset
3391 @cindex Emacs packages, @code{x-symbol}
Dave Love <fx@gnu.org>
parents:
diff changeset
3392 @cindex @code{isotex}, Emacs package
Dave Love <fx@gnu.org>
parents:
diff changeset
3393 @cindex Emacs packages, @code{isotex}
Dave Love <fx@gnu.org>
parents:
diff changeset
3394 @cindex @code{iso-cvt}, Emacs package
Dave Love <fx@gnu.org>
parents:
diff changeset
3395 @cindex Emacs packages, @code{iso-cvt}
Dave Love <fx@gnu.org>
parents:
diff changeset
3396 When using packages which make the buffer representation of a file
Dave Love <fx@gnu.org>
parents:
diff changeset
3397 different from its disk representation (e.g. x-symbol, isotex,
Dave Love <fx@gnu.org>
parents:
diff changeset
3398 iso-cvt) you may find that @b{Ref@TeX{}}'s parsing information sometimes
Dave Love <fx@gnu.org>
parents:
diff changeset
3399 reflects the disk state of a file. This happens only in @emph{unvisited}
Dave Love <fx@gnu.org>
parents:
diff changeset
3400 parts of a multifile document, because @b{Ref@TeX{}} visits these files
Dave Love <fx@gnu.org>
parents:
diff changeset
3401 literally for speed reasons. Then both short context and section
Dave Love <fx@gnu.org>
parents:
diff changeset
3402 headings may look different from what you usually see on your screen.
Dave Love <fx@gnu.org>
parents:
diff changeset
3403 In rare cases @code{reftex-toc} may have problems to jump to an affected
Dave Love <fx@gnu.org>
parents:
diff changeset
3404 section heading. There are three possible ways to deal with
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
3405 this:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3406 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
3407 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3408 @vindex reftex-keep-temporary-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
3409 @code{(setq reftex-keep-temporary-buffers t)}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3410 This implies that @b{Ref@TeX{}} will load all parts of a multifile
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3411 document into Emacs (i.e. there won't be any temporary buffers).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3412 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3413 @vindex reftex-initialize-temporary-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
3414 @code{(setq reftex-initialize-temporary-buffers t)}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3415 This means full initialization of temporary buffers. It involves
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3416 a penalty when the same unvisited file is used for lookup often.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3417 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3418 Set @code{reftex-initialize-temporary-buffers} to a list of hook
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3419 functions doing a minimal initialization.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3420 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
3421 @vindex reftex-refontify-context
Dave Love <fx@gnu.org>
parents:
diff changeset
3422 See also the variable @code{reftex-refontify-context}.
Dave Love <fx@gnu.org>
parents:
diff changeset
3423
Dave Love <fx@gnu.org>
parents:
diff changeset
3424 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3425 @b{Labels as arguments to \begin}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3426 @cindex @code{pf}, LaTeX package
Dave Love <fx@gnu.org>
parents:
diff changeset
3427 @cindex LaTeX packages, @code{pf}
Dave Love <fx@gnu.org>
parents:
diff changeset
3428 Some packages use an additional argument to a @code{\begin} macro
Dave Love <fx@gnu.org>
parents:
diff changeset
3429 to specify a label. E.g. Lamport's @file{pf.sty} uses both
Dave Love <fx@gnu.org>
parents:
diff changeset
3430 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
3431 \step@{@var{label}@}@{@var{claim}@} and \begin@{step+@}@{@var{label}@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3432 @var{claim}
Dave Love <fx@gnu.org>
parents:
diff changeset
3433 \end@{step+@}
Dave Love <fx@gnu.org>
parents:
diff changeset
3434 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
3435
Dave Love <fx@gnu.org>
parents:
diff changeset
3436 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3437 We need to trick @b{Ref@TeX{}} into swallowing this:
Dave Love <fx@gnu.org>
parents:
diff changeset
3438
Dave Love <fx@gnu.org>
parents:
diff changeset
3439 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3440 @group
Dave Love <fx@gnu.org>
parents:
diff changeset
3441 ;; Configuration for Lamport's pf.sty
Dave Love <fx@gnu.org>
parents:
diff changeset
3442 (setq reftex-label-alist
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3443 '(("\\step@{*@}@{@}" ?p "st:" "~\\stepref@{%s@}" 2 ("Step" "St."))
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3444 ("\\begin@{step+@}@{*@}" ?p "st:" "~\\stepref@{%s@}" 1000)))
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3445 @end group
Dave Love <fx@gnu.org>
parents:
diff changeset
3446 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3447
Dave Love <fx@gnu.org>
parents:
diff changeset
3448 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3449 The first line is just a normal configuration for a macro. For the
Dave Love <fx@gnu.org>
parents:
diff changeset
3450 @code{step+} environment we actually tell @b{Ref@TeX{}} to look for the
Dave Love <fx@gnu.org>
parents:
diff changeset
3451 @emph{macro} @samp{\begin@{step+@}} and interpret the @emph{first}
Dave Love <fx@gnu.org>
parents:
diff changeset
3452 argument (which really is a second argument to the macro @code{\begin})
Dave Love <fx@gnu.org>
parents:
diff changeset
3453 as a label of type @code{?p}. Argument count for this macro starts only
Dave Love <fx@gnu.org>
parents:
diff changeset
3454 after the @samp{@{step+@}}, also when specifying how to get
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
3455 context.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3456
Dave Love <fx@gnu.org>
parents:
diff changeset
3457 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3458 @b{Idle timers in XEmacs}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3459 @cindex Idle timer restart
Dave Love <fx@gnu.org>
parents:
diff changeset
3460 @vindex reftex-use-itimer-in-xemacs
Dave Love <fx@gnu.org>
parents:
diff changeset
3461 In XEmacs, idle timer restart does not work reliably after fast
Dave Love <fx@gnu.org>
parents:
diff changeset
3462 keystrokes. Therefore @b{Ref@TeX{}} currently uses the post command
Dave Love <fx@gnu.org>
parents:
diff changeset
3463 hook to start the timer used for automatic crossref information. When
Dave Love <fx@gnu.org>
parents:
diff changeset
3464 this bug gets fixed, a real idle timer can be requested with
Dave Love <fx@gnu.org>
parents:
diff changeset
3465 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3466 (setq reftex-use-itimer-in-xemacs t)
Dave Love <fx@gnu.org>
parents:
diff changeset
3467 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3468
Dave Love <fx@gnu.org>
parents:
diff changeset
3469 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3470 @b{Viper mode}@*
Dave Love <fx@gnu.org>
parents:
diff changeset
3471 @cindex Viper mode
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
3472 @cindex Key bindings, problems with Viper mode
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3473 @findex viper-harness-minor-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
3474 With @i{Viper} mode prior to Vipers version 3.01, you need to protect
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3475 @b{Ref@TeX{}}'s keymaps with
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3476
Dave Love <fx@gnu.org>
parents:
diff changeset
3477 @lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3478 (viper-harness-minor-mode "reftex")
Dave Love <fx@gnu.org>
parents:
diff changeset
3479 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
3480
Dave Love <fx@gnu.org>
parents:
diff changeset
3481 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
3482
Dave Love <fx@gnu.org>
parents:
diff changeset
3483 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
3484 @node Imprint, Commands, Problems and Work-Arounds, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
3485 @section Imprint
Dave Love <fx@gnu.org>
parents:
diff changeset
3486 @cindex Imprint
Dave Love <fx@gnu.org>
parents:
diff changeset
3487 @cindex Maintainer
Dave Love <fx@gnu.org>
parents:
diff changeset
3488 @cindex Acknowledgments
Dave Love <fx@gnu.org>
parents:
diff changeset
3489 @cindex Thanks
Dave Love <fx@gnu.org>
parents:
diff changeset
3490 @cindex Bug reports
Dave Love <fx@gnu.org>
parents:
diff changeset
3491 @cindex @code{http}, @b{Ref@TeX{}} home page
Dave Love <fx@gnu.org>
parents:
diff changeset
3492 @cindex @code{ftp}, @b{Ref@TeX{}} site
Dave Love <fx@gnu.org>
parents:
diff changeset
3493
58872
6233bef879d8 (Imprint): Remove erroneous @value's.
Luc Teirlinck <teirllm@auburn.edu>
parents: 57912
diff changeset
3494 @b{Ref@TeX{}} was written by @i{Carsten Dominik}
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3495 @email{dominik@@science.uva.nl}, with contributions by @i{Stephen
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
3496 Eglen}. @b{Ref@TeX{}} is currently maintained by
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3497
Dave Love <fx@gnu.org>
parents:
diff changeset
3498 @noindent
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3499 Carsten Dominik <dominik@@science.uva.nl>
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3500
Dave Love <fx@gnu.org>
parents:
diff changeset
3501 If you have questions about @b{Ref@TeX{}}, there are several Usenet
Dave Love <fx@gnu.org>
parents:
diff changeset
3502 groups which have competent readers: @code{comp.emacs},
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3503 @code{gnu.emacs.help}, @code{comp.emacs.xemacs}, @code{comp.text.tex},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3504 @code{de.comp.text.tex}. You can also write directly to the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3505 maintainer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3506
Dave Love <fx@gnu.org>
parents:
diff changeset
3507 If you find a bug in @b{Ref@TeX{}} or its documentation, or if you want
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3508 to contribute code or ideas, please @value{MAINTAINERCONTACT}. Remember
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3509 to provide all necessary information such as version numbers of Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
3510 and @b{Ref@TeX{}}, and the relevant part of your configuration in
Dave Love <fx@gnu.org>
parents:
diff changeset
3511 @file{.emacs}. When reporting a bug which throws an exception, please
Dave Love <fx@gnu.org>
parents:
diff changeset
3512 include a backtrace if you know how to produce one.
Dave Love <fx@gnu.org>
parents:
diff changeset
3513
Dave Love <fx@gnu.org>
parents:
diff changeset
3514 @b{Ref@TeX{}} is bundled and pre-installed with Emacs since version 20.2.
Dave Love <fx@gnu.org>
parents:
diff changeset
3515 It was also bundled and pre-installed with XEmacs 19.16--20.x. XEmacs
Dave Love <fx@gnu.org>
parents:
diff changeset
3516 21.x users want to install the corresponding plugin package which is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3517 available from the @value{XEMACSFTP}. See the XEmacs 21.x
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3518 documentation on package installation for details.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3519
Dave Love <fx@gnu.org>
parents:
diff changeset
3520 Users of earlier Emacs distributions (including Emacs 19) can get a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3521 @b{Ref@TeX{}} distribution from the @value{MAINTAINERSITE}. Note that
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3522 the Emacs 19 version supports many but not all features described in
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3523 this manual.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3524
Dave Love <fx@gnu.org>
parents:
diff changeset
3525 Thanks to the people on the Net who have used @b{Ref@TeX{}} and helped
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3526 developing it with their reports. In particular thanks to @i{Ralf
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3527 Angeli, Fran Burstall, Alastair Burt, Lars Clausen, Soren Dayton,
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3528 Stephen Eglen, Karl Eichwalder, Erik Frisk, Peter Galbraith, Kai
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3529 Grossjohann, Frank Harrell, Till A. Heilmann, Peter Heslin, Stephan
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3530 Heuel, Alan Ho, Lute Kamstra, Dieter Kraft, David Kastrup, Adrian Lanz,
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3531 Juri Linkov, Rory Molinari, Stefan Monnier, Laurent Mugnier, Dan
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3532 Nicolaescu, Sudeep Kumar Palat, Daniel Polani, Alan Shutko, Robin Socha,
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3533 Richard Stanton, Allan Strand, Jan Vroonhof, Christoph Wedler, Alan
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
3534 Williams, Roland Winkler, Hans-Christoph Wirth, Eli Zaretskii}.
59731
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3535
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3536
Dave Love <fx@gnu.org>
parents:
diff changeset
3537 The @code{view-crossref} feature was inspired by @i{Peter Galbraith's}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3538 @file{bib-cite.el}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3539
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3540 Finally thanks to @i{Uwe Bolick} who first got me interested in
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3541 supporting LaTeX labels and references with an editor (which was
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3542 MicroEmacs at the time).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3543
Dave Love <fx@gnu.org>
parents:
diff changeset
3544 @node Commands, Options, Imprint, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
3545 @chapter Commands
Dave Love <fx@gnu.org>
parents:
diff changeset
3546 @cindex Commands, list of
Dave Love <fx@gnu.org>
parents:
diff changeset
3547
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3548 Here is a summary of @b{Ref@TeX{}}'s commands which can be executed from
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3549 LaTeX files. Command which are executed from the special buffers are
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3550 not described here. All commands are available from the @code{Ref}
39267
a8c0a02f6129 Spelling corrections.
Richard M. Stallman <rms@gnu.org>
parents: 38003
diff changeset
3551 menu. See @xref{Key Bindings}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3552
Dave Love <fx@gnu.org>
parents:
diff changeset
3553 @deffn Command reftex-toc
Dave Love <fx@gnu.org>
parents:
diff changeset
3554 Show the table of contents for the current document. When called with
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3555 one ore two @kbd{C-u} prefixes, rescan the document first.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3556 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3557
Dave Love <fx@gnu.org>
parents:
diff changeset
3558 @deffn Command reftex-label
Dave Love <fx@gnu.org>
parents:
diff changeset
3559 Insert a unique label. With one or two @kbd{C-u} prefixes, enforce
Dave Love <fx@gnu.org>
parents:
diff changeset
3560 document rescan first.
Dave Love <fx@gnu.org>
parents:
diff changeset
3561 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3562
Dave Love <fx@gnu.org>
parents:
diff changeset
3563 @deffn Command reftex-reference
Dave Love <fx@gnu.org>
parents:
diff changeset
3564 Start a selection process to select a label, and insert a reference to
Dave Love <fx@gnu.org>
parents:
diff changeset
3565 it. With one or two @kbd{C-u} prefixes, enforce document rescan first.
Dave Love <fx@gnu.org>
parents:
diff changeset
3566 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3567
Dave Love <fx@gnu.org>
parents:
diff changeset
3568 @deffn Command reftex-citation
Dave Love <fx@gnu.org>
parents:
diff changeset
3569 Make a citation using BibTeX database files. After prompting for a regular
Dave Love <fx@gnu.org>
parents:
diff changeset
3570 expression, scans the buffers with BibTeX entries (taken from the
Dave Love <fx@gnu.org>
parents:
diff changeset
3571 @code{\bibliography} command or a @code{thebibliography} environment)
Dave Love <fx@gnu.org>
parents:
diff changeset
3572 and offers the matching entries for selection. The selected entry is
46918
82d113655734 Minor spelling and grammar corrections.
Paul Eggert <eggert@twinsun.com>
parents: 46684
diff changeset
3573 formatted according to @code{reftex-cite-format} and inserted into the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3574 buffer. @*
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3575 When called with a @kbd{C-u} prefixe, prompt for optional arguments in
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3576 cite macros. When called with a numeric prefix, make that many citations.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3577 When called with point inside the braces of a @code{\cite} command, it
Dave Love <fx@gnu.org>
parents:
diff changeset
3578 will add another key, ignoring the value of
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
3579 @code{reftex-cite-format}. @*
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3580 The regular expression uses an expanded syntax: @samp{&&} is interpreted
Dave Love <fx@gnu.org>
parents:
diff changeset
3581 as @code{and}. Thus, @samp{aaaa&&bbb} matches entries which contain
Dave Love <fx@gnu.org>
parents:
diff changeset
3582 both @samp{aaaa} and @samp{bbb}. While entering the regexp, completion
Dave Love <fx@gnu.org>
parents:
diff changeset
3583 on knows citation keys is possible. @samp{=} is a good regular
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3584 expression to match all entries in all files.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3585 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3586
Dave Love <fx@gnu.org>
parents:
diff changeset
3587 @deffn Command reftex-index
Dave Love <fx@gnu.org>
parents:
diff changeset
3588 Query for an index macro and insert it along with its arguments. The
Dave Love <fx@gnu.org>
parents:
diff changeset
3589 index macros available are those defined in @code{reftex-index-macro} or
Dave Love <fx@gnu.org>
parents:
diff changeset
3590 by a call to @code{reftex-add-index-macros}, typically from an AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
3591 style file. @b{Ref@TeX{}} provides completion for the index tag and the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3592 index key, and will prompt for other arguments.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3593 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3594
Dave Love <fx@gnu.org>
parents:
diff changeset
3595 @deffn Command reftex-index-selection-or-word
Dave Love <fx@gnu.org>
parents:
diff changeset
3596 Put current selection or the word near point into the default index
Dave Love <fx@gnu.org>
parents:
diff changeset
3597 macro. This uses the information in @code{reftex-index-default-macro}
Dave Love <fx@gnu.org>
parents:
diff changeset
3598 to make an index entry. The phrase indexed is the current selection or
Dave Love <fx@gnu.org>
parents:
diff changeset
3599 the word near point. When called with one @kbd{C-u} prefix, let the
Dave Love <fx@gnu.org>
parents:
diff changeset
3600 user have a chance to edit the index entry. When called with 2
Dave Love <fx@gnu.org>
parents:
diff changeset
3601 @kbd{C-u} as prefix, also ask for the index macro and other stuff. When
Dave Love <fx@gnu.org>
parents:
diff changeset
3602 called inside TeX math mode as determined by the @file{texmathp.el}
Dave Love <fx@gnu.org>
parents:
diff changeset
3603 library which is part of AUCTeX, the string is first processed with the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3604 @code{reftex-index-math-format}, which see.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3605 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3606
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3607 @deffn Command reftex-index-phrase-selection-or-word
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3608 Add current selection or the word at point to the phrases buffer.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3609 When you are in transient-mark-mode and the region is active, the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3610 selection will be used - otherwise the word at point.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3611 You get a chance to edit the entry in the phrases buffer - to save the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3612 buffer and return to the LaTeX document, finish with @kbd{C-c C-c}.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3613 @end deffn
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3614
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3615 @deffn Command reftex-index-visit-phrases-buffer
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3616 Switch to the phrases buffer, initialize if empty.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3617 @end deffn
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3618
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3619 @deffn Command reftex-index-phrases-apply-to-region
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3620 Index all index phrases in the current region.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3621 This works exactly like global indexing from the index phrases buffer,
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3622 but operation is restricted to the current region.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3623 @end deffn
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3624
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3625 @deffn Command reftex-display-index
Dave Love <fx@gnu.org>
parents:
diff changeset
3626 Display a buffer with an index compiled from the current document.
Dave Love <fx@gnu.org>
parents:
diff changeset
3627 When the document has multiple indices, first prompts for the correct one.
Dave Love <fx@gnu.org>
parents:
diff changeset
3628 When index support is turned off, offer to turn it on.
Dave Love <fx@gnu.org>
parents:
diff changeset
3629 With one or two @kbd{C-u} prefixes, rescan document first.
Dave Love <fx@gnu.org>
parents:
diff changeset
3630 With prefix 2, restrict index to current document section.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3631 With prefix 3, restrict index to active region.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3632 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3633
Dave Love <fx@gnu.org>
parents:
diff changeset
3634 @deffn Command reftex-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
3635 View cross reference of macro at point. Point must be on the @var{key}
Dave Love <fx@gnu.org>
parents:
diff changeset
3636 argument. Works with the macros @code{\label}, @code{\ref},
Dave Love <fx@gnu.org>
parents:
diff changeset
3637 @code{\cite}, @code{\bibitem}, @code{\index} and many derivatives of
Dave Love <fx@gnu.org>
parents:
diff changeset
3638 these. Where it makes sense, subsequent calls show additional
Dave Love <fx@gnu.org>
parents:
diff changeset
3639 locations. See also the variable @code{reftex-view-crossref-extra} and
Dave Love <fx@gnu.org>
parents:
diff changeset
3640 the command @code{reftex-view-crossref-from-bibtex}. With one or two
Dave Love <fx@gnu.org>
parents:
diff changeset
3641 @kbd{C-u} prefixes, enforce rescanning of the document. With argument
Dave Love <fx@gnu.org>
parents:
diff changeset
3642 2, select the window showing the cross reference.
Dave Love <fx@gnu.org>
parents:
diff changeset
3643 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3644
Dave Love <fx@gnu.org>
parents:
diff changeset
3645 @deffn Command reftex-view-crossref-from-bibtex
Dave Love <fx@gnu.org>
parents:
diff changeset
3646 View location in a LaTeX document which cites the BibTeX entry at point.
Dave Love <fx@gnu.org>
parents:
diff changeset
3647 Since BibTeX files can be used by many LaTeX documents, this function
Dave Love <fx@gnu.org>
parents:
diff changeset
3648 prompts upon first use for a buffer in @b{Ref@TeX{}} mode. To reset this
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3649 link to a document, call the function with a prefix arg. Calling
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3650 this function several times find successive citation locations.
Dave Love <fx@gnu.org>
parents:
diff changeset
3651 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3652
Dave Love <fx@gnu.org>
parents:
diff changeset
3653 @deffn Command reftex-create-tags-file
Dave Love <fx@gnu.org>
parents:
diff changeset
3654 Create TAGS file by running @code{etags} on the current document. The
Dave Love <fx@gnu.org>
parents:
diff changeset
3655 TAGS file is also immediately visited with
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3656 @code{visit-tags-table}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3657 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3658
Dave Love <fx@gnu.org>
parents:
diff changeset
3659 @deffn Command reftex-grep-document
Dave Love <fx@gnu.org>
parents:
diff changeset
3660 Run grep query through all files related to this document.
Dave Love <fx@gnu.org>
parents:
diff changeset
3661 With prefix arg, force to rescan document.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3662 No active TAGS table is required.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3663 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3664
Dave Love <fx@gnu.org>
parents:
diff changeset
3665 @deffn Command reftex-search-document
Dave Love <fx@gnu.org>
parents:
diff changeset
3666 Regexp search through all files of the current document.
Dave Love <fx@gnu.org>
parents:
diff changeset
3667 Starts always in the master file. Stops when a match is found.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3668 No active TAGS table is required.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3669 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3670
Dave Love <fx@gnu.org>
parents:
diff changeset
3671 @deffn Command reftex-query-replace-document
Dave Love <fx@gnu.org>
parents:
diff changeset
3672 Run a query-replace-regexp of @var{from} with @var{to} over the entire
Dave Love <fx@gnu.org>
parents:
diff changeset
3673 document. With prefix arg, replace only word-delimited matches. No
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3674 active TAGS table is required.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3675 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3676
59731
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3677 @deffn Command reftex-isearch-minor-mode
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3678 Toggle a minor mode which enables incremental search to work globally
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3679 on the entire multifile document. Files will be searched in th
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3680 sequence they appear in the document.
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3681 @end deffn
03809ff92a7f documented `reftex-isearch-minor-mode'
Carsten Dominik <dominik@science.uva.nl>
parents: 59579
diff changeset
3682
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3683 @deffn Command reftex-goto-label
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3684 Prompt for a label (with completion) and jump to the location of this
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3685 label. Optional prefix argument @var{other-window} goes to the label in
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3686 another window.
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3687 @end deffn
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3688
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3689
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3690 @deffn Command reftex-change-label
Dave Love <fx@gnu.org>
parents:
diff changeset
3691 Query replace @var{from} with @var{to} in all @code{\label} and
Dave Love <fx@gnu.org>
parents:
diff changeset
3692 @code{\ref} commands. Works on the entire multifile document. No
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3693 active TAGS table is required.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3694 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3695
Dave Love <fx@gnu.org>
parents:
diff changeset
3696 @deffn Command reftex-renumber-simple-labels
Dave Love <fx@gnu.org>
parents:
diff changeset
3697 Renumber all simple labels in the document to make them sequentially.
Dave Love <fx@gnu.org>
parents:
diff changeset
3698 Simple labels are the ones created by RefTeX, consisting only of the
Dave Love <fx@gnu.org>
parents:
diff changeset
3699 prefix and a number. After the command completes, all these labels will
Dave Love <fx@gnu.org>
parents:
diff changeset
3700 have sequential numbers throughout the document. Any references to the
Dave Love <fx@gnu.org>
parents:
diff changeset
3701 labels will be changed as well. For this, @b{Ref@TeX{}} looks at the
Dave Love <fx@gnu.org>
parents:
diff changeset
3702 arguments of any macros which either start or end with the string
Dave Love <fx@gnu.org>
parents:
diff changeset
3703 @samp{ref}. This command should be used with care, in particular in
Dave Love <fx@gnu.org>
parents:
diff changeset
3704 multifile documents. You should not use it if another document refers
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3705 to this one with the @code{xr} package.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3706 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3707
Dave Love <fx@gnu.org>
parents:
diff changeset
3708 @deffn Command reftex-find-duplicate-labels
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3709 Produce a list of all duplicate labels in the document.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3710 @end deffn
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3711
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3712 @deffn Command reftex-create-bibtex-file
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3713 Create a new BibTeX database file with all entries referenced in document.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3714 The command prompts for a filename and writes the collected entries to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3715 that file. Only entries referenced in the current document with
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
3716 any @code{\cite}-like macros are used.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3717 The sequence in the new file is the same as it was in the old database.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3718 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3719
Dave Love <fx@gnu.org>
parents:
diff changeset
3720 @deffn Command reftex-customize
Dave Love <fx@gnu.org>
parents:
diff changeset
3721 Run the customize browser on the @b{Ref@TeX{}} group.
Dave Love <fx@gnu.org>
parents:
diff changeset
3722 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3723 @deffn Command reftex-show-commentary
Dave Love <fx@gnu.org>
parents:
diff changeset
3724 Show the commentary section from @file{reftex.el}.
Dave Love <fx@gnu.org>
parents:
diff changeset
3725 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3726 @deffn Command reftex-info
Dave Love <fx@gnu.org>
parents:
diff changeset
3727 Run info on the top @b{Ref@TeX{}} node.
Dave Love <fx@gnu.org>
parents:
diff changeset
3728 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3729 @deffn Command reftex-parse-document
Dave Love <fx@gnu.org>
parents:
diff changeset
3730 Parse the entire document in order to update the parsing information.
Dave Love <fx@gnu.org>
parents:
diff changeset
3731 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3732 @deffn Command reftex-reset-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
3733 Enforce rebuilding of several internal lists and variables. Also
Dave Love <fx@gnu.org>
parents:
diff changeset
3734 removes the parse file associated with the current document.
Dave Love <fx@gnu.org>
parents:
diff changeset
3735 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3736
Dave Love <fx@gnu.org>
parents:
diff changeset
3737 @node Options, Keymaps and Hooks, Commands, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
3738 @chapter Options, Keymaps, Hooks
Dave Love <fx@gnu.org>
parents:
diff changeset
3739 @cindex Options, list of
Dave Love <fx@gnu.org>
parents:
diff changeset
3740
Dave Love <fx@gnu.org>
parents:
diff changeset
3741 Here is a complete list of @b{Ref@TeX{}}'s configuration variables. All
Dave Love <fx@gnu.org>
parents:
diff changeset
3742 variables have customize support - so if you are not familiar with Emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
3743 Lisp (and even if you are) you might find it more comfortable to use
Dave Love <fx@gnu.org>
parents:
diff changeset
3744 @code{customize} to look at and change these variables. @kbd{M-x
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3745 reftex-customize} will get you there.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3746
Dave Love <fx@gnu.org>
parents:
diff changeset
3747 @menu
Dave Love <fx@gnu.org>
parents:
diff changeset
3748 * Options (Table of Contents)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3749 * Options (Defining Label Environments)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3750 * Options (Creating Labels)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3751 * Options (Referencing Labels)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3752 * Options (Creating Citations)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3753 * Options (Index Support)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3754 * Options (Viewing Cross-References)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3755 * Options (Finding Files)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3756 * Options (Optimizations)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3757 * Options (Fontification)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3758 * Options (Misc)::
Dave Love <fx@gnu.org>
parents:
diff changeset
3759 @end menu
Dave Love <fx@gnu.org>
parents:
diff changeset
3760
Dave Love <fx@gnu.org>
parents:
diff changeset
3761 @node Options (Table of Contents), Options (Defining Label Environments), , Options
Dave Love <fx@gnu.org>
parents:
diff changeset
3762 @section Table of Contents
Dave Love <fx@gnu.org>
parents:
diff changeset
3763 @cindex Options, table of contents
Dave Love <fx@gnu.org>
parents:
diff changeset
3764 @cindex Table of contents, options
Dave Love <fx@gnu.org>
parents:
diff changeset
3765
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3766 @defopt reftex-include-file-commands
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3767 List of LaTeX commands which input another file.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3768 The file name is expected after the command, either in braces or separated
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3769 by whitespace.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3770 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3771
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3772 @defopt reftex-max-section-depth
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3773 Maximum depth of section levels in document structure.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3774 Standard LaTeX needs 7, default is 12.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3775 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3776
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3777 @defopt reftex-section-levels
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3778 Commands and levels used for defining sections in the document. The
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3779 @code{car} of each cons cell is the name of the section macro. The
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3780 @code{cdr} is a number indicating its level. A negative level means the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3781 same as the positive value, but the section will never get a number.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3782 The @code{cdr} may also be a function which then has to return the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3783 level. This list is also used for promotion and demption of sectioning
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3784 commands. If you are using a document class which has several sets of
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3785 sectioning commands, promotion only works correctly if this list is
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3786 sorted first by set, then within each set by level. The promotion
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3787 commands always select the nearest entry with the correct new level.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3788
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3789 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3790
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3791 @defopt reftex-toc-max-level
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3792 The maximum level of toc entries which will be included in the TOC.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3793 Section headings with a bigger level will be ignored. In RefTeX,
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3794 chapters are level 1, sections level 2 etc. This variable can be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3795 changed from within the @file{*toc*} buffer with the @kbd{t} key.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3796 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3797
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3798 @defopt reftex-part-resets-chapter
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3799 Non-@code{nil} means, @code{\part} is like any other sectioning command.
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3800 This means, part numbers will be included in the numbering of chapters, and
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3801 chapter counters will be reset for each part.
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3802 When @code{nil} (the default), parts are special, do not reset the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3803 chapter counter and also do not show up in chapter numbers.
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3804 @end defopt
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3805
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3806 @defopt reftex-auto-recenter-toc
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3807 Non-@code{nil} means, turn automatic recentering of @file{*TOC*} window on.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3808 When active, the @file{*TOC*} window will always show the section you
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3809 are currently working in. Recentering happens whenever Emacs is idle for
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3810 more than @code{reftex-idle-time} seconds.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3811
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3812 Value @code{t} means, turn on immediately when RefTeX gets started. Then,
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3813 recentering will work for any toc window created during the session.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3814
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3815 Value @code{frame} (the default) means, turn automatic recentering on
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3816 only while the dedicated TOC frame does exist, and do the recentering
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3817 only in that frame. So when creating that frame (with @kbd{d} key in an
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3818 ordinary TOC window), the automatic recentering is turned on. When the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3819 frame gets destroyed, automatic recentering is turned off again.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3820
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
3821 This feature can be turned on and off from the menu
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3822 (Ref->Options).
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3823 @end defopt
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
3824
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3825 @defopt reftex-toc-split-windows-horizontally
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3826 Non-@code{nil} means, create TOC window by splitting window
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3827 horizontally. The default is to split vertically.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3828 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3829
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3830 @defopt reftex-toc-split-windows-fraction
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3831 Fraction of the width or height of the frame to be used for TOC window.
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3832 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3833
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3834 @defopt reftex-toc-keep-other-windows
Dave Love <fx@gnu.org>
parents:
diff changeset
3835 Non-@code{nil} means, split the selected window to display the
Dave Love <fx@gnu.org>
parents:
diff changeset
3836 @file{*toc*} buffer. This helps to keep the window configuration, but
Dave Love <fx@gnu.org>
parents:
diff changeset
3837 makes the @file{*toc*} small. When @code{nil}, all other windows except
Dave Love <fx@gnu.org>
parents:
diff changeset
3838 the selected one will be deleted, so that the @file{*toc*} window fills
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3839 half the frame.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3840 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3841
Dave Love <fx@gnu.org>
parents:
diff changeset
3842 @defopt reftex-toc-include-file-boundaries
Dave Love <fx@gnu.org>
parents:
diff changeset
3843 Non-@code{nil} means, include file boundaries in @file{*toc*} buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
3844 This flag can be toggled from within the @file{*toc*} buffer with the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3845 @kbd{i} key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3846 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3847
Dave Love <fx@gnu.org>
parents:
diff changeset
3848 @defopt reftex-toc-include-labels
Dave Love <fx@gnu.org>
parents:
diff changeset
3849 Non-@code{nil} means, include labels in @file{*toc*} buffer. This flag
Dave Love <fx@gnu.org>
parents:
diff changeset
3850 can be toggled from within the @file{*toc*} buffer with the @kbd{l}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3851 key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3852 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3853
Dave Love <fx@gnu.org>
parents:
diff changeset
3854 @defopt reftex-toc-include-index-entries
Dave Love <fx@gnu.org>
parents:
diff changeset
3855 Non-@code{nil} means, include index entries in @file{*toc*} buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
3856 This flag can be toggled from within the @file{*toc*} buffer with the
Dave Love <fx@gnu.org>
parents:
diff changeset
3857 @kbd{i} key.
Dave Love <fx@gnu.org>
parents:
diff changeset
3858 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3859
Dave Love <fx@gnu.org>
parents:
diff changeset
3860 @defopt reftex-toc-include-context
Dave Love <fx@gnu.org>
parents:
diff changeset
3861 Non-@code{nil} means, include context with labels in the @file{*toc*}
Dave Love <fx@gnu.org>
parents:
diff changeset
3862 buffer. Context will only be shown if the labels are visible as well.
Dave Love <fx@gnu.org>
parents:
diff changeset
3863 This flag can be toggled from within the @file{*toc*} buffer with the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3864 @kbd{c} key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3865 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3866
Dave Love <fx@gnu.org>
parents:
diff changeset
3867 @defopt reftex-toc-follow-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
3868 Non-@code{nil} means, point in @file{*toc*} buffer (the
Dave Love <fx@gnu.org>
parents:
diff changeset
3869 table-of-contents buffer) will cause other window to follow. The other
Dave Love <fx@gnu.org>
parents:
diff changeset
3870 window will show the corresponding part of the document. This flag can
Dave Love <fx@gnu.org>
parents:
diff changeset
3871 be toggled from within the @file{*toc*} buffer with the @kbd{f}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3872 key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3873 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3874
Dave Love <fx@gnu.org>
parents:
diff changeset
3875 @deffn {Normal Hook} reftex-toc-mode-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
3876 Normal hook which is run when a @file{*toc*} buffer is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3877 created.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3878 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3879
Dave Love <fx@gnu.org>
parents:
diff changeset
3880 @deffn Keymap reftex-toc-map
Dave Love <fx@gnu.org>
parents:
diff changeset
3881 The keymap which is active in the @file{*toc*} buffer.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3882 (@pxref{Table of Contents}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3883 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
3884
Dave Love <fx@gnu.org>
parents:
diff changeset
3885 @node Options (Defining Label Environments), Options (Creating Labels), Options (Table of Contents), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
3886 @section Defining Label Environments
Dave Love <fx@gnu.org>
parents:
diff changeset
3887 @cindex Options, defining label environments
Dave Love <fx@gnu.org>
parents:
diff changeset
3888 @cindex Defining label environments, options
Dave Love <fx@gnu.org>
parents:
diff changeset
3889
Dave Love <fx@gnu.org>
parents:
diff changeset
3890 @defopt reftex-default-label-alist-entries
Dave Love <fx@gnu.org>
parents:
diff changeset
3891 Default label alist specifications. It is a list of symbols with
Dave Love <fx@gnu.org>
parents:
diff changeset
3892 associations in the constant @code{reftex-label-alist-builtin}.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3893 @code{LaTeX} should always be the last entry.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3894 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
3895
Dave Love <fx@gnu.org>
parents:
diff changeset
3896 @defopt reftex-label-alist
Dave Love <fx@gnu.org>
parents:
diff changeset
3897 Set this variable to define additions and changes to the defaults in
Dave Love <fx@gnu.org>
parents:
diff changeset
3898 @code{reftex-default-label-alist-entries}. The only things you
Dave Love <fx@gnu.org>
parents:
diff changeset
3899 @emph{must not} change is that @code{?s} is the type indicator for
Dave Love <fx@gnu.org>
parents:
diff changeset
3900 section labels, and @key{SPC} for the @code{any} label type. These are
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3901 hard-coded at other places in the code.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3902
Dave Love <fx@gnu.org>
parents:
diff changeset
3903 The value of the variable must be a list of items. Each item is a list
Dave Love <fx@gnu.org>
parents:
diff changeset
3904 itself and has the following structure:
Dave Love <fx@gnu.org>
parents:
diff changeset
3905
Dave Love <fx@gnu.org>
parents:
diff changeset
3906 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
3907 (@var{env-or-macro} @var{type-key} @var{label-prefix} @var{reference-format}
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
3908 @var{context-method} (@var{magic-word} ... ) @var{toc-level})
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3909 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
3910
Dave Love <fx@gnu.org>
parents:
diff changeset
3911 Each list entry describes either an environment carrying a counter for
Dave Love <fx@gnu.org>
parents:
diff changeset
3912 use with @code{\label} and @code{\ref}, or a LaTeX macro defining a
Dave Love <fx@gnu.org>
parents:
diff changeset
3913 label as (or inside) one of its arguments. The elements of each list
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3914 entry are:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3915
Dave Love <fx@gnu.org>
parents:
diff changeset
3916 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
3917 @item @var{env-or-macro}
Dave Love <fx@gnu.org>
parents:
diff changeset
3918 Name of the environment (like @samp{table}) or macro (like
Dave Love <fx@gnu.org>
parents:
diff changeset
3919 @samp{\myfig}). For macros, indicate the arguments, as in
Dave Love <fx@gnu.org>
parents:
diff changeset
3920 @samp{\myfig[]@{@}@{@}@{*@}@{@}}. Use square brackets for optional
Dave Love <fx@gnu.org>
parents:
diff changeset
3921 arguments, a star to mark the label argument, if any. The macro does
Dave Love <fx@gnu.org>
parents:
diff changeset
3922 not have to have a label argument - you could also use
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3923 @samp{\label@{...@}} inside one of its arguments.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3924
Dave Love <fx@gnu.org>
parents:
diff changeset
3925 Special names: @code{section} for section labels, @code{any} to define a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3926 group which contains all labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3927
Dave Love <fx@gnu.org>
parents:
diff changeset
3928 This may also be a function to do local parsing and identify point to be
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
3929 in a non-standard label environment. The function must take an
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3930 argument @var{bound} and limit backward searches to this value. It
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
3931 should return either nil or a cons cell @code{(@var{function}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3932 . @var{position})} with the function symbol and the position where the
Dave Love <fx@gnu.org>
parents:
diff changeset
3933 special environment starts. See the Info documentation for an
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3934 example.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3935
Dave Love <fx@gnu.org>
parents:
diff changeset
3936 Finally this may also be @code{nil} if the entry is only meant to change
Dave Love <fx@gnu.org>
parents:
diff changeset
3937 some settings associated with the type indicator character (see
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3938 below).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3939
Dave Love <fx@gnu.org>
parents:
diff changeset
3940 @item @var{type-key}
Dave Love <fx@gnu.org>
parents:
diff changeset
3941 Type indicator character, like @code{?t}, must be a printable ASCII
Dave Love <fx@gnu.org>
parents:
diff changeset
3942 character. The type indicator is a single character which defines a
Dave Love <fx@gnu.org>
parents:
diff changeset
3943 label type. Any label inside the environment or macro is assumed to
Dave Love <fx@gnu.org>
parents:
diff changeset
3944 belong to this type. The same character may occur several times in this
Dave Love <fx@gnu.org>
parents:
diff changeset
3945 list, to cover cases in which different environments carry the same
Dave Love <fx@gnu.org>
parents:
diff changeset
3946 label type (like @code{equation} and @code{eqnarray}). If the type
Dave Love <fx@gnu.org>
parents:
diff changeset
3947 indicator is @code{nil} and the macro has a label argument @samp{@{*@}},
Dave Love <fx@gnu.org>
parents:
diff changeset
3948 the macro defines neutral labels just like @code{\label}. In this case
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3949 the reminder of this entry is ignored.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3950
Dave Love <fx@gnu.org>
parents:
diff changeset
3951 @item @var{label-prefix}
Dave Love <fx@gnu.org>
parents:
diff changeset
3952 Label prefix string, like @samp{tab:}. The prefix is a short string
Dave Love <fx@gnu.org>
parents:
diff changeset
3953 used as the start of a label. It may be the empty string. The prefix
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3954 may contain the following @samp{%} escapes:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3955
Dave Love <fx@gnu.org>
parents:
diff changeset
3956 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
3957 %f Current file name, directory and extension stripped.
Dave Love <fx@gnu.org>
parents:
diff changeset
3958 %F Current file name relative to master file directory.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3959 %m Master file name, directory and extension stripped.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3960 %M Directory name (without path) where master file is located.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3961 %u User login name, on systems which support this.
Dave Love <fx@gnu.org>
parents:
diff changeset
3962 %S A section prefix derived with variable @code{reftex-section-prefixes}.
Dave Love <fx@gnu.org>
parents:
diff changeset
3963 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
3964
Dave Love <fx@gnu.org>
parents:
diff changeset
3965 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
3966 Example: In a file @file{intro.tex}, @samp{eq:%f:} will become
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3967 @samp{eq:intro:}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3968
Dave Love <fx@gnu.org>
parents:
diff changeset
3969 @item @var{reference-format}
Dave Love <fx@gnu.org>
parents:
diff changeset
3970 Format string for reference insert in buffer. @samp{%s} will be
Dave Love <fx@gnu.org>
parents:
diff changeset
3971 replaced by the label. When the format starts with @samp{~}, this
Dave Love <fx@gnu.org>
parents:
diff changeset
3972 @samp{~} will only be inserted when the character before point is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3973 @emph{not} a whitespace.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3974
Dave Love <fx@gnu.org>
parents:
diff changeset
3975 @item @var{context-method}
Dave Love <fx@gnu.org>
parents:
diff changeset
3976 Indication on how to find the short context.
Dave Love <fx@gnu.org>
parents:
diff changeset
3977 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
3978 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3979 If @code{nil}, use the text following the @samp{\label@{...@}} macro.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3980 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3981 If @code{t}, use
Dave Love <fx@gnu.org>
parents:
diff changeset
3982 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
3983 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3984 the section heading for section labels.
Dave Love <fx@gnu.org>
parents:
diff changeset
3985 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3986 text following the @samp{\begin@{...@}} statement of environments (not
Dave Love <fx@gnu.org>
parents:
diff changeset
3987 a good choice for environments like eqnarray or enumerate, where one has
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3988 several labels in a single environment).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3989 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3990 text after the macro name (starting with the first arg) for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3991 macros.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3992 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
3993 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3994 If an integer, use the nth argument of the macro. As a special case,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
3995 1000 means to get text after the last macro argument.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
3996 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
3997 If a string, use as regexp to search @emph{backward} from the label.
Dave Love <fx@gnu.org>
parents:
diff changeset
3998 Context is then the text following the end of the match. E.g. putting
Dave Love <fx@gnu.org>
parents:
diff changeset
3999 this to @samp{\\caption[[@{]} will use the caption in a figure or table
Dave Love <fx@gnu.org>
parents:
diff changeset
4000 environment. @samp{\\begin@{eqnarray@}\|\\\\} works for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4001 eqnarrays.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4002 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4003 If any of @code{caption}, @code{item}, @code{eqnarray-like},
Dave Love <fx@gnu.org>
parents:
diff changeset
4004 @code{alignat-like}, this symbol will internally be translated into an
Dave Love <fx@gnu.org>
parents:
diff changeset
4005 appropriate regexp (see also the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4006 @code{reftex-default-context-regexps}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4007 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4008 If a function, call this function with the name of the environment/macro
Dave Love <fx@gnu.org>
parents:
diff changeset
4009 as argument. On call, point will be just after the @code{\label} macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
4010 The function is expected to return a suitable context string. It should
Dave Love <fx@gnu.org>
parents:
diff changeset
4011 throw an exception (error) when failing to find context. As an example,
Dave Love <fx@gnu.org>
parents:
diff changeset
4012 here is a function returning the 10 chars following the label macro as
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4013 context:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4014
Dave Love <fx@gnu.org>
parents:
diff changeset
4015 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4016 (defun my-context-function (env-or-mac)
Dave Love <fx@gnu.org>
parents:
diff changeset
4017 (if (> (point-max) (+ 10 (point)))
Dave Love <fx@gnu.org>
parents:
diff changeset
4018 (buffer-substring (point) (+ 10 (point)))
Dave Love <fx@gnu.org>
parents:
diff changeset
4019 (error "Buffer too small")))
Dave Love <fx@gnu.org>
parents:
diff changeset
4020 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4021 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
4022
Dave Love <fx@gnu.org>
parents:
diff changeset
4023 Label context is used in two ways by @b{Ref@TeX{}}: For display in the label
Dave Love <fx@gnu.org>
parents:
diff changeset
4024 menu, and to derive a label string. If you want to use a different
Dave Love <fx@gnu.org>
parents:
diff changeset
4025 method for each of these, specify them as a dotted pair.
Dave Love <fx@gnu.org>
parents:
diff changeset
4026 E.g. @code{(nil . t)} uses the text after the label (@code{nil}) for
Dave Love <fx@gnu.org>
parents:
diff changeset
4027 display, and text from the default position (@code{t}) to derive a label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4028 string. This is actually used for section labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4029
Dave Love <fx@gnu.org>
parents:
diff changeset
4030 @item @var{magic-word-list}
Dave Love <fx@gnu.org>
parents:
diff changeset
4031 List of magic words which identify a reference to be of this type. If
Dave Love <fx@gnu.org>
parents:
diff changeset
4032 the word before point is equal to one of these words when calling
Dave Love <fx@gnu.org>
parents:
diff changeset
4033 @code{reftex-reference}, the label list offered will be automatically
Dave Love <fx@gnu.org>
parents:
diff changeset
4034 restricted to labels of the correct type. If the first element of this
Dave Love <fx@gnu.org>
parents:
diff changeset
4035 word--list is the symbol `regexp', the strings are interpreted as regular
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4036 expressions.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4037
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4038 @item @var{toc-level}
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4039 The integer level at which this environment should be added to the table
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4040 of contents. See also @code{reftex-section-levels}. A positive value
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4041 will number the entries mixed with the sectioning commands of the same
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4042 level. A negative value will make unnumbered entries. Useful only for
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4043 theorem-like environments which structure the document. Will be ignored
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4044 for macros. When omitted or @code{nil}, no TOC entries will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4045 made.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4046 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4047
Dave Love <fx@gnu.org>
parents:
diff changeset
4048 If the type indicator characters of two or more entries are the same,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4049 @b{Ref@TeX{}} will use
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4050 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
4051 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4052 the first non-@code{nil} format and prefix
Dave Love <fx@gnu.org>
parents:
diff changeset
4053 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4054 the magic words of all involved entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
4055 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
4056
Dave Love <fx@gnu.org>
parents:
diff changeset
4057 Any list entry may also be a symbol. If that has an association in
Dave Love <fx@gnu.org>
parents:
diff changeset
4058 @code{reftex-label-alist-builtin}, the @code{cddr} of that association is
Dave Love <fx@gnu.org>
parents:
diff changeset
4059 spliced into the list. However, builtin defaults should normally be set
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4060 with the variable @code{reftex-default-label-alist-entries}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4061 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4062
Dave Love <fx@gnu.org>
parents:
diff changeset
4063 @defopt reftex-section-prefixes
Dave Love <fx@gnu.org>
parents:
diff changeset
4064 Prefixes for section labels. When the label prefix given in an entry in
Dave Love <fx@gnu.org>
parents:
diff changeset
4065 @code{reftex-label-alist} contains @samp{%S}, this list is used to
Dave Love <fx@gnu.org>
parents:
diff changeset
4066 determine the correct prefix string depending on the current section
Dave Love <fx@gnu.org>
parents:
diff changeset
4067 level. The list is an alist, with each entry of the form
Dave Love <fx@gnu.org>
parents:
diff changeset
4068 @w{@code{(@var{key} . @var{prefix})}}. Possible keys are sectioning macro
Dave Love <fx@gnu.org>
parents:
diff changeset
4069 names like @samp{chapter}, integer section levels (as given in
Dave Love <fx@gnu.org>
parents:
diff changeset
4070 @code{reftex-section-levels}), and @code{t} for the default.
Dave Love <fx@gnu.org>
parents:
diff changeset
4071 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4072
Dave Love <fx@gnu.org>
parents:
diff changeset
4073 @defopt reftex-default-context-regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
4074 Alist with default regular expressions for finding context. The emacs
Dave Love <fx@gnu.org>
parents:
diff changeset
4075 lisp form @w{@code{(format regexp (regexp-quote environment))}} is used
Dave Love <fx@gnu.org>
parents:
diff changeset
4076 to calculate the final regular expression - so @samp{%s} will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4077 replaced with the environment or macro.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4078 @end defopt
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4079
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4080 @defopt reftex-trust-label-prefix
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4081 Non-@code{nil} means, trust the label prefix when determining label type.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4082 It is customary to use special label prefixes to distinguish different label
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4083 types. The label prefixes have no syntactic meaning in LaTeX (unless
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4084 special packages like fancyref) are being used. RefTeX can and by
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4085 default does parse around each label to detect the correct label type,
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4086 but this process can be slow when a document contains thousands of
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4087 labels. If you use label prefixes consistently, you may speed up
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4088 document parsing by setting this variable to a non-nil value. RefTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4089 will then compare the label prefix with the prefixes found in
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4090 `reftex-label-alist' and derive the correct label type in this way.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4091 Possible values for this option are:
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4092
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4093 @example
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4094 t @r{This means to trust any label prefixes found.}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4095 regexp @r{If a regexp, only prefixes matched by the regexp are trusted.}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4096 list @r{List of accepted prefixes, as strings. The colon is part of}
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4097 @r{the prefix, e.g. ("fn:" "eqn:" "item:").}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4098 nil @r{Never trust a label prefix.}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4099 @end example
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4100 The only disadvantage of using this feature is that the label context
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4101 displayed in the label selection buffer along with each label is
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4102 simply some text after the label definition. This is no problem if you
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4103 place labels keeping this in mind (e.g. @i{before} the equation, @i{at
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4104 the beginning} of a fig/tab caption ...). Anyway, it is probably best
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4105 to use the regexp or the list value types to fine-tune this feature.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4106 For example, if your document contains thousands of footnotes with
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4107 labels fn:xxx, you may want to set this variable to the value "^fn:$" or
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4108 ("fn:"). Then RefTeX will still do extensive parsing for any
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4109 non-footnote labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4110 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4111
Dave Love <fx@gnu.org>
parents:
diff changeset
4112 @node Options (Creating Labels), Options (Referencing Labels), Options (Defining Label Environments), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4113 @section Creating Labels
Dave Love <fx@gnu.org>
parents:
diff changeset
4114 @cindex Options, creating labels
Dave Love <fx@gnu.org>
parents:
diff changeset
4115 @cindex Creating labels, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4116
Dave Love <fx@gnu.org>
parents:
diff changeset
4117 @defopt reftex-insert-label-flags
Dave Love <fx@gnu.org>
parents:
diff changeset
4118 Flags governing label insertion. The value has the form
Dave Love <fx@gnu.org>
parents:
diff changeset
4119
Dave Love <fx@gnu.org>
parents:
diff changeset
4120 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4121 (@var{derive} @var{prompt})
Dave Love <fx@gnu.org>
parents:
diff changeset
4122 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4123
Dave Love <fx@gnu.org>
parents:
diff changeset
4124 If @var{derive}is @code{t}, @b{Ref@TeX{}} will try to derive a sensible
Dave Love <fx@gnu.org>
parents:
diff changeset
4125 label from context. A section label for example will be derived from
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4126 the section heading. The conversion of the context to a valid label is
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4127 governed by the specifications given in
Dave Love <fx@gnu.org>
parents:
diff changeset
4128 @code{reftex-derive-label-parameters}. If @var{derive} is @code{nil},
Dave Love <fx@gnu.org>
parents:
diff changeset
4129 the default label will consist of the prefix and a unique number, like
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4130 @samp{eq:23}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4131
Dave Love <fx@gnu.org>
parents:
diff changeset
4132 If @var{prompt} is @code{t}, the user will be prompted for a label
Dave Love <fx@gnu.org>
parents:
diff changeset
4133 string. When @var{prompt} is @code{nil}, the default label will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4134 inserted without query.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4135
Dave Love <fx@gnu.org>
parents:
diff changeset
4136 So the combination of @var{derive} and @var{prompt} controls label
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4137 insertion. Here is a table describing all four possibilities:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4138
Dave Love <fx@gnu.org>
parents:
diff changeset
4139 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4140 @group
Dave Love <fx@gnu.org>
parents:
diff changeset
4141 @var{derive} @var{prompt} @var{action}
Dave Love <fx@gnu.org>
parents:
diff changeset
4142 -----------------------------------------------------------
Dave Love <fx@gnu.org>
parents:
diff changeset
4143 nil nil @r{Insert simple label, like @samp{eq:22} or @samp{sec:13}. No query.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4144 nil t @r{Prompt for label.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4145 t nil @r{Derive a label from context and insert. No query.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4146 t t @r{Derive a label from context, prompt for confirmation.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4147 @end group
Dave Love <fx@gnu.org>
parents:
diff changeset
4148 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4149
Dave Love <fx@gnu.org>
parents:
diff changeset
4150 Each flag may be set to @code{t}, @code{nil}, or a string of label type
Dave Love <fx@gnu.org>
parents:
diff changeset
4151 letters indicating the label types for which it should be true. Thus,
Dave Love <fx@gnu.org>
parents:
diff changeset
4152 the combination may be set differently for each label type. The default
Dave Love <fx@gnu.org>
parents:
diff changeset
4153 settings @samp{"s"} and @samp{"sft"} mean: Derive section labels from
Dave Love <fx@gnu.org>
parents:
diff changeset
4154 headings (with confirmation). Prompt for figure and table labels. Use
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4155 simple labels without confirmation for everything else.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4156
Dave Love <fx@gnu.org>
parents:
diff changeset
4157 The available label types are: @code{s} (section), @code{f} (figure),
Dave Love <fx@gnu.org>
parents:
diff changeset
4158 @code{t} (table), @code{i} (item), @code{e} (equation), @code{n}
Dave Love <fx@gnu.org>
parents:
diff changeset
4159 (footnote), @code{N} (endnote) plus any definitions in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4160 @code{reftex-label-alist}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4161 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4162
Dave Love <fx@gnu.org>
parents:
diff changeset
4163 @deffn Hook reftex-format-label-function
Dave Love <fx@gnu.org>
parents:
diff changeset
4164 If non-@code{nil}, should be a function which produces the string to
Dave Love <fx@gnu.org>
parents:
diff changeset
4165 insert as a label definition. The function will be called with two
Dave Love <fx@gnu.org>
parents:
diff changeset
4166 arguments, the @var{label} and the @var{default-format} (usually
Dave Love <fx@gnu.org>
parents:
diff changeset
4167 @samp{\label@{%s@}}). It should return the string to insert into the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4168 buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4169 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4170
Dave Love <fx@gnu.org>
parents:
diff changeset
4171 @deffn Hook reftex-string-to-label-function
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4172 Function to turn an arbitrary string into a valid label.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4173 @b{Ref@TeX{}}'s default function uses the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4174 @code{reftex-derive-label-parameters}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4175 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4176
Dave Love <fx@gnu.org>
parents:
diff changeset
4177 @deffn Hook reftex-translate-to-ascii-function
Dave Love <fx@gnu.org>
parents:
diff changeset
4178 Filter function which will process a context string before it is used to
Dave Love <fx@gnu.org>
parents:
diff changeset
4179 derive a label from it. The intended application is to convert ISO or
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4180 Mule characters into something valid in labels. The default function
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4181 @code{reftex-latin1-to-ascii} removes the accents from Latin-1
Dave Love <fx@gnu.org>
parents:
diff changeset
4182 characters. X-Symbol (>=2.6) sets this variable to the much more
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4183 general @code{x-symbol-translate-to-ascii}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4184 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4185
Dave Love <fx@gnu.org>
parents:
diff changeset
4186 @defopt reftex-derive-label-parameters
Dave Love <fx@gnu.org>
parents:
diff changeset
4187 Parameters for converting a string into a label. This variable is a
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4188 list of the following items:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4189 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
4190 @item @var{nwords}
Dave Love <fx@gnu.org>
parents:
diff changeset
4191 Number of words to use.
Dave Love <fx@gnu.org>
parents:
diff changeset
4192 @item @var{maxchar}
Dave Love <fx@gnu.org>
parents:
diff changeset
4193 Maximum number of characters in a label string.
60919
3ad3287d2e49 * calc.texi, reftex.texi: Replace `illegal' with `invalid'.
Werner LEMBERG <wl@gnu.org>
parents: 59731
diff changeset
4194 @item @var{invalid}
3ad3287d2e49 * calc.texi, reftex.texi: Replace `illegal' with `invalid'.
Werner LEMBERG <wl@gnu.org>
parents: 59731
diff changeset
4195 @code{nil}: Throw away any words containing characters invalid in labels.@*
3ad3287d2e49 * calc.texi, reftex.texi: Replace `illegal' with `invalid'.
Werner LEMBERG <wl@gnu.org>
parents: 59731
diff changeset
4196 @code{t}: Throw away only the invalid characters, not the whole word.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4197 @item @var{abbrev}
Dave Love <fx@gnu.org>
parents:
diff changeset
4198 @code{nil}: Never abbreviate words.@*
Dave Love <fx@gnu.org>
parents:
diff changeset
4199 @code{t}: Always abbreviate words (see @code{reftex-abbrev-parameters}).@*
Dave Love <fx@gnu.org>
parents:
diff changeset
4200 @code{1}: Abbreviate words if necessary to shorten label string.
Dave Love <fx@gnu.org>
parents:
diff changeset
4201 @item @var{separator}
Dave Love <fx@gnu.org>
parents:
diff changeset
4202 String separating different words in the label.
Dave Love <fx@gnu.org>
parents:
diff changeset
4203 @item @var{ignorewords}
Dave Love <fx@gnu.org>
parents:
diff changeset
4204 List of words which should not be part of labels.
Dave Love <fx@gnu.org>
parents:
diff changeset
4205 @item @var{downcase}
Dave Love <fx@gnu.org>
parents:
diff changeset
4206 @code{t}: Downcase words before putting them into the label.@*
Dave Love <fx@gnu.org>
parents:
diff changeset
4207 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4208 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4209
Dave Love <fx@gnu.org>
parents:
diff changeset
4210 @defopt reftex-label-illegal-re
60919
3ad3287d2e49 * calc.texi, reftex.texi: Replace `illegal' with `invalid'.
Werner LEMBERG <wl@gnu.org>
parents: 59731
diff changeset
4211 Regexp matching characters not valid in labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4212 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4213
Dave Love <fx@gnu.org>
parents:
diff changeset
4214 @defopt reftex-abbrev-parameters
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4215 Parameters for abbreviation of words. A list of four parameters.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4216 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
4217 @item @var{min-chars}
Dave Love <fx@gnu.org>
parents:
diff changeset
4218 Minimum number of characters remaining after abbreviation.
Dave Love <fx@gnu.org>
parents:
diff changeset
4219 @item @var{min-kill}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4220 Minimum number of characters to remove when abbreviating words.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4221 @item @var{before}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4222 Character class before abbrev point in word.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4223 @item @var{after}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4224 Character class after abbrev point in word.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4225 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4226 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4227
Dave Love <fx@gnu.org>
parents:
diff changeset
4228 @node Options (Referencing Labels), Options (Creating Citations), Options (Creating Labels), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4229 @section Referencing Labels
Dave Love <fx@gnu.org>
parents:
diff changeset
4230 @cindex Options, referencing labels
Dave Love <fx@gnu.org>
parents:
diff changeset
4231 @cindex Referencing labels, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4232
Dave Love <fx@gnu.org>
parents:
diff changeset
4233 @defopt reftex-label-menu-flags
Dave Love <fx@gnu.org>
parents:
diff changeset
4234 List of flags governing the label menu makeup. The flags are:
Dave Love <fx@gnu.org>
parents:
diff changeset
4235 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
4236 @item @var{table-of-contents}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4237 Show the labels embedded in a table of context.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4238 @item @var{section-numbers}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4239 Include section numbers (like 4.1.3) in table of contents.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4240 @item @var{counters}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4241 Show counters. This just numbers the labels in the menu.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4242 @item @var{no-context}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4243 Non-@code{nil} means do @emph{not} show the short context.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4244 @item @var{follow}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4245 Follow full context in other window.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4246 @item @var{show-commented}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4247 Show labels from regions which are commented out.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4248 @item @var{match-everywhere}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4249 Obsolete flag.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4250 @item @var{show-files}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4251 Show begin and end of included files.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4252 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4253
Dave Love <fx@gnu.org>
parents:
diff changeset
4254 Each of these flags can be set to @code{t} or @code{nil}, or to a string
Dave Love <fx@gnu.org>
parents:
diff changeset
4255 of type letters indicating the label types for which it should be true.
Dave Love <fx@gnu.org>
parents:
diff changeset
4256 These strings work like character classes in regular expressions. Thus,
Dave Love <fx@gnu.org>
parents:
diff changeset
4257 setting one of the flags to @samp{"sf"} makes the flag true for section
Dave Love <fx@gnu.org>
parents:
diff changeset
4258 and figure labels, @code{nil} for everything else. Setting it to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4259 @samp{"^sf"} makes it the other way round.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4260
Dave Love <fx@gnu.org>
parents:
diff changeset
4261 The available label types are: @code{s} (section), @code{f} (figure),
Dave Love <fx@gnu.org>
parents:
diff changeset
4262 @code{t} (table), @code{i} (item), @code{e} (equation), @code{n}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4263 (footnote), plus any definitions in @code{reftex-label-alist}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4264
Dave Love <fx@gnu.org>
parents:
diff changeset
4265 Most options can also be switched from the label menu itself - so if you
Dave Love <fx@gnu.org>
parents:
diff changeset
4266 decide here to not have a table of contents in the label menu, you can
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4267 still get one interactively during selection from the label menu.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4268 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4269
Dave Love <fx@gnu.org>
parents:
diff changeset
4270 @defopt reftex-multiref-punctuation
Dave Love <fx@gnu.org>
parents:
diff changeset
4271 Punctuation strings for multiple references. When marking is used in
Dave Love <fx@gnu.org>
parents:
diff changeset
4272 the selection buffer to select several references, this variable
Dave Love <fx@gnu.org>
parents:
diff changeset
4273 associates the 3 marking characters @samp{,-+} with prefix strings to be
Dave Love <fx@gnu.org>
parents:
diff changeset
4274 inserted into the buffer before the corresponding @code{\ref} macro.
Dave Love <fx@gnu.org>
parents:
diff changeset
4275 This is used to string together whole reference sets, like
Dave Love <fx@gnu.org>
parents:
diff changeset
4276 @samp{eqs. 1,2,3-5,6 and 7} in a single call to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4277 @code{reftex-reference}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4278 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4279
Dave Love <fx@gnu.org>
parents:
diff changeset
4280 @defopt reftex-vref-is-default
Dave Love <fx@gnu.org>
parents:
diff changeset
4281 Non-@code{nil} means, the varioref macro @code{\vref} is used as
Dave Love <fx@gnu.org>
parents:
diff changeset
4282 default. In the selection buffer, the @kbd{v} key toggles the reference
Dave Love <fx@gnu.org>
parents:
diff changeset
4283 macro between @code{\ref} and @code{\vref}. The value of this variable
Dave Love <fx@gnu.org>
parents:
diff changeset
4284 determines the default which is active when entering the selection
Dave Love <fx@gnu.org>
parents:
diff changeset
4285 process. Instead of @code{nil} or @code{t}, this may also be a string
Dave Love <fx@gnu.org>
parents:
diff changeset
4286 of type letters indicating the label types for which it should be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4287 true.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4288 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4289
Dave Love <fx@gnu.org>
parents:
diff changeset
4290 @defopt reftex-fref-is-default
Dave Love <fx@gnu.org>
parents:
diff changeset
4291 Non-@code{nil} means, the fancyref macro @code{\fref} is used as
Dave Love <fx@gnu.org>
parents:
diff changeset
4292 default. In the selection buffer, the @kbd{V} key toggles the reference
Dave Love <fx@gnu.org>
parents:
diff changeset
4293 macro between @code{\ref}, @code{\fref} and @code{\Fref}. The value of
Dave Love <fx@gnu.org>
parents:
diff changeset
4294 this variable determines the default which is active when entering the
Dave Love <fx@gnu.org>
parents:
diff changeset
4295 selection process. Instead of @code{nil} or @code{t}, this may also be
Dave Love <fx@gnu.org>
parents:
diff changeset
4296 a string of type letters indicating the label types for which it should
Dave Love <fx@gnu.org>
parents:
diff changeset
4297 be true.
Dave Love <fx@gnu.org>
parents:
diff changeset
4298 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4299
Dave Love <fx@gnu.org>
parents:
diff changeset
4300 @deffn Hook reftex-format-ref-function
Dave Love <fx@gnu.org>
parents:
diff changeset
4301 If non-@code{nil}, should be a function which produces the string to
Dave Love <fx@gnu.org>
parents:
diff changeset
4302 insert as a reference. Note that the insertion format can also be
Dave Love <fx@gnu.org>
parents:
diff changeset
4303 changed with @code{reftex-label-alist}. This hook also is used by the
Dave Love <fx@gnu.org>
parents:
diff changeset
4304 special commands to insert @code{\vref} and @code{\fref} references, so
Dave Love <fx@gnu.org>
parents:
diff changeset
4305 even if you set this, your setting will be ignored by the special
Dave Love <fx@gnu.org>
parents:
diff changeset
4306 commands. The function will be called with two arguments, the
Dave Love <fx@gnu.org>
parents:
diff changeset
4307 @var{label} and the @var{default-format} (usually @samp{~\ref@{%s@}}).
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4308 It should return the string to insert into the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4309 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4310
Dave Love <fx@gnu.org>
parents:
diff changeset
4311 @defopt reftex-level-indent
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4312 Number of spaces to be used for indentation per section level.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4313 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4314
Dave Love <fx@gnu.org>
parents:
diff changeset
4315 @defopt reftex-guess-label-type
Dave Love <fx@gnu.org>
parents:
diff changeset
4316 Non-@code{nil} means, @code{reftex-reference} will try to guess the
Dave Love <fx@gnu.org>
parents:
diff changeset
4317 label type. To do that, @b{Ref@TeX{}} will look at the word before the
Dave Love <fx@gnu.org>
parents:
diff changeset
4318 cursor and compare it with the magic words given in
Dave Love <fx@gnu.org>
parents:
diff changeset
4319 @code{reftex-label-alist}. When it finds a match, @b{Ref@TeX{}} will
Dave Love <fx@gnu.org>
parents:
diff changeset
4320 immediately offer the correct label menu - otherwise it will prompt you
Dave Love <fx@gnu.org>
parents:
diff changeset
4321 for a label type. If you set this variable to @code{nil}, @b{Ref@TeX{}}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4322 will always prompt for a label type.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4323 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4324
Dave Love <fx@gnu.org>
parents:
diff changeset
4325 @deffn {Normal Hook} reftex-display-copied-context-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
4326 Normal Hook which is run before context is displayed anywhere. Designed
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4327 for @w{@code{X-Symbol}}, but may have other uses as well.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4328 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4329
Dave Love <fx@gnu.org>
parents:
diff changeset
4330 @deffn Hook reftex-pre-refontification-functions
Dave Love <fx@gnu.org>
parents:
diff changeset
4331 @code{X-Symbol} specific hook. Probably not useful for other purposes.
Dave Love <fx@gnu.org>
parents:
diff changeset
4332 The functions get two arguments, the buffer from where the command
Dave Love <fx@gnu.org>
parents:
diff changeset
4333 started and a symbol indicating in what context the hook is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4334 called.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4335 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4336
Dave Love <fx@gnu.org>
parents:
diff changeset
4337 @deffn {Normal Hook} reftex-select-label-mode-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
4338 Normal hook which is run when a selection buffer enters
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4339 @code{reftex-select-label-mode}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4340 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4341
Dave Love <fx@gnu.org>
parents:
diff changeset
4342 @deffn Keymap reftex-select-label-map
Dave Love <fx@gnu.org>
parents:
diff changeset
4343 The keymap which is active in the labels selection process
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4344 (@pxref{Referencing Labels}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4345 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4346
Dave Love <fx@gnu.org>
parents:
diff changeset
4347 @node Options (Creating Citations), Options (Index Support), Options (Referencing Labels), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4348 @section Creating Citations
Dave Love <fx@gnu.org>
parents:
diff changeset
4349 @cindex Options, creating citations
Dave Love <fx@gnu.org>
parents:
diff changeset
4350 @cindex Creating citations, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4351
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4352 @defopt reftex-bibliography-commands
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4353 LaTeX commands which specify the BibTeX databases to use with the document.
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4354 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4355
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4356 @defopt reftex-bibfile-ignore-regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
4357 List of regular expressions to exclude files in
Dave Love <fx@gnu.org>
parents:
diff changeset
4358 @code{\\bibliography@{..@}}. File names matched by any of these regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
4359 will not be parsed. Intended for files which contain only
Dave Love <fx@gnu.org>
parents:
diff changeset
4360 @code{@@string} macro definitions and the like, which are ignored by
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4361 @b{Ref@TeX{}} anyway.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4362 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4363
Dave Love <fx@gnu.org>
parents:
diff changeset
4364 @defopt reftex-default-bibliography
Dave Love <fx@gnu.org>
parents:
diff changeset
4365 List of BibTeX database files which should be used if none are specified.
Dave Love <fx@gnu.org>
parents:
diff changeset
4366 When @code{reftex-citation} is called from a document with neither
Dave Love <fx@gnu.org>
parents:
diff changeset
4367 a @samp{\bibliography@{...@}} statement nor a @code{thebibliography}
Dave Love <fx@gnu.org>
parents:
diff changeset
4368 environment, @b{Ref@TeX{}} will scan these files instead. Intended for
Dave Love <fx@gnu.org>
parents:
diff changeset
4369 using @code{reftex-citation} in non-LaTeX files. The files will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4370 searched along the BIBINPUTS or TEXBIB path.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4371 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4372
Dave Love <fx@gnu.org>
parents:
diff changeset
4373 @defopt reftex-sort-bibtex-matches
Dave Love <fx@gnu.org>
parents:
diff changeset
4374 Sorting of the entries found in BibTeX databases by reftex-citation.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4375 Possible values:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4376 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4377 nil @r{Do not sort entries.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4378 author @r{Sort entries by author name.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4379 year @r{Sort entries by increasing year.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4380 reverse-year @r{Sort entries by decreasing year.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4381 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4382 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4383
Dave Love <fx@gnu.org>
parents:
diff changeset
4384 @defopt reftex-cite-format
Dave Love <fx@gnu.org>
parents:
diff changeset
4385 The format of citations to be inserted into the buffer. It can be a
Dave Love <fx@gnu.org>
parents:
diff changeset
4386 string, an alist or a symbol. In the simplest case this is just the string
Dave Love <fx@gnu.org>
parents:
diff changeset
4387 @samp{\cite@{%l@}}, which is also the default. See the definition of
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4388 @code{reftex-cite-format-builtin} for more complex examples.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4389
Dave Love <fx@gnu.org>
parents:
diff changeset
4390 If @code{reftex-cite-format} is a string, it will be used as the format.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4391 In the format, the following percent escapes will be expanded.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4392
Dave Love <fx@gnu.org>
parents:
diff changeset
4393 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
4394 @item %l
Dave Love <fx@gnu.org>
parents:
diff changeset
4395 The BibTeX label of the citation.
Dave Love <fx@gnu.org>
parents:
diff changeset
4396 @item %a
Dave Love <fx@gnu.org>
parents:
diff changeset
4397 List of author names, see also @code{reftex-cite-punctuation}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4398 @item %2a
Dave Love <fx@gnu.org>
parents:
diff changeset
4399 Like %a, but abbreviate more than 2 authors like Jones et al.
Dave Love <fx@gnu.org>
parents:
diff changeset
4400 @item %A
Dave Love <fx@gnu.org>
parents:
diff changeset
4401 First author name only.
Dave Love <fx@gnu.org>
parents:
diff changeset
4402 @item %e
Dave Love <fx@gnu.org>
parents:
diff changeset
4403 Works like @samp{%a}, but on list of editor names. (@samp{%2e} and
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4404 @samp{%E} work a well).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4405 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4406
Dave Love <fx@gnu.org>
parents:
diff changeset
4407 It is also possible to access all other BibTeX database fields:
Dave Love <fx@gnu.org>
parents:
diff changeset
4408
Dave Love <fx@gnu.org>
parents:
diff changeset
4409 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4410 %b booktitle %c chapter %d edition %h howpublished
Dave Love <fx@gnu.org>
parents:
diff changeset
4411 %i institution %j journal %k key %m month
Dave Love <fx@gnu.org>
parents:
diff changeset
4412 %n number %o organization %p pages %P first page
Dave Love <fx@gnu.org>
parents:
diff changeset
4413 %r address %s school %u publisher %t title
Dave Love <fx@gnu.org>
parents:
diff changeset
4414 %v volume %y year
Dave Love <fx@gnu.org>
parents:
diff changeset
4415 %B booktitle, abbreviated %T title, abbreviated
Dave Love <fx@gnu.org>
parents:
diff changeset
4416 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4417
Dave Love <fx@gnu.org>
parents:
diff changeset
4418 @noindent
Dave Love <fx@gnu.org>
parents:
diff changeset
4419 Usually, only @samp{%l} is needed. The other stuff is mainly for the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4420 echo area display, and for @code{(setq reftex-comment-citations t)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4421
Dave Love <fx@gnu.org>
parents:
diff changeset
4422 @samp{%<} as a special operator kills punctuation and space around it
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4423 after the string has been formatted.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4424
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4425 A pair of square brackets indicates an optional argument, and RefTeX
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4426 will prompt for the values of these arguments.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4427
Dave Love <fx@gnu.org>
parents:
diff changeset
4428 Beware that all this only works with BibTeX database files. When
Dave Love <fx@gnu.org>
parents:
diff changeset
4429 citations are made from the @code{\bibitems} in an explicit
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4430 @code{thebibliography} environment, only @samp{%l} is available.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4431
Dave Love <fx@gnu.org>
parents:
diff changeset
4432 If @code{reftex-cite-format} is an alist of characters and strings, the
Dave Love <fx@gnu.org>
parents:
diff changeset
4433 user will be prompted for a character to select one of the possible
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4434 format strings.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4435
Dave Love <fx@gnu.org>
parents:
diff changeset
4436 In order to configure this variable, you can either set
Dave Love <fx@gnu.org>
parents:
diff changeset
4437 @code{reftex-cite-format} directly yourself or set it to the
Dave Love <fx@gnu.org>
parents:
diff changeset
4438 @emph{symbol} of one of the predefined styles. The predefined symbols
Dave Love <fx@gnu.org>
parents:
diff changeset
4439 are those which have an association in the constant
Dave Love <fx@gnu.org>
parents:
diff changeset
4440 @code{reftex-cite-format-builtin}) E.g.: @code{(setq reftex-cite-format
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4441 'natbib)}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4442 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4443
Dave Love <fx@gnu.org>
parents:
diff changeset
4444 @deffn Hook reftex-format-cite-function
Dave Love <fx@gnu.org>
parents:
diff changeset
4445 If non-@code{nil}, should be a function which produces the string to
Dave Love <fx@gnu.org>
parents:
diff changeset
4446 insert as a citation. Note that the citation format can also be changed
Dave Love <fx@gnu.org>
parents:
diff changeset
4447 with the variable @code{reftex-cite-format}. The function will be
Dave Love <fx@gnu.org>
parents:
diff changeset
4448 called with two arguments, the @var{citation-key} and the
Dave Love <fx@gnu.org>
parents:
diff changeset
4449 @var{default-format} (taken from @code{reftex-cite-format}). It should
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4450 return the string to insert into the buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4451 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4452
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4453 @defopt reftex-cite-prompt-optional-args
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4454 Non-@code{nil} means, prompt for empty optional arguments in cite macros.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4455 When an entry in @code{reftex-cite-format} ist given with square brackets to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4456 indicate optional arguments (for example @samp{\\cite[][]@{%l@}}), RefTeX can
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4457 prompt for values. Possible values are:
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4458 @example
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4459 nil @r{Never prompt for optional arguments}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4460 t @r{Always prompt}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4461 maybe @r{Prompt only if @code{reftex-citation} was called with C-u prefix arg}@end example
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4462 Unnecessary empty optional arguments are removed before insertion into
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4463 the buffer. See @code{reftex-cite-cleanup-optional-args}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4464 @end defopt
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4465
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4466 @defopt reftex-cite-cleanup-optional-args
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4467 Non-@code{nil} means, remove empty optional arguments from cite macros
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4468 if possible.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4469 @end defopt
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4470
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4471 @defopt reftex-comment-citations
Dave Love <fx@gnu.org>
parents:
diff changeset
4472 Non-@code{nil} means add a comment for each citation describing the full
Dave Love <fx@gnu.org>
parents:
diff changeset
4473 entry. The comment is formatted according to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4474 @code{reftex-cite-comment-format}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4475 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4476
Dave Love <fx@gnu.org>
parents:
diff changeset
4477 @defopt reftex-cite-comment-format
Dave Love <fx@gnu.org>
parents:
diff changeset
4478 Citation format used for commented citations. Must @emph{not} contain
Dave Love <fx@gnu.org>
parents:
diff changeset
4479 @samp{%l}. See the variable @code{reftex-cite-format} for possible
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4480 percent escapes.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4481 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4482
Dave Love <fx@gnu.org>
parents:
diff changeset
4483 @defopt reftex-cite-punctuation
Dave Love <fx@gnu.org>
parents:
diff changeset
4484 Punctuation for formatting of name lists in citations. This is a list
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4485 of 3 strings.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4486 @enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
4487 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4488 normal names separator, like @samp{, } in Jones, Brown and Miller
Dave Love <fx@gnu.org>
parents:
diff changeset
4489 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4490 final names separator, like @samp{ and } in Jones, Brown and Miller
Dave Love <fx@gnu.org>
parents:
diff changeset
4491 @item
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4492 The @samp{et al.} string, like @samp{ @{\it et al.@}} in
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4493 Jones @{\it et al.@}
Dave Love <fx@gnu.org>
parents:
diff changeset
4494 @end enumerate
Dave Love <fx@gnu.org>
parents:
diff changeset
4495 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4496
Dave Love <fx@gnu.org>
parents:
diff changeset
4497 @deffn {Normal Hook} reftex-select-bib-mode-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
4498 Normal hook which is run when a selection buffer enters
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4499 @code{reftex-select-bib-mode}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4500 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4501
Dave Love <fx@gnu.org>
parents:
diff changeset
4502 @deffn Keymap reftex-select-bib-map
Dave Love <fx@gnu.org>
parents:
diff changeset
4503 The keymap which is active in the citation-key selection process
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4504 (@pxref{Creating Citations}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4505 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4506
Dave Love <fx@gnu.org>
parents:
diff changeset
4507 @node Options (Index Support), Options (Viewing Cross-References), Options (Creating Citations), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4508 @section Index Support
Dave Love <fx@gnu.org>
parents:
diff changeset
4509 @cindex Options, Index support
Dave Love <fx@gnu.org>
parents:
diff changeset
4510 @cindex Index support, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4511
Dave Love <fx@gnu.org>
parents:
diff changeset
4512 @defopt reftex-support-index
Dave Love <fx@gnu.org>
parents:
diff changeset
4513 Non-@code{nil} means, index entries are parsed as well. Index support
Dave Love <fx@gnu.org>
parents:
diff changeset
4514 is resource intensive and the internal structure holding the parsed
Dave Love <fx@gnu.org>
parents:
diff changeset
4515 information can become quite big. Therefore it can be turned off. When
Dave Love <fx@gnu.org>
parents:
diff changeset
4516 this is @code{nil} and you execute a command which requires index
Dave Love <fx@gnu.org>
parents:
diff changeset
4517 support, you will be asked for confirmation to turn it on and rescan the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4518 document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4519 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4520
Dave Love <fx@gnu.org>
parents:
diff changeset
4521 @defopt reftex-index-special-chars
Dave Love <fx@gnu.org>
parents:
diff changeset
4522 List of special characters in index entries, given as strings. These
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4523 correspond to the @code{MakeIndex} keywords
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4524 @code{(@var{level} @var{encap} @var{actual} @var{quote} @var{escape})}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4525 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4526
Dave Love <fx@gnu.org>
parents:
diff changeset
4527 @defopt reftex-index-macros
Dave Love <fx@gnu.org>
parents:
diff changeset
4528 List of macros which define index entries. The structure of each entry
Dave Love <fx@gnu.org>
parents:
diff changeset
4529 is
Dave Love <fx@gnu.org>
parents:
diff changeset
4530 @lisp
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4531 (@var{macro} @var{index-tag} @var{key} @var{prefix} @var{exclude} @var{repeat})
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4532 @end lisp
Dave Love <fx@gnu.org>
parents:
diff changeset
4533
Dave Love <fx@gnu.org>
parents:
diff changeset
4534 @var{macro} is the macro. Arguments should be denoted by empty braces,
Dave Love <fx@gnu.org>
parents:
diff changeset
4535 as for example in @samp{\index[]@{*@}}. Use square brackets to denote
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4536 optional arguments. The star marks where the index key is.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4537
Dave Love <fx@gnu.org>
parents:
diff changeset
4538 @var{index-tag} is a short name of the index. @samp{idx} and @samp{glo}
Dave Love <fx@gnu.org>
parents:
diff changeset
4539 are reserved for the default index and the glossary. Other indices can
Dave Love <fx@gnu.org>
parents:
diff changeset
4540 be defined as well. If this is an integer, the Nth argument of the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4541 macro holds the index tag.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4542
Dave Love <fx@gnu.org>
parents:
diff changeset
4543 @var{key} is a character which is used to identify the macro for input
Dave Love <fx@gnu.org>
parents:
diff changeset
4544 with @code{reftex-index}. @samp{?i}, @samp{?I}, and @samp{?g} are
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4545 reserved for default index and glossary.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4546
Dave Love <fx@gnu.org>
parents:
diff changeset
4547 @var{prefix} can be a prefix which is added to the @var{key} part of the
Dave Love <fx@gnu.org>
parents:
diff changeset
4548 index entry. If you have a macro
Dave Love <fx@gnu.org>
parents:
diff changeset
4549 @code{\newcommand@{\molec@}[1]@{#1\index@{Molecules!#1@}}, this prefix
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4550 should be @samp{Molecules!}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4551
Dave Love <fx@gnu.org>
parents:
diff changeset
4552 @var{exclude} can be a function. If this function exists and returns a
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4553 non-@code{nil} value, the index entry at point is ignored. This was
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4554 implemented to support the (deprecated) @samp{^} and @samp{_} shortcuts
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4555 in the LaTeX2e @code{index} package.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4556
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4557 @var{repeat}, if non-@code{nil}, means the index macro does not typeset
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4558 the entry in the text, so that the text has to be repeated outside the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4559 index macro. Needed for @code{reftex-index-selection-or-word} and for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4560 indexing from the phrase buffer.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4561
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4562 The final entry may also be a symbol. It must have an association in
Dave Love <fx@gnu.org>
parents:
diff changeset
4563 the variable @code{reftex-index-macros-builtin} to specify the main
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4564 indexing package you are using. Valid values are currently
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4565 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4566 default @r{The LaTeX default - unnecessary to specify this one}
Dave Love <fx@gnu.org>
parents:
diff changeset
4567 multind @r{The multind.sty package}
Dave Love <fx@gnu.org>
parents:
diff changeset
4568 index @r{The index.sty package}
Dave Love <fx@gnu.org>
parents:
diff changeset
4569 index-shortcut @r{The index.sty packages with the ^ and _ shortcuts.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4570 @r{Should not be used - only for old documents}
Dave Love <fx@gnu.org>
parents:
diff changeset
4571 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4572 Note that AUCTeX sets these things internally for @b{Ref@TeX{}} as well,
Dave Love <fx@gnu.org>
parents:
diff changeset
4573 so with a sufficiently new version of AUCTeX, you should not set the
Dave Love <fx@gnu.org>
parents:
diff changeset
4574 package here.
Dave Love <fx@gnu.org>
parents:
diff changeset
4575 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4576
Dave Love <fx@gnu.org>
parents:
diff changeset
4577 @defopt reftex-index-default-macro
Dave Love <fx@gnu.org>
parents:
diff changeset
4578 The default index macro for @code{reftex-index-selection-or-word}.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4579 This is a list with @code{(@var{macro-key} @var{default-tag})}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4580
Dave Love <fx@gnu.org>
parents:
diff changeset
4581 @var{macro-key} is a character identifying an index macro - see
Dave Love <fx@gnu.org>
parents:
diff changeset
4582 @code{reftex-index-macros}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4583
Dave Love <fx@gnu.org>
parents:
diff changeset
4584 @var{default-tag} is the tag to be used if the macro requires a
Dave Love <fx@gnu.org>
parents:
diff changeset
4585 @var{tag} argument. When this is @code{nil} and a @var{tag} is needed,
Dave Love <fx@gnu.org>
parents:
diff changeset
4586 @b{Ref@TeX{}} will ask for it. When this is the empty string and the
Dave Love <fx@gnu.org>
parents:
diff changeset
4587 TAG argument of the index macro is optional, the TAG argument will be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4588 omitted.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4589 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4590
Dave Love <fx@gnu.org>
parents:
diff changeset
4591 @defopt reftex-index-default-tag
Dave Love <fx@gnu.org>
parents:
diff changeset
4592 Default index tag. When working with multiple indexes, RefTeX queries
Dave Love <fx@gnu.org>
parents:
diff changeset
4593 for an index tag when creating index entries or displaying a specific
Dave Love <fx@gnu.org>
parents:
diff changeset
4594 index. This variable controls the default offered for these queries.
Dave Love <fx@gnu.org>
parents:
diff changeset
4595 The default can be selected with @key{RET} during selection or
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4596 completion. Valid values of this variable are:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4597 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4598 nil @r{Do not provide a default index}
Dave Love <fx@gnu.org>
parents:
diff changeset
4599 "tag" @r{The default index tag given as a string, e.g. "idx"}
Dave Love <fx@gnu.org>
parents:
diff changeset
4600 last @r{The last used index tag will be offered as default}
Dave Love <fx@gnu.org>
parents:
diff changeset
4601 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4602 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4603
Dave Love <fx@gnu.org>
parents:
diff changeset
4604 @defopt reftex-index-math-format
Dave Love <fx@gnu.org>
parents:
diff changeset
4605 Format of index entries when copied from inside math mode. When
Dave Love <fx@gnu.org>
parents:
diff changeset
4606 @code{reftex-index-selection-or-word} is executed inside TeX math mode,
Dave Love <fx@gnu.org>
parents:
diff changeset
4607 the index key copied from the buffer is processed with this format
Dave Love <fx@gnu.org>
parents:
diff changeset
4608 string through the @code{format} function. This can be used to add the
Dave Love <fx@gnu.org>
parents:
diff changeset
4609 math delimiters (e.g. @samp{$}) to the string. Requires the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4610 @file{texmathp.el} library which is part of AUCTeX.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4611 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4612
27195
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4613 @defopt reftex-index-phrase-file-extension
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4614 File extension for the index phrase file. This extension will be added
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4615 to the base name of the master file.
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4616 @end defopt
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4617
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4618 @defopt reftex-index-phrases-logical-and-regexp
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4619 Regexp matching the @samp{and} operator for index arguments in phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4620 file. When several index arguments in a phrase line are separated by
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4621 this operator, each part will generate an index macro. So each match of
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4622 the search phrase will produce @emph{several} different index entries.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4623 Make sure this does no match things which are not separators. This
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4624 logical @samp{and} has higher priority than the logical @samp{or}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4625 specified in @code{reftex-index-phrases-logical-or-regexp}.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4626 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4627
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4628 @defopt reftex-index-phrases-logical-or-regexp
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4629 Regexp matching the @samp{or} operator for index arguments in phrases
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4630 file. When several index arguments in a phrase line are separated by
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4631 this operator, the user will be asked to select one of them at each
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4632 match of the search phrase. The first index arg will be the default. A
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4633 number key @kbd{1}--@kbd{9} must be pressed to switch to another. Make
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4634 sure this does no match things which are not separators. The logical
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4635 @samp{and} specified in @code{reftex-index-phrases-logical-or-regexp}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4636 has higher priority than this logical @samp{or}.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4637 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4638
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4639 @defopt reftex-index-phrases-search-whole-words
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4640 Non-@code{nil} means phrases search will look for whole words, not subwords.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4641 This works by requiring word boundaries at the beginning and end of
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4642 the search string. When the search phrase already has a non-word-char
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4643 at one of these points, no word boundary is required there.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4644 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4645
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4646 @defopt reftex-index-phrases-case-fold-search
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4647 Non-@code{nil} means, searching for index phrases will ignore
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4648 case.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4649 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4650
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4651 @defopt reftex-index-verify-function
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4652 A function which is called at each match during global indexing.
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4653 If the function returns nil, the current match is skipped.
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4654 @end defopt
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4655
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4656 @defopt reftex-index-phrases-skip-indexed-matches
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4657 Non-@code{nil} means, skip matches which appear to be indexed already.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4658 When doing global indexing from the phrases buffer, searches for some
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4659 phrases may match at places where that phrase was already indexed. In
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4660 particular when indexing an already processed document again, this
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4661 will even be the norm. When this variable is non-@code{nil},
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4662 @b{Ref@TeX{}} checks if the match is an index macro argument, or if an
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4663 index macro is directly before or after the phrase. If that is the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4664 case, that match will be ignored.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4665 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4666
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4667 @defopt reftex-index-phrases-wrap-long-lines
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4668 Non-@code{nil} means, when indexing from the phrases buffer, wrap lines.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4669 Inserting indexing commands in a line makes the line longer - often
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4670 so long that it does not fit onto the screen. When this variable is
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4671 non-@code{nil}, newlines will be added as necessary before and/or after the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4672 indexing command to keep lines short. However, the matched text
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4673 phrase and its index command will always end up on a single line.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4674 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4675
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4676 @defopt reftex-index-phrases-sort-prefers-entry
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4677 Non-@code{nil} means when sorting phrase lines, the explicit index entry
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4678 is used. Phrase lines in the phrases buffer contain a search phrase, and
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4679 sorting is normally based on these. Some phrase lines also have
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4680 an explicit index argument specified. When this variable is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4681 non-@code{nil}, the index argument will be used for sorting.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4682 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4683
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4684 @defopt reftex-index-phrases-sort-in-blocks
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4685 Non-@code{nil} means, empty and comment lines separate phrase buffer
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4686 into blocks. Sorting will then preserve blocks, so that lines are
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4687 re-arranged only within blocks.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4688 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4689
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4690 @defopt reftex-index-phrases-map
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4691 Keymap for the Index Phrases buffer.
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4692 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4693
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4694 @defopt reftex-index-phrases-mode-hook
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4695 Normal hook which is run when a buffer is put into
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4696 @code{reftex-index-phrases-mode}.
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4697 @end defopt
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4698
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4699 @defopt reftex-index-section-letters
Dave Love <fx@gnu.org>
parents:
diff changeset
4700 The letters which denote sections in the index. Usually these are all
Dave Love <fx@gnu.org>
parents:
diff changeset
4701 capital letters. Don't use any downcase letters. Order is not
Dave Love <fx@gnu.org>
parents:
diff changeset
4702 significant, the index will be sorted by whatever the sort function
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4703 thinks is correct. In addition to these letters, @b{Ref@TeX{}} will
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4704 create a group @samp{!} which contains all entries sorted below the
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
4705 lowest specified letter. In the @file{*Index*} buffer, pressing any of
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4706 these capital letters or @kbd{!} will jump to that section.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4707 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4708
Dave Love <fx@gnu.org>
parents:
diff changeset
4709 @defopt reftex-index-include-context
Dave Love <fx@gnu.org>
parents:
diff changeset
4710 Non-@code{nil} means, display the index definition context in the
Dave Love <fx@gnu.org>
parents:
diff changeset
4711 @file{*Index*} buffer. This flag may also be toggled from the
Dave Love <fx@gnu.org>
parents:
diff changeset
4712 @file{*Index*} buffer with the @kbd{c} key.
Dave Love <fx@gnu.org>
parents:
diff changeset
4713 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4714
Dave Love <fx@gnu.org>
parents:
diff changeset
4715 @defopt reftex-index-follow-mode
Dave Love <fx@gnu.org>
parents:
diff changeset
4716 Non-@code{nil} means, point in @file{*Index*} buffer will cause other
Dave Love <fx@gnu.org>
parents:
diff changeset
4717 window to follow. The other window will show the corresponding part of
Dave Love <fx@gnu.org>
parents:
diff changeset
4718 the document. This flag can be toggled from within the @file{*Index*}
Dave Love <fx@gnu.org>
parents:
diff changeset
4719 buffer with the @kbd{f} key.
Dave Love <fx@gnu.org>
parents:
diff changeset
4720 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4721
Dave Love <fx@gnu.org>
parents:
diff changeset
4722 @deffn Keymap reftex-index-map
Dave Love <fx@gnu.org>
parents:
diff changeset
4723 The keymap which is active in the @file{*Index*} buffer
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4724 (@pxref{Index Support}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4725 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
4726
Dave Love <fx@gnu.org>
parents:
diff changeset
4727 @node Options (Viewing Cross-References), Options (Finding Files), Options (Index Support), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4728 @section Viewing Cross-References
Dave Love <fx@gnu.org>
parents:
diff changeset
4729 @cindex Options, viewing cross-references
Dave Love <fx@gnu.org>
parents:
diff changeset
4730 @cindex Viewing cross-references, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4731
Dave Love <fx@gnu.org>
parents:
diff changeset
4732 @defopt reftex-view-crossref-extra
Dave Love <fx@gnu.org>
parents:
diff changeset
4733 Macros which can be used for the display of cross references.
Dave Love <fx@gnu.org>
parents:
diff changeset
4734 This is used when `reftex-view-crossref' is called with point in an
Dave Love <fx@gnu.org>
parents:
diff changeset
4735 argument of a macro. Note that crossref viewing for citations,
Dave Love <fx@gnu.org>
parents:
diff changeset
4736 references (both ways) and index entries is hard-coded. This variable
Dave Love <fx@gnu.org>
parents:
diff changeset
4737 is only to configure additional structures for which crossreference
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4738 viewing can be useful. Each entry has the structure
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4739 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4740 (@var{macro-re} @var{search-re} @var{highlight}).
Dave Love <fx@gnu.org>
parents:
diff changeset
4741 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
4742 @var{macro-re} is matched against the macro. @var{search-re} is the
Dave Love <fx@gnu.org>
parents:
diff changeset
4743 regexp used to search for cross references. @samp{%s} in this regexp is
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
4744 replaced with the macro argument at point. @var{highlight} is an
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4745 integer indicating which subgroup of the match should be highlighted.
Dave Love <fx@gnu.org>
parents:
diff changeset
4746 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4747
Dave Love <fx@gnu.org>
parents:
diff changeset
4748 @defopt reftex-auto-view-crossref
Dave Love <fx@gnu.org>
parents:
diff changeset
4749 Non-@code{nil} means, initially turn automatic viewing of crossref info
Dave Love <fx@gnu.org>
parents:
diff changeset
4750 on. Automatic viewing of crossref info normally uses the echo area.
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4751 Whenever point is idle for more than @code{reftex-idle-time} seconds on
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4752 the argument of a @code{\ref} or @code{\cite} macro, and no other
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4753 message is being displayed, the echo area will display information about
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4754 that cross reference. You can also set the variable to the symbol
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4755 @code{window}. In this case a small temporary window is used for the
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
4756 display. This feature can be turned on and off from the menu
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4757 (Ref->Options).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4758 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4759
Dave Love <fx@gnu.org>
parents:
diff changeset
4760 @defopt reftex-idle-time
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4761 Time (secs) Emacs has to be idle before automatic crossref display
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4762 or toc recentering is done.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4763 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4764
Dave Love <fx@gnu.org>
parents:
diff changeset
4765 @defopt reftex-cite-view-format
Dave Love <fx@gnu.org>
parents:
diff changeset
4766 Citation format used to display citation info in the message area. See
Dave Love <fx@gnu.org>
parents:
diff changeset
4767 the variable @code{reftex-cite-format} for possible percent
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4768 escapes.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4769 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4770
Dave Love <fx@gnu.org>
parents:
diff changeset
4771 @defopt reftex-revisit-to-echo
Dave Love <fx@gnu.org>
parents:
diff changeset
4772 Non-@code{nil} means, automatic citation display will revisit files if
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4773 necessary. When nil, citation display in echo area will only be active
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4774 for cached echo strings (see @code{reftex-cache-cite-echo}), or for
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4775 BibTeX database files which are already visited by a live associated
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
4776 buffers.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4777 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4778
Dave Love <fx@gnu.org>
parents:
diff changeset
4779 @defopt reftex-cache-cite-echo
Dave Love <fx@gnu.org>
parents:
diff changeset
4780 Non-@code{nil} means, the information displayed in the echo area for
Dave Love <fx@gnu.org>
parents:
diff changeset
4781 cite macros (see variable @code{reftex-auto-view-crossref}) is cached and
Dave Love <fx@gnu.org>
parents:
diff changeset
4782 saved along with the parsing information. The cache survives document
Dave Love <fx@gnu.org>
parents:
diff changeset
4783 scans. In order to clear it, use @kbd{M-x reftex-reset-mode}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4784 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4785
Dave Love <fx@gnu.org>
parents:
diff changeset
4786 @node Options (Finding Files), Options (Optimizations), Options (Viewing Cross-References), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4787 @section Finding Files
Dave Love <fx@gnu.org>
parents:
diff changeset
4788 @cindex Options, Finding Files
Dave Love <fx@gnu.org>
parents:
diff changeset
4789 @cindex Finding files, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4790
Dave Love <fx@gnu.org>
parents:
diff changeset
4791 @defopt reftex-texpath-environment-variables
Dave Love <fx@gnu.org>
parents:
diff changeset
4792 List of specifications how to retrieve the search path for TeX files.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4793 Several entries are possible.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4794 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
4795 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4796 If an element is the name of an environment variable, its content is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4797 used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4798 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4799 If an element starts with an exclamation mark, it is used as a command
Dave Love <fx@gnu.org>
parents:
diff changeset
4800 to retrieve the path. A typical command with the kpathsearch library
Dave Love <fx@gnu.org>
parents:
diff changeset
4801 would be @w{@code{"!kpsewhich -show-path=.tex"}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4802 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4803 Otherwise the element itself is interpreted as a path.
Dave Love <fx@gnu.org>
parents:
diff changeset
4804 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
4805 Multiple directories can be separated by the system dependent
Dave Love <fx@gnu.org>
parents:
diff changeset
4806 @code{path-separator}. Directories ending in @samp{//} or @samp{!!} will
Dave Love <fx@gnu.org>
parents:
diff changeset
4807 be expanded recursively. See also @code{reftex-use-external-file-finders}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4808 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4809
Dave Love <fx@gnu.org>
parents:
diff changeset
4810 @defopt reftex-bibpath-environment-variables
Dave Love <fx@gnu.org>
parents:
diff changeset
4811 List of specifications how to retrieve the search path for BibTeX
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4812 files. Several entries are possible.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4813 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
4814 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4815 If an element is the name of an environment variable, its content is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4816 used.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4817 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4818 If an element starts with an exclamation mark, it is used as a command
Dave Love <fx@gnu.org>
parents:
diff changeset
4819 to retrieve the path. A typical command with the kpathsearch library
Dave Love <fx@gnu.org>
parents:
diff changeset
4820 would be @w{@code{"!kpsewhich -show-path=.bib"}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4821 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4822 Otherwise the element itself is interpreted as a path.
Dave Love <fx@gnu.org>
parents:
diff changeset
4823 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
4824 Multiple directories can be separated by the system dependent
Dave Love <fx@gnu.org>
parents:
diff changeset
4825 @code{path-separator}. Directories ending in @samp{//} or @samp{!!} will
Dave Love <fx@gnu.org>
parents:
diff changeset
4826 be expanded recursively. See also @code{reftex-use-external-file-finders}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4827 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4828
Dave Love <fx@gnu.org>
parents:
diff changeset
4829 @defopt reftex-file-extensions
Dave Love <fx@gnu.org>
parents:
diff changeset
4830 Association list with file extensions for different file types.
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
4831 This is a list of items, each item is like:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4832 @code{(@var{type} . (@var{def-ext} @var{other-ext} ...))}
Dave Love <fx@gnu.org>
parents:
diff changeset
4833 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
4834 @var{type}: @r{File type like @code{"bib"} or @code{"tex"}.}
Dave Love <fx@gnu.org>
parents:
diff changeset
4835 @var{def-ext}: @r{The default extension for that file type, like @code{".tex"} or @code{".bib"}.}
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4836 @var{other-ext}: @r{Any number of other valid extensions for this file type.}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4837 @end example
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
4838 When a files is searched and it does not have any of the valid extensions,
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4839 we try the default extension first, and then the naked file name.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4840 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4841
Dave Love <fx@gnu.org>
parents:
diff changeset
4842 @defopt reftex-search-unrecursed-path-first
Dave Love <fx@gnu.org>
parents:
diff changeset
4843 Non-@code{nil} means, search all specified directories before trying
Dave Love <fx@gnu.org>
parents:
diff changeset
4844 recursion. Thus, in a path @samp{.//:/tex/}, search first @samp{./},
Dave Love <fx@gnu.org>
parents:
diff changeset
4845 then @samp{/tex/}, and then all subdirectories of @samp{./}. If this
Dave Love <fx@gnu.org>
parents:
diff changeset
4846 option is @code{nil}, the subdirectories of @samp{./} are searched
Dave Love <fx@gnu.org>
parents:
diff changeset
4847 before @samp{/tex/}. This is mainly for speed - most of the time the
Dave Love <fx@gnu.org>
parents:
diff changeset
4848 recursive path is for the system files and not for the user files. Set
Dave Love <fx@gnu.org>
parents:
diff changeset
4849 this to @code{nil} if the default makes @b{Ref@TeX{}} finding files with
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4850 equal names in wrong sequence.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4851 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4852
Dave Love <fx@gnu.org>
parents:
diff changeset
4853 @defopt reftex-use-external-file-finders
Dave Love <fx@gnu.org>
parents:
diff changeset
4854 Non-@code{nil} means, use external programs to find files. Normally,
Dave Love <fx@gnu.org>
parents:
diff changeset
4855 @b{Ref@TeX{}} searches the paths given in the environment variables
Dave Love <fx@gnu.org>
parents:
diff changeset
4856 @code{TEXINPUTS} and @code{BIBINPUTS} to find TeX files and BibTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
4857 database files. With this option turned on, it calls an external
Dave Love <fx@gnu.org>
parents:
diff changeset
4858 program specified in the option @code{reftex-external-file-finders}
Dave Love <fx@gnu.org>
parents:
diff changeset
4859 instead. As a side effect, the variables
Dave Love <fx@gnu.org>
parents:
diff changeset
4860 @code{reftex-texpath-environment-variables} and
Dave Love <fx@gnu.org>
parents:
diff changeset
4861 @code{reftex-bibpath-environment-variables} will be ignored.
Dave Love <fx@gnu.org>
parents:
diff changeset
4862 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4863
Dave Love <fx@gnu.org>
parents:
diff changeset
4864 @defopt reftex-external-file-finders
Dave Love <fx@gnu.org>
parents:
diff changeset
4865 Association list with external programs to call for finding files. Each
Dave Love <fx@gnu.org>
parents:
diff changeset
4866 entry is a cons cell @w{@code{(@var{type} . @var{program})}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4867 @var{type} is either @code{"tex"} or @code{"bib"}. @var{program} is a
Dave Love <fx@gnu.org>
parents:
diff changeset
4868 string containing the external program to use with any arguments.
Dave Love <fx@gnu.org>
parents:
diff changeset
4869 @code{%f} will be replaced by the name of the file to be found. Note
Dave Love <fx@gnu.org>
parents:
diff changeset
4870 that these commands will be executed directly, not via a shell. Only
Dave Love <fx@gnu.org>
parents:
diff changeset
4871 relevant when @code{reftex-use-external-file-finders} is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4872 non-@code{nil}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4873 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4874
Dave Love <fx@gnu.org>
parents:
diff changeset
4875 @page
Dave Love <fx@gnu.org>
parents:
diff changeset
4876 @node Options (Optimizations), Options (Fontification), Options (Finding Files), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4877 @section Optimizations
Dave Love <fx@gnu.org>
parents:
diff changeset
4878 @cindex Options, optimizations
Dave Love <fx@gnu.org>
parents:
diff changeset
4879 @cindex Optimizations, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4880
Dave Love <fx@gnu.org>
parents:
diff changeset
4881 @defopt reftex-keep-temporary-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
4882 Non-@code{nil} means, keep buffers created for parsing and lookup.
Dave Love <fx@gnu.org>
parents:
diff changeset
4883 @b{Ref@TeX{}} sometimes needs to visit files related to the current
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4884 document. We distinguish files visited for
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4885 @table @asis
Dave Love <fx@gnu.org>
parents:
diff changeset
4886 @item PARSING
Dave Love <fx@gnu.org>
parents:
diff changeset
4887 Parts of a multifile document loaded when (re)-parsing the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4888 document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4889 @item LOOKUP
Dave Love <fx@gnu.org>
parents:
diff changeset
4890 BibTeX database files and TeX files loaded to find a reference, to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4891 display label context, etc.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4892 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4893 The created buffers can be kept for later use, or be thrown away
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4894 immediately after use, depending on the value of this variable:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4895
Dave Love <fx@gnu.org>
parents:
diff changeset
4896 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
4897 @item nil
Dave Love <fx@gnu.org>
parents:
diff changeset
4898 Throw away as much as possible.
Dave Love <fx@gnu.org>
parents:
diff changeset
4899 @item t
Dave Love <fx@gnu.org>
parents:
diff changeset
4900 Keep everything.
Dave Love <fx@gnu.org>
parents:
diff changeset
4901 @item 1
Dave Love <fx@gnu.org>
parents:
diff changeset
4902 Throw away buffers created for parsing, but keep the ones created for
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4903 lookup.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4904 @end table
Dave Love <fx@gnu.org>
parents:
diff changeset
4905
Dave Love <fx@gnu.org>
parents:
diff changeset
4906 If a buffer is to be kept, the file is visited normally (which is
Dave Love <fx@gnu.org>
parents:
diff changeset
4907 potentially slow but will happen only once). If a buffer is to be thrown
Dave Love <fx@gnu.org>
parents:
diff changeset
4908 away, the initialization of the buffer depends upon the variable
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4909 @code{reftex-initialize-temporary-buffers}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4910 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4911
Dave Love <fx@gnu.org>
parents:
diff changeset
4912 @defopt reftex-initialize-temporary-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
4913 Non-@code{nil} means do initializations even when visiting file
Dave Love <fx@gnu.org>
parents:
diff changeset
4914 temporarily. When @code{nil}, @b{Ref@TeX{}} may turn off find-file hooks and
Dave Love <fx@gnu.org>
parents:
diff changeset
4915 other stuff to briefly visit a file. When @code{t}, the full default
Dave Love <fx@gnu.org>
parents:
diff changeset
4916 initializations are done (@code{find-file-hook} etc.). Instead of
Dave Love <fx@gnu.org>
parents:
diff changeset
4917 @code{t} or @code{nil}, this variable may also be a list of hook
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4918 functions to do a minimal initialization.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4919 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4920
Dave Love <fx@gnu.org>
parents:
diff changeset
4921 @defopt reftex-no-include-regexps
Dave Love <fx@gnu.org>
parents:
diff changeset
4922 List of regular expressions to exclude certain input files from parsing.
Dave Love <fx@gnu.org>
parents:
diff changeset
4923 If the name of a file included via @code{\include} or @code{\input} is
Dave Love <fx@gnu.org>
parents:
diff changeset
4924 matched by any of the regular expressions in this list, that file is not
Dave Love <fx@gnu.org>
parents:
diff changeset
4925 parsed by @b{Ref@TeX{}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
4926 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4927
Dave Love <fx@gnu.org>
parents:
diff changeset
4928 @defopt reftex-enable-partial-scans
Dave Love <fx@gnu.org>
parents:
diff changeset
4929 Non-@code{nil} means, re-parse only 1 file when asked to re-parse.
Dave Love <fx@gnu.org>
parents:
diff changeset
4930 Re-parsing is normally requested with a @kbd{C-u} prefix to many @b{Ref@TeX{}}
Dave Love <fx@gnu.org>
parents:
diff changeset
4931 commands, or with the @kbd{r} key in menus. When this option is
Dave Love <fx@gnu.org>
parents:
diff changeset
4932 @code{t} in a multifile document, we will only parse the current buffer,
Dave Love <fx@gnu.org>
parents:
diff changeset
4933 or the file associated with the label or section heading near point in a
Dave Love <fx@gnu.org>
parents:
diff changeset
4934 menu. Requesting re-parsing of an entire multifile document then
Dave Love <fx@gnu.org>
parents:
diff changeset
4935 requires a @kbd{C-u C-u} prefix or the capital @kbd{R} key in
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4936 menus.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4937 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4938
Dave Love <fx@gnu.org>
parents:
diff changeset
4939 @defopt reftex-save-parse-info
Dave Love <fx@gnu.org>
parents:
diff changeset
4940 Non-@code{nil} means, save information gathered with parsing in files.
Dave Love <fx@gnu.org>
parents:
diff changeset
4941 The file @file{MASTER.rel} in the same directory as @file{MASTER.tex} is
Dave Love <fx@gnu.org>
parents:
diff changeset
4942 used to save the information. When this variable is @code{t},
Dave Love <fx@gnu.org>
parents:
diff changeset
4943 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
4944 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4945 accessing the parsing information for the first time in an editing
Dave Love <fx@gnu.org>
parents:
diff changeset
4946 session will read that file (if available) instead of parsing the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4947 document.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4948 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
4949 exiting Emacs or killing a buffer in reftex-mode will cause a new
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4950 version of the file to be written.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4951 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
4952 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4953
27195
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4954 @defopt reftex-parse-file-extension
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4955 File extension for the file in which parser information is stored.
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4956 This extension is added to the base name of the master file.
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4957 @end defopt
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
4958
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4959 @defopt reftex-allow-automatic-rescan
Dave Love <fx@gnu.org>
parents:
diff changeset
4960 Non-@code{nil} means, @b{Ref@TeX{}} may rescan the document when this seems
Dave Love <fx@gnu.org>
parents:
diff changeset
4961 necessary. Applies (currently) only in rare cases, when a new label
Dave Love <fx@gnu.org>
parents:
diff changeset
4962 cannot be placed with certainty into the internal label list.
Dave Love <fx@gnu.org>
parents:
diff changeset
4963 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4964
Dave Love <fx@gnu.org>
parents:
diff changeset
4965 @defopt reftex-use-multiple-selection-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
4966 Non-@code{nil} means use a separate selection buffer for each label
Dave Love <fx@gnu.org>
parents:
diff changeset
4967 type. These buffers are kept from one selection to the next and need
Dave Love <fx@gnu.org>
parents:
diff changeset
4968 not to be created for each use - so the menu generally comes up faster.
Dave Love <fx@gnu.org>
parents:
diff changeset
4969 The selection buffers will be erased (and therefore updated)
Dave Love <fx@gnu.org>
parents:
diff changeset
4970 automatically when new labels in its category are added. See the
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4971 variable @code{reftex-auto-update-selection-buffers}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4972 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4973
Dave Love <fx@gnu.org>
parents:
diff changeset
4974 @defopt reftex-auto-update-selection-buffers
Dave Love <fx@gnu.org>
parents:
diff changeset
4975 Non-@code{nil} means, selection buffers will be updated automatically.
Dave Love <fx@gnu.org>
parents:
diff changeset
4976 When a new label is defined with @code{reftex-label}, all selection
Dave Love <fx@gnu.org>
parents:
diff changeset
4977 buffers associated with that label category are emptied, in order to
Dave Love <fx@gnu.org>
parents:
diff changeset
4978 force an update upon next use. When @code{nil}, the buffers are left
Dave Love <fx@gnu.org>
parents:
diff changeset
4979 alone and have to be updated by hand, with the @kbd{g} key from the
Dave Love <fx@gnu.org>
parents:
diff changeset
4980 label selection process. The value of this variable will only have any
Dave Love <fx@gnu.org>
parents:
diff changeset
4981 effect when @code{reftex-use-multiple-selection-buffers} is
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4982 non-@code{nil}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4983 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4984
Dave Love <fx@gnu.org>
parents:
diff changeset
4985 @node Options (Fontification), Options (Misc), Options (Optimizations), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
4986 @section Fontification
Dave Love <fx@gnu.org>
parents:
diff changeset
4987 @cindex Options, fontification
Dave Love <fx@gnu.org>
parents:
diff changeset
4988 @cindex Fontification, options
Dave Love <fx@gnu.org>
parents:
diff changeset
4989
Dave Love <fx@gnu.org>
parents:
diff changeset
4990 @defopt reftex-use-fonts
Dave Love <fx@gnu.org>
parents:
diff changeset
4991 Non-@code{nil} means, use fonts in label menu and on-the-fly help.
Dave Love <fx@gnu.org>
parents:
diff changeset
4992 Font-lock must be loaded as well to actually get fontified
Dave Love <fx@gnu.org>
parents:
diff changeset
4993 display. After changing this option, a rescan may be necessary to
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
4994 activate it.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
4995 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
4996
Dave Love <fx@gnu.org>
parents:
diff changeset
4997 @defopt reftex-refontify-context
Dave Love <fx@gnu.org>
parents:
diff changeset
4998 Non-@code{nil} means, re-fontify the context in the label menu with
Dave Love <fx@gnu.org>
parents:
diff changeset
4999 font-lock. This slightly slows down the creation of the label menu. It
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5000 is only necessary when you definitely want the context fontified.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5001
Dave Love <fx@gnu.org>
parents:
diff changeset
5002 This option may have 3 different values:
Dave Love <fx@gnu.org>
parents:
diff changeset
5003 @table @code
Dave Love <fx@gnu.org>
parents:
diff changeset
5004 @item nil
Dave Love <fx@gnu.org>
parents:
diff changeset
5005 Never refontify.
Dave Love <fx@gnu.org>
parents:
diff changeset
5006 @item t
Dave Love <fx@gnu.org>
parents:
diff changeset
5007 Always refontify.
Dave Love <fx@gnu.org>
parents:
diff changeset
5008 @item 1
Dave Love <fx@gnu.org>
parents:
diff changeset
5009 Refontify when necessary, e.g. with old versions of the x-symbol
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5010 package.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5011 @end table
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5012 The option is ignored when @code{reftex-use-fonts} is @code{nil}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5013 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5014
Dave Love <fx@gnu.org>
parents:
diff changeset
5015 @defopt reftex-highlight-selection
Dave Love <fx@gnu.org>
parents:
diff changeset
5016 Non-@code{nil} means, highlight selected text in selection and
Dave Love <fx@gnu.org>
parents:
diff changeset
5017 @file{*toc*} buffers. Normally, the text near the cursor is the
Dave Love <fx@gnu.org>
parents:
diff changeset
5018 @emph{selected} text, and it is highlighted. This is the entry most
Dave Love <fx@gnu.org>
parents:
diff changeset
5019 keys in the selection and @file{*toc*} buffers act on. However, if you
Dave Love <fx@gnu.org>
parents:
diff changeset
5020 mainly use the mouse to select an item, you may find it nice to have
Dave Love <fx@gnu.org>
parents:
diff changeset
5021 mouse-triggered highlighting @emph{instead} or @emph{as well}. The
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5022 variable may have one of these values:
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5023
Dave Love <fx@gnu.org>
parents:
diff changeset
5024 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
5025 nil @r{No highlighting.}
Dave Love <fx@gnu.org>
parents:
diff changeset
5026 cursor @r{Highlighting is cursor driven.}
Dave Love <fx@gnu.org>
parents:
diff changeset
5027 mouse @r{Highlighting is mouse driven.}
Dave Love <fx@gnu.org>
parents:
diff changeset
5028 both @r{Both cursor and mouse trigger highlighting.}
Dave Love <fx@gnu.org>
parents:
diff changeset
5029 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
5030
Dave Love <fx@gnu.org>
parents:
diff changeset
5031 Changing this variable requires to rebuild the selection and *toc*
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5032 buffers to become effective (keys @kbd{g} or @kbd{r}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5033 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5034
Dave Love <fx@gnu.org>
parents:
diff changeset
5035 @defopt reftex-cursor-selected-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5036 Face name to highlight cursor selected item in toc and selection buffers.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5037 See also the variable @code{reftex-highlight-selection}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5038 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5039 @defopt reftex-mouse-selected-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5040 Face name to highlight mouse selected item in toc and selection buffers.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5041 See also the variable @code{reftex-highlight-selection}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5042 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5043 @defopt reftex-file-boundary-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5044 Face name for file boundaries in selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5045 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5046 @defopt reftex-label-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5047 Face name for labels in selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5048 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5049 @defopt reftex-section-heading-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5050 Face name for section headings in toc and selection buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
5051 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5052 @defopt reftex-toc-header-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5053 Face name for the header of a toc buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5054 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5055 @defopt reftex-bib-author-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5056 Face name for author names in bib selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5057 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5058 @defopt reftex-bib-year-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5059 Face name for year in bib selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5060 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5061 @defopt reftex-bib-title-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5062 Face name for article title in bib selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5063 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5064 @defopt reftex-bib-extra-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5065 Face name for bibliographic information in bib selection buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5066 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5067 @defopt reftex-select-mark-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5068 Face name for marked entries in the selection buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
5069 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5070 @defopt reftex-index-header-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5071 Face name for the header of an index buffer.
Dave Love <fx@gnu.org>
parents:
diff changeset
5072 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5073 @defopt reftex-index-section-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5074 Face name for the start of a new letter section in the index.
Dave Love <fx@gnu.org>
parents:
diff changeset
5075 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5076 @defopt reftex-index-tag-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5077 Face name for index names (for multiple indices).
Dave Love <fx@gnu.org>
parents:
diff changeset
5078 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5079 @defopt reftex-index-face
Dave Love <fx@gnu.org>
parents:
diff changeset
5080 Face name for index entries.
Dave Love <fx@gnu.org>
parents:
diff changeset
5081 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5082
Dave Love <fx@gnu.org>
parents:
diff changeset
5083 @node Options (Misc), , Options (Fontification), Options
Dave Love <fx@gnu.org>
parents:
diff changeset
5084 @section Miscellaneous
Dave Love <fx@gnu.org>
parents:
diff changeset
5085 @cindex Options, misc
Dave Love <fx@gnu.org>
parents:
diff changeset
5086
Dave Love <fx@gnu.org>
parents:
diff changeset
5087 @defopt reftex-extra-bindings
Dave Love <fx@gnu.org>
parents:
diff changeset
5088 Non-@code{nil} means, make additional key bindings on startup. These
Dave Love <fx@gnu.org>
parents:
diff changeset
5089 extra bindings are located in the users @samp{C-c letter}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5090 map. @xref{Key Bindings}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5091 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5092
Dave Love <fx@gnu.org>
parents:
diff changeset
5093 @defopt reftex-plug-into-AUCTeX
Dave Love <fx@gnu.org>
parents:
diff changeset
5094 Plug-in flags for AUCTeX interface. This variable is a list of
Dave Love <fx@gnu.org>
parents:
diff changeset
5095 5 boolean flags. When a flag is non-@code{nil}, @b{Ref@TeX{}}
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5096 will
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5097
Dave Love <fx@gnu.org>
parents:
diff changeset
5098 @example
Dave Love <fx@gnu.org>
parents:
diff changeset
5099 - supply labels in new sections and environments (flag 1)
Dave Love <fx@gnu.org>
parents:
diff changeset
5100 - supply arguments for macros like @code{\label} (flag 2)
Dave Love <fx@gnu.org>
parents:
diff changeset
5101 - supply arguments for macros like @code{\ref} (flag 3)
Dave Love <fx@gnu.org>
parents:
diff changeset
5102 - supply arguments for macros like @code{\cite} (flag 4)
Dave Love <fx@gnu.org>
parents:
diff changeset
5103 - supply arguments for macros like @code{\index} (flag 5)
Dave Love <fx@gnu.org>
parents:
diff changeset
5104 @end example
Dave Love <fx@gnu.org>
parents:
diff changeset
5105
Dave Love <fx@gnu.org>
parents:
diff changeset
5106 You may also set the variable itself to t or nil in order to turn all
Dave Love <fx@gnu.org>
parents:
diff changeset
5107 options on or off, respectively.@*
Dave Love <fx@gnu.org>
parents:
diff changeset
5108 Supplying labels in new sections and environments applies when creating
Dave Love <fx@gnu.org>
parents:
diff changeset
5109 sections with @kbd{C-c C-s} and environments with @kbd{C-c C-e}.@*
Dave Love <fx@gnu.org>
parents:
diff changeset
5110 Supplying macro arguments applies when you insert such a macro
Dave Love <fx@gnu.org>
parents:
diff changeset
5111 interactively with @kbd{C-c @key{RET}}.@*
Dave Love <fx@gnu.org>
parents:
diff changeset
5112 See the AUCTeX documentation for more information.
Dave Love <fx@gnu.org>
parents:
diff changeset
5113 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5114
Dave Love <fx@gnu.org>
parents:
diff changeset
5115 @defopt reftex-revisit-to-follow
Dave Love <fx@gnu.org>
parents:
diff changeset
5116 Non-@code{nil} means, follow-mode will revisit files if necessary.
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5117 When nil, follow-mode will be suspended for stuff in unvisited files.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5118 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5119
Dave Love <fx@gnu.org>
parents:
diff changeset
5120 @defopt reftex-allow-detached-macro-args
Dave Love <fx@gnu.org>
parents:
diff changeset
5121 Non-@code{nil} means, allow arguments of macros to be detached by
Dave Love <fx@gnu.org>
parents:
diff changeset
5122 whitespace. When this is @code{t}, the @samp{aaa} in @w{@samp{\bbb
Dave Love <fx@gnu.org>
parents:
diff changeset
5123 [xxx] @{aaa@}}} will be considered an argument of @code{\bb}. Note that
Dave Love <fx@gnu.org>
parents:
diff changeset
5124 this will be the case even if @code{\bb} is defined with zero or one
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5125 argument.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5126 @end defopt
Dave Love <fx@gnu.org>
parents:
diff changeset
5127
Dave Love <fx@gnu.org>
parents:
diff changeset
5128 @node Keymaps and Hooks, Changes, Options, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
5129 @section Keymaps and Hooks
Dave Love <fx@gnu.org>
parents:
diff changeset
5130 @cindex Keymaps
Dave Love <fx@gnu.org>
parents:
diff changeset
5131
Dave Love <fx@gnu.org>
parents:
diff changeset
5132 @b{Ref@TeX{}} has the usual general keymap and load-- and mode-hook.
Dave Love <fx@gnu.org>
parents:
diff changeset
5133
Dave Love <fx@gnu.org>
parents:
diff changeset
5134 @deffn Keymap reftex-mode-map
Dave Love <fx@gnu.org>
parents:
diff changeset
5135 The keymap for @b{Ref@TeX{}} mode.
Dave Love <fx@gnu.org>
parents:
diff changeset
5136 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
5137
Dave Love <fx@gnu.org>
parents:
diff changeset
5138 @deffn {Normal Hook} reftex-load-hook
Dave Love <fx@gnu.org>
parents:
diff changeset
5139 Normal hook which is being run when loading @file{reftex.el}.
Dave Love <fx@gnu.org>
parents:
diff changeset
5140 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
5141
Dave Love <fx@gnu.org>
parents:
diff changeset
5142 @deffn {Normal Hook} reftex-mode-hook
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5143 Normal hook which is being run when turning on @b{Ref@TeX{}} mode.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5144 @end deffn
Dave Love <fx@gnu.org>
parents:
diff changeset
5145
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5146 Furthermore, the 4 modes used for referencing labels, creating
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5147 citations, the table of contents buffer and the phrases buffer have
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5148 their own keymaps and mode hooks. See the respective sections. There
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5149 are many more hooks which are described in the relevant sections about
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5150 options for a specific part of @b{Ref@TeX{}}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5151
Dave Love <fx@gnu.org>
parents:
diff changeset
5152 @node Changes, , Keymaps and Hooks, Top
Dave Love <fx@gnu.org>
parents:
diff changeset
5153 @chapter Changes
Dave Love <fx@gnu.org>
parents:
diff changeset
5154 @cindex Changes
Dave Love <fx@gnu.org>
parents:
diff changeset
5155
Dave Love <fx@gnu.org>
parents:
diff changeset
5156 Here is a list of recent changes to @b{Ref@TeX{}}.
Dave Love <fx@gnu.org>
parents:
diff changeset
5157
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5158 @noindent @b{Version 4.28}
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5159 @itemize @bullet
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5160 @item Support for the Jurabib package.
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5161 @item Improvements when selecting several items in a selection buffer.
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5162 @end itemize
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5163
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5164 @noindent @b{Version 4.26}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5165 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5166 @item
62469
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5167 Support for global incremental search.
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5168 @item
e454fb80ab88 Version 4.28
Carsten Dominik <dominik@science.uva.nl>
parents: 60927
diff changeset
5169 Some improvements for XEmacs compatibility.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5170 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5171
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5172 @noindent @b{Version 4.25}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5173 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5174 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5175 Fixed bug with @samp{%F} in a label prefix. Added new escapes
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5176 @samp{%m} and @samp{%M} for mater file name and master directory.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5177 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5178
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5179 @noindent @b{Version 4.24}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5180 @itemize @bullet
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5181 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5182 Inserting citation commands now prompts for optional arguments
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5183 when called with a prefix argument. Related new options are
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5184 @code{reftex-cite-prompt-optional-args} and
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5185 @code{reftex-cite-cleanup-optional-args}.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5186 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5187 New option @code{reftex-trust-label-prefix}. Configure this variable
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5188 if you'd like RefTeX to base its classification of labels on prefixes.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5189 This can speed-up document parsing, but may in some cases reduce the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5190 quality of the context used by RefTeX to describe a label.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5191 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5192 Fixed bug in @code{reftex-create-bibtex-file} when @code{reftex-comment-citations}
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5193 is non-nil.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5194 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5195 Fixed bugs in indexing: Case-sensitive search, quotes before and/or
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5196 after words. Disabbled indexing in comment lines.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5197 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5198
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5199 @noindent @b{Version 4.22}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5200 @itemize @bullet
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5201 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5202 New command @code{reftex-create-bibtex-file} to create a new database
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5203 with all entries referenced in the current document.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5204 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5205 New keys @kbd{e} and @kbd{E} allow to produce a BibTeX database file
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5206 from entries marked in a citation selection buffer.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5207 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5208
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5209 @noindent @b{Version 4.21}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5210 @itemize @bullet
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5211 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5212 Renaming labels from the toc buffer with key @kbd{M-%}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5213 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5214
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5215 @noindent @b{Version 4.20}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5216 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5217 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5218 Structure editing capabilities. The command keys @kbd{<} and @kbd{>} in
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5219 the TOC buffer promote/demote the section at point or all sections in
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5220 the current region.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5221 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5222 New option @code{reftex-toc-split-windows-fraction} to set the size of
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5223 the window used by the TOC. This makes the old variable
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5224 @code{reftex-toc-split-windows-horizontally-fraction} obsolete.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5225 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5226 A dedicated frame can show the TOC with the current section
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5227 always automatically highlighted. The frame is created and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5228 deleted from the toc buffer with the @kbd{d} key.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5229 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5230
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5231 @noindent @b{Version 4.19}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5232 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5233 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5234 New command `reftex-toc-recenter' (@kbd{C-c -}) which shows the current
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5235 section in the TOC buffer without selecting the TOC window.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5236 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5237 Recentering happens automatically in idle time when the option
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5238 @code{reftex-auto-recenter-toc} is turned on.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5239 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5240 Fixed several bugs related to automatic cursor positioning in the TOC
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5241 buffer.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5242 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5243 The highlight in the TOC buffer stays when the focus moves to a
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5244 different window.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5245 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5246 New command `reftex-goto-label'.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5247 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5248 Part numbers are no longer included in chapter numbers, and a new
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5249 part does not reset the chapter counter. See new option
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5250 @code{reftex-part-resets-chapter}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5251 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5252
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5253 @noindent @b{Version 4.18}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5254 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5255 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5256 @code{reftex-citation} uses the word before the cursor as a default
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5257 search string.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5258 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5259 Simplified several regular expressions for speed.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5260 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5261 Better support for chapterbib.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5262 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5263
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5264 @noindent @b{Version 4.17}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5265 @itemize @bullet
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5266 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5267 The toc window can be split off horizontally. See new options
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5268 @code{reftex-toc-split-windows-horizontally},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5269 @code{reftex-toc-split-windows-horizontally-fraction}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5270 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5271 It is possible to specify a function which verifies an index match
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5272 during global indexing. See new option @code{reftex-index-verify-function}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5273 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5274 The macros which input a file in LaTeX (like \input, \include) can
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5275 be configured. See new option @code{reftex-include-file-commands}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5276 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5277 The macros which specify the bibliography file (like \bibliography) can
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5278 be configured. See new option @code{reftex-bibliography-commands}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5279 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5280 The regular expression used to search for the \bibliography macro has
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5281 been relaxed to allow for @samp{@{\bibliography@{...@}@}} needed by
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5282 chapterbib.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5283 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5284 Small bug fixes.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5285 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5286
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5287 @noindent @b{Version 4.15}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5288 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5289 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5290 Fixed bug with parsing of BibTeX files, when fields contain quotes or
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5291 unmatched parenthesis.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5292 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5293 Small bug fixes.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5294 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5295 Improved interaction with Emacs LaTeX mode.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5296 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5297
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5298 @noindent @b{Version 4.12}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5299 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5300 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5301 Support for @file{bibentry} citation style.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5302 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5303
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5304 @noindent @b{Version 4.11}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5305 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5306 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5307 Fixed bug which would parse @samp{\Section} just like @samp{\section}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5308 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5309
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5310 @noindent @b{Version 4.10}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5311 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5312 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5313 Renamed @file{reftex-vcr.el} to @file{reftex-dcr.el} because of conflict
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5314 with @file{reftex-vars.el} on DOS machines.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5315 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5316 New options @code{reftex-parse-file-extension} and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5317 @code{reftex-index-phrase-file-extension}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5318 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5319
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5320 @noindent [.....]
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5321 @ignore
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5322 @noindent @b{Version 4.09}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5323 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5324 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5325 New option @code{reftex-toc-max-level} to limit the depth of the toc.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5326 New key binding @kbd{t} in the @file{*toc*} buffer to change this
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5327 setting.
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5328 @item
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5329 RefTeX maintains an @file{Index Phrases} file in which phrases can be
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5330 collected. When the document is ready, RefTeX can search all
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5331 these phrases and assist indexing all matches.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5332 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5333 The variables @code{reftex-index-macros} and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5334 @code{reftex-index-default-macro} have changed their syntax slightly.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5335 The @var{repeat} parameter has move from the latter to the former.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5336 Also calls to @code{reftex-add-index-macros} from AUCTeX style files
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5337 need to be adapted.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5338 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5339 The variable @code{reftex-section-levels} no longer contains the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5340 default stuff which has been moved to a constant.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5341 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5342 Environments like theorems can be placed into the TOC by putting
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5343 entries for @samp{"begin@{theorem@}"} in
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5344 @code{reftex-setion-levels}.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5345 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5346
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5347 @noindent @b{Version 4.06}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5348 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5349 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5350 @code{reftex-section-levels} can contain a function to compute the level
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5351 of a sectioning command.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5352 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5353 Multiple @code{thebibliography} environments recognized.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5354 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5355
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5356 @noindent @b{Version 4.04}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5357 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5358 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5359 New option @code{reftex-index-default-tag} implements a default for queries.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5360 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5361
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5362 @noindent @b{Version 4.02}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5363 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5364 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5365 macros ending in @samp{refrange} are considered to contain references.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5366 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5367 Index entries made with @code{reftex-index-selection-or-word} in TeX
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5368 math mode automatically get enclosing @samp{$} to preserve math mode. See
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5369 new option @code{reftex-index-math-format}. Requires AUCTeX.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5370 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5371
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5372 @noindent @b{Version 4.01}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5373 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5374 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5375 New command @code{reftex-index-globally} to index a word in many
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5376 places in the document. Also available from the index buffer with
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5377 @kbd{&}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5378 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5379 The first item in a @code{reftex-label-alist} entry may now also be a parser
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5380 function to do non-standard parsing.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5381 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5382 @code{reftex-auto-view-crossref} no longer interferes with
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5383 @code{pop-up-frames} (patch from Stefan Monnier).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5384 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5385
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5386 @noindent @b{Version 4.00}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5387 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5388 @item
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5389 RefTeX has been split into several smaller files which are autoloaded on
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5390 demand.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5391 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5392 Index support, along with many new options.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5393 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5394 The selection of keys for @code{\ref} and @code{\cite} now allows to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5395 select multiple items by marking entries with the @kbd{m} key.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5396 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5397 Fancyref support.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5398 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5399
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5400 @noindent @b{Version 3.43}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5401 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5402 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5403 Viewing cross-references generalized. Now works on @code{\label},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5404 @code{\ref}, @code{\cite}, @code{\bibitem}, @code{\index}, variations of
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5405 these, and from BibTeX buffers.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5406 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5407 New option @code{reftex-view-crossref-extra}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5408 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5409 Support for the additional sectioning commands @code{\addchap} and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5410 @code{\addsec} which are defined in the LaTeX KOMA-Script classes.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5411 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5412 Files in @code{reftex-default-bibliography} will be searched along
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5413 @code{BIBINPUTS} path.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5414 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5415 Reading a parse file now checks consistency.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5416 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5417
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5418 @noindent @b{Version 3.42}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5419 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5420 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5421 File search further refined. New option @code{reftex-file-extensions}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5422 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5423 @file{*toc*} buffer can show the file boundaries of a multifile
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5424 document, all labels and associated context. New keys @kbd{i}, @kbd{l},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5425 and @kbd{c}. New options @code{reftex-toc-include-labels},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5426 @code{reftex-toc-include-context},
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5427 @code{reftex-toc-include-file-boundaries}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5428 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5429
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5430 @noindent @b{Version 3.41}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5431 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5432 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5433 New options @code{reftex-texpath-environment-variables},
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5434 @code{reftex-use-external-file-finders},
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5435 @code{reftex-external-file-finders},
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5436 @code{reftex-search-unrecursed-path-first}.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5437 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5438 @emph{kpathsearch} support. See new options and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5439 @code{reftex-bibpath-environment-variables}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5440 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5441
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5442 @noindent @b{Version 3.38}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5443 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5444 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5445 @code{reftex-view-crossref} no longer moves to find a macro. Point has
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5446 to be on the macro argument.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5447 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5448
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5449 @noindent @b{Version 3.36}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5450 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5451 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5452 New value @code{window} for option @code{reftex-auto-view-crossref}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5453 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5454
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5455 @noindent @b{Version 3.35}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5456 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5457 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5458 ISO 8859 Latin-1 chars are converted to ASCII to derive better labels.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5459 This takes back the related changes in 3.34 for safety reasons.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5460 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5461
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5462 @noindent @b{Version 3.34}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5463 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5464 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5465 Additional flag in @code{reftex-derive-label-parameters} do make only
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5466 lowercase labels (default @code{t}).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5467 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5468 All @file{.rel} files have a final newline to avoid queries.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5469 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5470 Single byte representations of accented European letters (ISO-8859-1)
60927
bae786986f2e * calc.texi, cl.texi, gnus.texi, idlwave.texi, reftex.texi: Replace
Werner LEMBERG <wl@gnu.org>
parents: 60919
diff changeset
5471 are now valid in labels.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5472 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5473
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5474 @noindent @b{Version 3.33}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5475 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5476 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5477 Multiple selection buffers are now hidden buffers (they start with a
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5478 SPACE).
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5479 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5480 Fixed bug with file search when TEXINPUTS environment variable is empty.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5481 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5482
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5483 @noindent @b{Version 3.30}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5484 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5485 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5486 In @code{reftex-citation}, the regular expression used to scan BibTeX
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5487 files can be specified using completion on known citation keys.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5488 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5489 New keys @kbd{a} and @kbd{A} in BibTeX selection process to cite @emph{all}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5490 entries.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5491 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5492 New command @code{reftex-renumber-simple-labels} to renumber simple
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5493 labels like @samp{eq:13} sequentially through a document.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5494 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5495
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5496 @noindent @b{Version 3.28}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5497 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5498 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5499 Auto view crossref for XEmacs uses @code{post-command-hook} to restart the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5500 timer, since itimer restart is not reliable.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5501 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5502 Option @code{reftex-bibfile-ignore-list} renamed to @code{-regexps}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5503 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5504 Expansion of recursive tex and bib path rewritten.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5505 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5506 Fixed problem where @b{Ref@TeX{}} did not scan unsaved buffers.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5507 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5508 Fixed bug with section numbering after *-red sections.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5509 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5510
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5511 @noindent @b{Version 3.27}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5512 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5513 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5514 Macros can define @emph{neutral} labels, just like @code{\label}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5515 itself.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5516 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5517 New option @code{reftex-allow-detached-macro-args}, default @code{nil}!
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5518 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5519
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5520 @noindent @b{Version 3.26}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5521 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5522 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5523 [X]Emacs 19 no longer supported. Use 3.22 for Emacs 19.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5524 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5525 New hooks @code{reftex-translate-to-ascii-function},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5526 @code{reftex-string-to-label-function}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5527 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5528 Made sure automatic crossref display will not visit/scan files.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5529 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5530
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5531 @noindent @b{Version 3.25}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5532 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5533 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5534 Echoing of citation info caches the info for displayed entries.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5535 New option @code{reftex-cache-cite-echo}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5536 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5537 @kbd{M-x reftex-reset-mode} now also removes the file with parsing
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5538 info.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5539 @item
65550
8b9a29062a8e Version 4.30
Carsten Dominik <dominik@science.uva.nl>
parents: 64890
diff changeset
5540 Default of @code{reftex-revisit-to-follow} changed to nil.
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5541 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5542
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5543 @noindent @b{Version 3.24}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5544 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5545 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5546 New option @code{reftex-revisit-to-echo}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5547 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5548 Interface with X-Symbol (>=2.6) is now complete and stable.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5549 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5550 Adapted to new outline, which uses overlays.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5551 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5552 File names in @code{\bibliography} may now have the @code{.bib}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5553 extension.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5554 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5555 Fixed Bug with parsing "single file" from master file buffer.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5556 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5557
Dave Love <fx@gnu.org>
parents:
diff changeset
5558 @noindent @b{Version 3.23}
Dave Love <fx@gnu.org>
parents:
diff changeset
5559 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5560 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5561 Parse files @file{MASTER.rel} made compatible between Emacs and XEmacs.
Dave Love <fx@gnu.org>
parents:
diff changeset
5562 @item
59579
a588c86a429c Revision: miles@gnu.org--gnu-2005/emacs--cvs-trunk--0--patch-40
Miles Bader <miles@gnu.org>
parents: 59548
diff changeset
5563 @code{kill-emacs-hook} and @code{kill-buffer-hook} now write the parse
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5564 file.
Dave Love <fx@gnu.org>
parents:
diff changeset
5565 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5566 The cursor inside a @code{\ref} or @code{\cite} macro can now trigger
Dave Love <fx@gnu.org>
parents:
diff changeset
5567 automatic display of crossref information in the echo area. See
Dave Love <fx@gnu.org>
parents:
diff changeset
5568 variable @code{reftex-auto-view-crossref}.
Dave Love <fx@gnu.org>
parents:
diff changeset
5569 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5570 AUCTeX interface updates:
Dave Love <fx@gnu.org>
parents:
diff changeset
5571 @itemize @minus
Dave Love <fx@gnu.org>
parents:
diff changeset
5572 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5573 AUCTeX 9.9c and later notifies @b{Ref@TeX{}} about new sections.
Dave Love <fx@gnu.org>
parents:
diff changeset
5574 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5575 @b{Ref@TeX{}} notifies AUCTeX about new labels.
Dave Love <fx@gnu.org>
parents:
diff changeset
5576 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5577 @code{TeX-arg-ref} no longer used (introduction was unnecessary).
Dave Love <fx@gnu.org>
parents:
diff changeset
5578 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5579 @code{reftex-arg-label} and @code{reftex-arg-cite} fixed up.
Dave Love <fx@gnu.org>
parents:
diff changeset
5580 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5581 Settings added to @b{Ref@TeX{}} via style files remain local.
Dave Love <fx@gnu.org>
parents:
diff changeset
5582 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5583 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5584 Fixed bug with @code{reftex-citation} in non-latex buffers.
Dave Love <fx@gnu.org>
parents:
diff changeset
5585 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5586 Fixed bug with syntax table and context refontification.
Dave Love <fx@gnu.org>
parents:
diff changeset
5587 @item
Dave Love <fx@gnu.org>
parents:
diff changeset
5588 Safety-net for name change of @code{font-lock-reference-face}.
Dave Love <fx@gnu.org>
parents:
diff changeset
5589 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5590
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5591 @noindent @b{Version 3.22}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5592 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5593 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5594 Fixed bug with empty context strings.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5595 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5596 @code{reftex-mouse-view-crossref} is now bound by default at
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5597 @kbd{S-mouse-2}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5598 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5599
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5600 @noindent @b{Version 3.21}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5601 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5602 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5603 New options for all faces used by @b{Ref@TeX{}}. They're in the
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5604 customization group @code{reftex-fontification-configurations}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5605 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5606
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5607 @noindent @b{Version 3.19}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5608 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5609 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5610 Fixed bug with AUCTeX @code{TeX-master}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5611 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5612
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5613 @noindent @b{Version 3.18}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5614 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5615 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5616 The selection now uses a recursive edit, much like minibuffer input.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5617 This removes all restrictions during selection. E.g. you can now
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5618 switch buffers at will, use the mouse etc.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5619 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5620 New option @code{reftex-highlight-selection}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5621 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5622 @kbd{mouse-2} can be used to select in selection and @file{*toc*}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5623 buffers.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5624 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5625 Fixed some problems regarding the interaction with VIPER mode.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5626 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5627 Follow-mode is now only used after point motion.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5628 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5629 @b{Ref@TeX{}} now finally does not fontify temporary files anymore.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5630 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5631
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5632 @noindent @b{Version 3.17}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5633 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5634 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5635 Additional bindings in selection and @file{*toc*} buffers. @kbd{g}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5636 redefined.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5637 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5638 New command @code{reftex-save-all-document-buffers}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5639 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5640 Magic word matching made more intelligent.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5641 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5642 Selection process can switch to completion (with @key{TAB}).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5643 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5644 @code{\appendix} is now recognized and influences section numbering.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5645 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5646 File commentary shortened considerably (use Info documentation).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5647 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5648 New option @code{reftex-no-include-regexps} to skip some include files.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5649 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5650 New option @code{reftex-revisit-to-follow}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5651 @end itemize
Dave Love <fx@gnu.org>
parents:
diff changeset
5652
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5653 @noindent @b{Version 3.16}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5654 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5655 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5656 New hooks @code{reftex-format-label-function},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5657 @code{reftex-format-ref-function}, @code{reftex-format-cite-function}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5658 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5659 TeXInfo documentation completed.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5660 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5661 Some restrictions in Label inserting and referencing removed.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5662 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5663 New variable @code{reftex-default-bibliography}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5664 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5665
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5666 @noindent @b{Version 3.14}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5667 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5668 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5669 Selection buffers can be kept between selections: this is faster.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5670 See new variable @code{reftex-use-multiple-selection-buffers}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5671 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5672 Prefix interpretation of reftex-view-crossref changed.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5673 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5674 Support for the @code{varioref} package (@kbd{v} key in selection
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5675 buffer).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5676 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5677
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5678 @noindent @b{Version 3.12}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5679 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5680 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5681 There are 3 new keymaps for customization: @code{reftex-toc-map},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5682 @code{reftex-select-label-map}, @code{reftex-select-bib-map}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5683 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5684 Refontification uses more standard font-lock stuff.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5685 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5686 When no BibTeX database files are specified, citations can also use
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5687 @code{\bibitem} entries from a @code{thebibliography} environment.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5688 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5689
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5690 @noindent @b{Version 3.11}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5691 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5692 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5693 Fixed bug which led to naked label in (e.g.) footnotes.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5694 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5695 Added scroll-other-window functions to RefTeX-Select.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5696 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5697
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5698 @noindent @b{Version 3.10}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5699 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5700 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5701 Fixed a bug which made reftex 3.07 fail on [X]Emacs version 19.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5702 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5703 Removed unimportant code which caused OS/2 Emacs to crash.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5704 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5705 All customization variables now accessible from menu.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5706 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5707
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5708 @noindent @b{Version 3.07}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5709 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5710 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5711 @code{Ref} menu improved.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5712 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5713
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5714 @noindent @b{Version 3.05}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5715 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5716 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5717 Compatibility code now first checks for XEmacs feature.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5718 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5719
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5720 @noindent @b{Version 3.04}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5721 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5722 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5723 Fixed BUG in the @emph{xr} support.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5724 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5725
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5726 @noindent @b{Version 3.03}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5727 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5728 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5729 Support for the LaTeX package @code{xr}, for inter-document
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5730 references.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5731 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5732 A few (minor) Mule-related changes.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5733 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5734 Fixed bug which could cause @emph{huge} @file{.rel} files.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5735 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5736 Search for input and @file{.bib} files with recursive path definitions.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5737 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5738
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5739 @noindent @b{Version 3.00}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5740 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5741 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5742 @b{Ref@TeX{}} should work better for very large projects:
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5743 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5744 The new parser works without creating a master buffer.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5745 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5746 Rescanning can be limited to a part of a multifile document.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5747 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5748 Information from the parser can be stored in a file.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5749 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5750 @b{Ref@TeX{}} can deal with macros having a naked label as an argument.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5751 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5752 Macros may have white space and newlines between arguments.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5753 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5754 Multiple identical section headings no longer confuse
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5755 @code{reftex-toc}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5756 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5757 @b{Ref@TeX{}} should work correctly in combination with buffer-altering
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5758 packages like outline, folding, x-symbol, iso-cvt, isotex, etc.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5759 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5760 All labeled environments discussed in @emph{The LaTeX Companion} by
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5761 Goossens, Mittelbach & Samarin, Addison-Wesley 1994) are part of
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5762 @b{Ref@TeX{}}'s defaults.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5763 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5764
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5765 @noindent @b{Version 2.17}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5766 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5767 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5768 Label prefix expands % escapes with current file name and other stuff.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5769 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5770 Citation format now with % escapes. This is not backward
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5771 compatible!
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5772 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5773 TEXINPUTS variable recognized when looking for input files.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5774 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5775 Context can be the nth argument of a macro.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5776 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5777 Searching in the select buffer is now possible (@kbd{C-s} and
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5778 @kbd{C-r}).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5779 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5780 Display and derive-label can use two different context methods.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5781 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5782 AMSmath @code{xalignat} and @code{xxalignat} added.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5783 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5784
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5785 @noindent @b{Version 2.14}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5786 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5787 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5788 Variable @code{reftex-plug-into-AUCTeX} simplifies cooperation with
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5789 AUCTeX.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5790 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5791
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5792 @noindent @b{Version 2.11}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5793 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5794 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5795 Submitted for inclusion to Emacs and XEmacs.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5796 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5797
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5798 @noindent @b{Version 2.07}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5799 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5800 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5801 New functions @code{reftex-search-document},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5802 @code{reftex-query-replace-document}.
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5803 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5804
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5805 @noindent @b{Version 2.05}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5806 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5807 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5808 Support for @file{custom.el}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5809 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5810 New function @code{reftex-grep-document} (thanks to Stephen Eglen).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5811 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5812
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5813 @noindent @b{Version 2.03}
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5814 @itemize @bullet
Dave Love <fx@gnu.org>
parents:
diff changeset
5815 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5816 @code{figure*}, @code{table*}, @code{sidewaysfigure/table} added to
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5817 default environments.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5818 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5819 @code{reftex-bibfile-ignore-list} introduced (thanks to Rory Molinari).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5820 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5821 New functions @code{reftex-arg-label}, @code{reftex-arg-ref},
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5822 @code{reftex-arg-cite}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5823 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5824 Emacs/XEmacs compatibility reworked. XEmacs 19.15 now is
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5825 required.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5826 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5827 @code{reftex-add-to-label-alist} (to be called from AUCTeX style
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5828 files).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5829 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5830 Finding context with a hook function.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5831 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5832 Sorting BibTeX entries (new variable:
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5833 @code{reftex-sort-bibtex-matches}).
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5834 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5835
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5836 @noindent @b{Version 2.00}
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5837 @itemize @bullet
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5838 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5839 Labels can be derived from context (default for sections).
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5840 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5841 Configuration of label insertion and label referencing revised.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5842 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5843 Crossref fields in BibTeX database entries.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5844 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5845 @code{reftex-toc} introduced (thanks to Stephen Eglen).
26911
d7f536a01276 Update to reftex 4.9
Carsten Dominik <dominik@science.uva.nl>
parents: 25829
diff changeset
5846 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5847
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5848 @noindent @b{Version 1.09}
27195
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
5849 @itemize @bullet
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
5850 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5851 Support for @code{tex-main-file}, an analogue for
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5852 @code{TeX-master}.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5853 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5854 MS-DOS support.
27195
d7311a9cb223 version 4.10
Carsten Dominik <dominik@science.uva.nl>
parents: 26911
diff changeset
5855 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5856
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5857 @noindent @b{Version 1.07}
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
5858 @itemize @bullet
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
5859 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5860 @b{Ref@TeX{}} gets its own menu.
29772
265fdb06f294 Update to reftex 4 14
Carsten Dominik <dominik@science.uva.nl>
parents: 29713
diff changeset
5861 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5862
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5863 @noindent @b{Version 1.05}
34403
6679ef9b33fe RefTeX 4.15 update
Carsten Dominik <dominik@science.uva.nl>
parents: 30009
diff changeset
5864 @itemize @bullet
6679ef9b33fe RefTeX 4.15 update
Carsten Dominik <dominik@science.uva.nl>
parents: 30009
diff changeset
5865 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5866 XEmacs port.
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5867 @end itemize
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5868
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5869 @noindent @b{Version 1.04}
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5870 @itemize @bullet
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5871 @item
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5872 Macros as wrappers, AMSTeX support, delayed context parsing for
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5873 new labels.
34403
6679ef9b33fe RefTeX 4.15 update
Carsten Dominik <dominik@science.uva.nl>
parents: 30009
diff changeset
5874 @end itemize
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
5875 @end ignore
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5876
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5877 @noindent @b{Version 1.00}
46684
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
5878 @itemize @bullet
9569bac241a3 Update to RefTeX 4.18
Carsten Dominik <dominik@science.uva.nl>
parents: 46272
diff changeset
5879 @item
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5880 released on 7 Jan 1997.
47050
904fd28be439 Update to RefTeX 4.19
Carsten Dominik <dominik@science.uva.nl>
parents: 46918
diff changeset
5881 @end itemize
59536
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5882
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5883
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5884
bf2af98cd2b4 version 4.26
Carsten Dominik <dominik@science.uva.nl>
parents: 58872
diff changeset
5885
25829
Dave Love <fx@gnu.org>
parents:
diff changeset
5886
Dave Love <fx@gnu.org>
parents:
diff changeset
5887 @node Index, , , Top
Dave Love <fx@gnu.org>
parents:
diff changeset
5888 @unnumbered Index
Dave Love <fx@gnu.org>
parents:
diff changeset
5889 @printindex cp
Dave Love <fx@gnu.org>
parents:
diff changeset
5890
Dave Love <fx@gnu.org>
parents:
diff changeset
5891 @summarycontents
Dave Love <fx@gnu.org>
parents:
diff changeset
5892 @contents
Dave Love <fx@gnu.org>
parents:
diff changeset
5893 @bye
Dave Love <fx@gnu.org>
parents:
diff changeset
5894
59548
83df5808ec6b Changes from arch/CVS synchronization
Miles Bader <miles@gnu.org>
parents: 59538
diff changeset
5895 @ignore
83df5808ec6b Changes from arch/CVS synchronization
Miles Bader <miles@gnu.org>
parents: 59538
diff changeset
5896 arch-tag: 1e055774-0576-4b1b-b47f-550d0961fd43
83df5808ec6b Changes from arch/CVS synchronization
Miles Bader <miles@gnu.org>
parents: 59538
diff changeset
5897 @end ignore