1 This is the CHANGES file of the RefTeX distribution, version 4.19
3 Here are the more important changes made to RefTeX since initial release.
4 Minor bug fixes are not mentioned.
7 - New command reftex-toc-recenter (C-c -) which shows the current
8 section in the TOC buffer without selecting the TOC window.
9 - recentering happens automatically in idle time when the option
10 `reftex-auto-recenter-toc' is turned on.
11 - Fixed several bugs related to cursor positioning in the TOC
13 - The highlight in the TOC buffer stays when the focus moves to a
15 - New command `reftex-goto-label'.
16 - Part numbers are no longer included in chapter numbers, and a new
17 part does not reset the chapter counter. See new option
18 `reftex-part-resets-chapter'.
21 - `reftex-citation' uses the word before the cursor as a default
23 - simplified several regular expressions for speed.
24 - Better support for chapterbib. Different chapters can now use
25 BibTeX or an explicit `thebibliography' environment.
28 - The toc window can be split off horizontally. See new options
29 `reftex-toc-split-windows-horizontally',
30 `reftex-toc-split-windows-horizontally-fraction'.
31 - It is possible to specify a function which verifies an index match
32 during global indexing. See new option
33 `reftex-index-verify-function'.
34 - The macros which input a file in LaTeX (like \input, \include) can
35 be configured. See new option `reftex-include-file-commands'.
36 - The macros which specify the bibliography file (like
37 \bibliography) can be configured. See new option
38 `reftex-bibliography-commands'.
39 - The regular expression used to search for the \bibliography macro
40 has been relaxed to allow for `{\bibliography{...}}' needed by
45 - Bug fix in reftex-create-tags-file.
46 - Better interaction with Emacs LaTeX mode.
49 - Ensure write access to all files before doing global label replace.
50 - Fixed bug which would parse \partial as \part.
53 - Support for `bibentry' citation package.
56 - Fixed bug which would parse \Section as \section.
59 - Renamed `reftex-vcr.el' to `reftex-dcr.el' because of conflict
60 with `reftex-vars.el' on DOS machines.
61 - New options `reftex-parse-file-extension' and
62 `reftex-index-phrase-file-extension'.
65 - RefTeX maintaines an "Index Phrases" file in which phrases can be
66 collected. When the document is ready, RefTeX can search all
67 these phrases and assist indexing all matches.
68 - The variables `reftex-index-macros' and
69 `reftex-index-default-macro' have changed their syntax slightly.
70 The "repeat" parameter has move from the latter to the former.
71 Also calls to `reftex-add-index-macros' from AUCTeX style files
73 - The variable `reftex-section-levels' no longer contains the
74 default stuff which has been moved to a constant.
75 - Environments like theorems can be placed into the TOC by putting
76 entries for "begin{theorem}" in `reftex-setion-levels'.
78 - New option `reftex-toc-max-level' to limit the depth of the toc.
79 The `t' key in the *toc* and *RefTeX Select* buffers also changes
82 - `reftex-section-levels' can now also contain functions to compute
84 - Multiple `thebibliography' environments recognized.
86 - New option `reftex-index-default-tag' implements a default for queries.
88 - macros ending in `refrange' are considered to contain references.
89 - Index entries made with `reftex-index-selection-or-word' in TeX
90 math mode automatically get enclosing `$' to preserve math mode.
91 See new option `reftex-index-math-format'. Requires AUCTeX.
93 - New command `reftex-index-globally' to index a word in many
94 places in the document. Also available from the index buffer with
96 - The first item in a @code{reftex-label-alist} entry may now also
97 be a parser function to do non-standard parsing.
98 - `reftex-auto-view-crossref' no longer interferes with
101 Many changes - too much to document them in detail here. In summary:
102 - RefTeX has been split into 11 smaller lisp files.
103 - Index support, along with many new user options.
104 - The selection of keys for `\ref' and `\cite' now allows to
105 select multiple items by marking entries with the `m' key.
106 - fancyref.sty support.
108 - `reftex-view-crossref' no longer moves to find a macro.
109 - Bug fix for XEmacs selection process.
111 - New value `window' for option `reftex-auto-view-crossref'.
113 - ISO 8859 Latin-1 chars are converted to ASCII to derive better labels.
114 This takes back the related changes in 3.34 for safety reasons.
115 - Fixed bug with non-existing string-width function in XEmacs.
117 - Additional flag in `reftex-derive-label-parameters' to make only
118 lowercase labels (default t).
119 - All .rel files have a final newline to avoid queries.
120 - Single byte representations of accented European letters (ISO-8859-1)
121 are legal in labels. However, general Mule characters are not.
123 - Multiple Selection Buffers are now hidden (names start with a space).
124 - Fixed bug with file search when TEXINPUTS was empty.
126 - In `reftex-citation', the regexp can be completed on known cite keys.
127 - New keys `a' and `A' in bib selection process to cite all entries.
128 - New command `reftex-renumber-simple-labels' to renumber `eq:13' etc.
130 - Auto view crossref for XEmacs uses post-command-hook to restart the
131 timer, since itimer restart is not reliable.
132 - Option `reftex-bibfile-ignore-list' renamed to `-regexps'.
133 - Expansion of recursive tex and bib path rewritten.
135 - Macros can define "neutral" labels, just like \label{} itself.
136 - New option `reftex-allow-detached-macro-args', default nil!
138 - [X]Emacs 19 support dropped. Use 3.22 for them.
139 - New hooks `reftex-translate-to-ascii-function',
140 `reftex-string-to-label-function'.
142 - Echoing of citation info caches the info for displayed entries.
143 New option `reftex-cache-cite-echo'.
144 - `M-x reftex-reset-mode' now also removes the file with parsing info.
145 - Default of `reftex-revisit-to-follow' changed to nil.
147 - New option `reftex-revisit-to-echo'.
148 - Interface with X-Symbol (>=2.6) is now complete and stable.
149 - Adapted to new outline, which uses overlays.
151 - Parse files MASTER.rel made compatible between Emacs and XEmacs.
152 - `kill-emacs-hook' and `kill-buffer-hook' now write the parse file.
153 - The cursor inside a \ref or \cite macro now triggers automatic
154 display of crossref information in the echo area. See variable
155 `reftex-auto-view-crossref'.
156 - AUCTeX interface updates:
157 - AUCTeX 9.9c and later notifies RefTeX about new sections.
158 - RefTeX notifies AUCTeX about new labels.
159 - TeX-arg-ref no longer used (introduction was unnecessary).
160 - `reftex-arg-label' and `reftex-arg-cite' fixed up.
161 - Settings added to RefTeX via style files remain local.
163 - `reftex-mouse-view-crossref' is now bound by default at `S-mouse-2'
164 - THIS VERSION IS RECOMMENDED FOR X/EMACS 19.
166 - New options for all faces used by RefTeX. They're in the
167 customization group `reftex-fontification-configurations'.
169 - The selection now uses a recursive edit, much like minibuffer input.
170 This removes all restrictions during selection. E.g. you can now
171 switch buffers at will, use the mouse etc.
172 - New option `reftex-highlight-selection'.
173 - Mouse-2 can be used to select in selection and *toc* buffers.
174 - Fixed some problems regarding the interaction with VIPER mode.
175 - Follow-mode is now only used after point motion.
176 - RefTeX now finally does not fontify temporary files anymore!
178 - Additional bindings in selection and *toc* buffers. `g' redefined.
179 - New command `reftex-save-all-document-buffers'.
180 - Magic word matching made more intelligent.
181 - Selection process can switch to completion (with TAB).
182 - \appendix is now recognized and influences section numbering.
183 - File commentary shortened considerably (use Info documentation).
184 - New option `reftex-no-include-regexps' to skip some include files.
185 - New option `reftex-revisit-to-follow'.
187 - New hooks `reftex-format-label-function', `reftex-format-ref-function',
188 `reftex-format-cite-function'.
189 - TeXInfo documentation completed.
190 - New variable `reftex-default-bibliography'.
192 - Selection buffers can be kept between selections: this is faster.
193 See new variable `reftex-use-multiple-selection-buffers'.
194 - Prefix interpretation of reftex-view-crossref changed.
195 - Support for the `varioref' package (`v' key in selection buffer).
197 - There are 3 new keymaps for customization: `reftex-toc-map',
198 `reftex-select-label-map', `reftex-select-bib-map'.
199 - Refontification uses more standard font-lock stuff.
200 - When no BibTeX database files are specified, citations can also
201 use \bibitem entries from a `thebibliography' environment.
203 - Support for the LaTeX package `xr', for inter-document references.
204 - A few (minor) Mule-related changes.
205 - Fixed bug which could cause HUGE .rel files.
206 - Search for input and .bib files with recursive path definitions.
208 - RefTeX should work better for very large projects:
209 - The new parser works without creating a master buffer.
210 - Rescanning can be limited to a part of a multifile document.
211 - Information from the parser can be stored in a file.
212 - RefTeX can deal with macros having a naked label as an argument.
213 - Macros may have white space and newlines between arguments.
214 - Multiple identical section headings no longer confuse `reftex-toc'.
215 - RefTeX should work correctly in combination with buffer-altering
216 packages like outline, folding, x-symbol, iso-cvt, isotex, etc.
217 - All labeled environments discussed in `The LaTeX Companion' by
218 Goossens, Mittelbach & Samarin, Addison-Wesley 1994) are part of
221 - Label prefix expands % escapes with current file name and other stuff.
222 - Citation format now with % escapes. This is not backward compatible!
223 - TEXINPUTS variable recognized when looking for input files.
224 - Context can be the nth argument of a macro.
225 - Searching in the select buffer is now possible (C-s and C-r).
226 - Display and derive-label can use two different context methods.
227 - AMSmath xalignat and xxalignat added.
229 - Variable `reftex-plug-into-AUCTeX' simplifies cooperation with AUCTeX.
231 - Submitted for inclusion to Emacs and XEmacs.
233 - New functions `reftex-search-document', `reftex-query-replace-document'
235 - Support for `custom.el'.
236 - New function `reftex-grep-document' (thanks to Stephen Eglen).
238 - Figure*, table*, Sidewaysfigure/table added to default environments.
239 - `reftex-bibfile-ignore-list' introduced (thanks to Rory Molinari).
240 - New functions `reftex-arg-label', `reftex-arg-ref', `reftex-arg-cite'.
241 - Emacs/XEmacs compatibility reworked. XEmacs 19.15 now is required.
242 - `reftex-add-to-label-alist' (to be called from AUCTeX style files).
243 - Finding context with a hook function.
244 - Sorting BibTeX entries (new variable: `reftex-sort-bibtex-matches').
246 - Labels can be derived from context (default for sections).
247 - Configuration of label insertion and label referencing revised.
248 - Crossref fields in BibTeX database entries.
249 - `reftex-toc' introduced (thanks to Stephen Eglen).
251 - Support for `tex-main-file', an analogue for `TeX-master'.
254 - RefTeX gets its own menu.
258 - Macros as wrappers, AMSTeX support, delayed context parsing for
261 - released on 7 Jan 1997.