* etc/TODO: Remove refs to obsolete files.

[bpt/emacs.git] / doc / misc / reftex.texi

diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi
index 15bb2c4..99266de 100644 (file)
--- a/doc/misc/reftex.texi
+++ b/doc/misc/reftex.texi
@@ -2,6 +2,7 @@
 @c %**start of header
 @setfilename ../../info/reftex
 @settitle RefTeX User Manual
 @c %**start of header
 @setfilename ../../info/reftex
 @settitle RefTeX User Manual

+@documentencoding UTF-8

 @synindex ky cp
 @syncodeindex vr cp
 @syncodeindex fn cp
 @synindex ky cp
 @syncodeindex vr cp
 @syncodeindex fn cp


@@ -45,7 +46,7 @@ This manual documents @RefTeX{} (version @value{VERSION}), a package
 to do labels, references, citations and indices for LaTeX documents
 with Emacs.
 
 to do labels, references, citations and indices for LaTeX documents
 with Emacs.
 

-Copyright @copyright{} 1997--2013 Free Software Foundation, Inc.
+Copyright @copyright{} 1997--2014 Free Software Foundation, Inc.

 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document


@@ -95,9 +96,11 @@ modify this GNU manual.''
 @contents
 
 @ifnottex
 @contents
 
 @ifnottex

-@node Top,,,(dir)
+@node Top

 @top @RefTeX{}
 
 @top @RefTeX{}
 

+@insertcopying
+

 @RefTeX{} is a package for managing Labels, References, Citations and
 index entries with GNU Emacs.
 
 @RefTeX{} is a package for managing Labels, References, Citations and
 index entries with GNU Emacs.
 


@@ -123,14 +126,13 @@ other parts of this document when needed.
 * Multifile Documents::              Document spread over many files.
 * Language Support::                 How to support other languages.
 * Finding Files::                    Included @TeX{} files and @BibTeX{} .bib files.
 * Multifile Documents::              Document spread over many files.
 * Language Support::                 How to support other languages.
 * Finding Files::                    Included @TeX{} files and @BibTeX{} .bib files.

-* AUCTeX::                           Cooperation with @AUCTeX{}.

 * Optimizations::                    When RefTeX is too slow.
 * Optimizations::                    When RefTeX is too slow.

+* AUCTeX::                           Cooperation with @AUCTeX{}.

 * Problems and Work-Arounds::        First Aid.
 * Imprint::                          Author, Web-site, Thanks
 
 * Commands::                         Which are the available commands.
 * Options::                          How to extend and configure RefTeX.
 * Problems and Work-Arounds::        First Aid.
 * Imprint::                          Author, Web-site, Thanks
 
 * Commands::                         Which are the available commands.
 * Options::                          How to extend and configure RefTeX.

-* Keymaps and Hooks::                For customization.

 * Changes::                          A List of recent changes to RefTeX.
 * GNU Free Documentation License::   The license for this documentation.
 
 * Changes::                          A List of recent changes to RefTeX.
 * GNU Free Documentation License::   The license for this documentation.
 


@@ -154,7 +156,7 @@ Labels and References
 * Defining Label Environments::        ... and environments it doesn't.
 * Reference Info::                   View the label corresponding to a \ref.
 * Reference Styles::                 Macros to be used instead of \ref.
 * Defining Label Environments::        ... and environments it doesn't.
 * Reference Info::                   View the label corresponding to a \ref.
 * Reference Styles::                 Macros to be used instead of \ref.

-* xr (LaTeX package)::               References to external documents.
+* LaTeX xr Package::                 References to external documents.

 
 Defining Label Environments
 
 
 Defining Label Environments
 


@@ -197,24 +199,24 @@ AUCTeX
 
 Options, Keymaps, Hooks
 
 
 Options, Keymaps, Hooks
 

-* Options (Table of Contents)::
-* Options (Defining Label Environments)::
-* Options (Creating Labels)::
-* Options (Referencing Labels)::
-* Options (Creating Citations)::
-* Options (Index Support)::
-* Options (Viewing Cross-References)::
-* Options (Finding Files)::
-* Options (Optimizations)::
-* Options (Fontification)::
-* Options (Misc)::
+* Options - Table of Contents::
+* Options - Defining Label Environments::
+* Options - Creating Labels::
+* Options - Referencing Labels::
+* Options - Creating Citations::
+* Options - Index Support::
+* Options - Viewing Cross-References::
+* Options - Finding Files::
+* Options - Optimizations::
+* Options - Fontification::
+* Options - Misc::

 
 @end detailmenu
 @end menu
 
 @end ifnottex
 
 
 @end detailmenu
 @end menu
 
 @end ifnottex
 

-@node Introduction, Table of Contents, , Top
+@node Introduction

 @chapter Introduction
 @cindex Introduction
 
 @chapter Introduction
 @cindex Introduction
 


@@ -242,7 +244,7 @@ reports or suggestions.
 * RefTeX in a Nutshell::             A brief summary and quick guide.
 @end menu
 
 * RefTeX in a Nutshell::             A brief summary and quick guide.
 @end menu
 

-@node Installation, RefTeX in a Nutshell, , Introduction
+@node Installation

 @section Installation
 @cindex Installation
 
 @section Installation
 @cindex Installation
 


@@ -360,7 +362,7 @@ systems these variables do not contain the full search path.  If
 @xref{Finding Files}.
 
 @page
 @xref{Finding Files}.
 
 @page

-@node RefTeX in a Nutshell, , Installation, Introduction
+@node RefTeX in a Nutshell

 @section @RefTeX{} in a Nutshell
 @cindex Quick-Start
 @cindex Getting Started
 @section @RefTeX{} in a Nutshell
 @cindex Quick-Start
 @cindex Getting Started


@@ -516,7 +518,7 @@ a tutorial way how to use and customize @RefTeX{}.  The second
 part is a command and variable reference.
 @end enumerate
 
 part is a command and variable reference.
 @end enumerate
 

-@node Table of Contents, Labels and References, Introduction, Top
+@node Table of Contents

 @chapter Table of Contents
 @cindex @file{*toc*} buffer
 @cindex Structure editing
 @chapter Table of Contents
 @cindex @file{*toc*} buffer
 @cindex Structure editing


@@ -582,8 +584,8 @@ called.
 @item mouse-2
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a line has the same effect as @key{RET}.
 @item mouse-2
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a line has the same effect as @key{RET}.

-See also variable @code{reftex-highlight-selection}, @ref{Options
-(Fontification)}.
+See also variable @code{reftex-highlight-selection},
+@ref{Options - Fontification}.

 
 @item f
 @vindex reftex-toc-follow-mode
 
 @item f
 @vindex reftex-toc-follow-mode


@@ -702,9 +704,8 @@ buffer.
 
 @item x
 Switch to the @file{*toc*} buffer of an external document.  When the
 
 @item x
 Switch to the @file{*toc*} buffer of an external document.  When the

-current document is using the @code{xr} package (@pxref{xr (LaTeX
-package)}), @RefTeX{} will switch to one of the external
-documents.
+current document is using the @code{xr} package (@pxref{LaTeX xr Package}),
+@RefTeX{} will switch to one of the external documents.

 
 
 @tablesubheading{Automatic recentering}
 
 
 @tablesubheading{Automatic recentering}


@@ -765,7 +766,7 @@ environments to the table of contents.  This is probably only useful for
 theorem-like environments. @xref{Defining Label Environments}, for an
 example.
 
 theorem-like environments. @xref{Defining Label Environments}, for an
 example.
 

-@node Labels and References, Citations, Table of Contents, Top
+@node Labels and References

 @chapter Labels and References
 @cindex Labels in LaTeX
 @cindex References in LaTeX
 @chapter Labels and References
 @cindex Labels in LaTeX
 @cindex References in LaTeX


@@ -797,10 +798,10 @@ equation counter.
 * Defining Label Environments::        ... and environments it doesn't.
 * Reference Info::                   View the label corresponding to a \ref.
 * Reference Styles::                 Macros to be used instead of \ref.
 * Defining Label Environments::        ... and environments it doesn't.
 * Reference Info::                   View the label corresponding to a \ref.
 * Reference Styles::                 Macros to be used instead of \ref.

-* xr (LaTeX package)::               References to external documents.
+* LaTeX xr Package::                 References to external documents.

 @end menu
 
 @end menu
 

-@node Creating Labels, Referencing Labels, , Labels and References
+@node Creating Labels

 @section Creating Labels
 @cindex Creating labels
 @cindex Labels, creating
 @section Creating Labels
 @cindex Creating labels
 @cindex Labels, creating


@@ -860,14 +861,14 @@ this label later.
 
 @vindex reftex-insert-label-flags
 If you want to change the way certain labels are created, check out the
 
 @vindex reftex-insert-label-flags
 If you want to change the way certain labels are created, check out the

-variable @code{reftex-insert-label-flags} (@pxref{Options (Creating
-Labels)}).
+variable @code{reftex-insert-label-flags} (@pxref{Options - Creating
+Labels}).

 
 If you are using @AUCTeX{} to write your @LaTeX{} documents, you can
 set it up to delegate the creation of labels to
 @RefTeX{}. @xref{AUCTeX}, for more information.
 
 
 If you are using @AUCTeX{} to write your @LaTeX{} documents, you can
 set it up to delegate the creation of labels to
 @RefTeX{}. @xref{AUCTeX}, for more information.
 

-@node Referencing Labels, Builtin Label Environments, Creating Labels, Labels and References
+@node Referencing Labels

 @section Referencing Labels
 @cindex Referencing labels
 @cindex Labels, referencing
 @section Referencing Labels
 @cindex Referencing labels
 @cindex Labels, referencing


@@ -982,7 +983,7 @@ references all marked labels.
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a label will accept it like @key{RET}
 would.  See also variable @code{reftex-highlight-selection},
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a label will accept it like @key{RET}
 would.  See also variable @code{reftex-highlight-selection},

-@ref{Options (Misc)}.
+@ref{Options - Misc}.

 
 @vindex reftex-multiref-punctuation
 @item m - + ,
 
 @vindex reftex-multiref-punctuation
 @item m - + ,


@@ -1035,7 +1036,7 @@ buffer.
 @tablesubheading{Controlling what gets displayed}
 @vindex reftex-label-menu-flags
 The defaults for the following flags can be configured with the variable
 @tablesubheading{Controlling what gets displayed}
 @vindex reftex-label-menu-flags
 The defaults for the following flags can be configured with the variable

-@code{reftex-label-menu-flags} (@pxref{Options (Referencing Labels)}).
+@code{reftex-label-menu-flags} (@pxref{Options - Referencing Labels}).

 
 @item c
 Toggle the display of the one-line label definition context in the
 
 @item c
 Toggle the display of the one-line label definition context in the


@@ -1083,8 +1084,7 @@ a menu for that category will be shown.
 Reference a label from an external document.  With the @LaTeX{} package
 @code{xr} it is possible to reference labels defined in another
 document.  This key will switch to the label menu of an external
 Reference a label from an external document.  With the @LaTeX{} package
 @code{xr} it is possible to reference labels defined in another
 document.  This key will switch to the label menu of an external

-document and let you select a label from there (@pxref{xr (LaTeX
-package),,xr}).
+document and let you select a label from there (@pxref{LaTeX xr Package,,xr}).

 
 @end table
 
 
 @end table
 


@@ -1092,7 +1092,7 @@ package),,xr}).
 In order to define additional commands for the selection process, the
 keymap @code{reftex-select-label-map} may be used.
 
 In order to define additional commands for the selection process, the
 keymap @code{reftex-select-label-map} may be used.
 

-@node Builtin Label Environments, Defining Label Environments, Referencing Labels, Labels and References
+@node Builtin Label Environments

 @section Builtin Label Environments
 @cindex Builtin label environments
 @cindex Label environments, builtin
 @section Builtin Label Environments
 @cindex Builtin label environments
 @cindex Label environments, builtin


@@ -1197,15 +1197,15 @@ If you want to use other labeled environments, defined with
 @code{\newtheorem}, @RefTeX{} needs to be configured to recognize
 them (@pxref{Defining Label Environments}).
 
 @code{\newtheorem}, @RefTeX{} needs to be configured to recognize
 them (@pxref{Defining Label Environments}).
 

-@node Defining Label Environments, Reference Info, Builtin Label Environments, Labels and References
+@node Defining Label Environments

 @section Defining Label Environments
 @cindex Label environments, defining
 
 @vindex reftex-label-alist
 @RefTeX{} can be configured to recognize additional labeled
 environments and macros.  This is done with the variable
 @section Defining Label Environments
 @cindex Label environments, defining
 
 @vindex reftex-label-alist
 @RefTeX{} can be configured to recognize additional labeled
 environments and macros.  This is done with the variable

-@code{reftex-label-alist} (@pxref{Options (Defining Label
-Environments)}).  If you are not familiar with Lisp, you can use the
+@code{reftex-label-alist} (@pxref{Options - Defining Label
+Environments}).  If you are not familiar with Lisp, you can use the

 @code{custom} library to configure this rather complex variable.  To do
 this, use
 
 @code{custom} library to configure this rather complex variable.  To do
 this, use
 


@@ -1230,7 +1230,7 @@ Environments}).
 * Putting it Together::              How to combine many entries.
 @end menu
 
 * Putting it Together::              How to combine many entries.
 @end menu
 

-@node Theorem and Axiom, Quick Equation, , Defining Label Environments
+@node Theorem and Axiom

 @subsection Theorem and Axiom Environments
 @cindex @code{theorem}, newtheorem
 @cindex @code{axiom}, newtheorem
 @subsection Theorem and Axiom Environments
 @cindex @code{theorem}, newtheorem
 @cindex @code{axiom}, newtheorem


@@ -1303,8 +1303,7 @@ a @code{\macro} or after the @code{\begin} statement).  @code{t} is
 @code{nil} means to use the text right after the label definition.
 @item
 For more complex ways of getting context, see the variable
 @code{nil} means to use the text right after the label definition.
 @item
 For more complex ways of getting context, see the variable

-@code{reftex-label-alist} (@ref{Options (Defining Label
-Environments)}).
+@code{reftex-label-alist} (@ref{Options - Defining Label Environments}).

 @end itemize
 
 The following list of strings is used to guess the correct label type
 @end itemize
 
 The following list of strings is used to guess the correct label type


@@ -1357,12 +1356,11 @@ Reftex Label Alist: [Hide]
 Depending on how you would like the label insertion and selection for
 the new environments to work, you might want to add the letters @samp{a}
 and @samp{h} to some of the flags in the variables
 Depending on how you would like the label insertion and selection for
 the new environments to work, you might want to add the letters @samp{a}
 and @samp{h} to some of the flags in the variables

-@code{reftex-insert-label-flags} (@pxref{Options (Creating Labels)})
-and @code{reftex-label-menu-flags} (@pxref{Options (Referencing
-Labels)}).
+@code{reftex-insert-label-flags} (@pxref{Options - Creating Labels})
+and @code{reftex-label-menu-flags} (@pxref{Options - Referencing Labels}).

 
 
 
 

-@node Quick Equation, Figure Wrapper, Theorem and Axiom , Defining Label Environments
+@node Quick Equation

 @subsection Quick Equation Macro
 @cindex Quick equation macro
 @cindex Macros as environment wrappers
 @subsection Quick Equation Macro
 @cindex Quick equation macro
 @cindex Macros as environment wrappers


@@ -1410,7 +1408,7 @@ Reftex Label Alist: [Hide]
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 

-@node Figure Wrapper, Adding Magic Words, Quick Equation, Defining Label Environments
+@node Figure Wrapper

 @subsection Figure Wrapping Macro
 @cindex Macros as environment wrappers
 @cindex Figure wrapping macro
 @subsection Figure Wrapping Macro
 @cindex Macros as environment wrappers
 @cindex Figure wrapping macro


@@ -1470,7 +1468,7 @@ Again, here the configuration in the customization buffer:
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 

-@node Adding Magic Words, Using \eqref, Figure Wrapper, Defining Label Environments
+@node Adding Magic Words

 @subsection Adding Magic Words
 @cindex Magic words
 @cindex German magic words
 @subsection Adding Magic Words
 @cindex Magic words
 @cindex German magic words


@@ -1494,7 +1492,7 @@ predefined label categories.
     (nil ?i nil nil nil ("Punkt"))))
 @end lisp
 
     (nil ?i nil nil nil ("Punkt"))))
 @end lisp
 

-@node Using \eqref, Non-Standard Environments, Adding Magic Words, Defining Label Environments
+@node Using \eqref

 @subsection Using @code{\eqref}
 @cindex @code{\eqref}, AMS-LaTeX macro
 @cindex AMS-LaTeX
 @subsection Using @code{\eqref}
 @cindex @code{\eqref}, AMS-LaTeX macro
 @cindex AMS-LaTeX


@@ -1521,7 +1519,7 @@ Note that this is automatically done by the @file{amsmath.el} style file
 of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{},
 this configuration will not be necessary.
 
 of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{},
 this configuration will not be necessary.
 

-@node Non-Standard Environments, Putting it Together, Using \eqref, Defining Label Environments
+@node Non-Standard Environments

 @subsection Non-standard Environments
 @cindex Non-standard environments
 @cindex Environments without @code{\begin}
 @subsection Non-standard Environments
 @cindex Non-standard environments
 @cindex Environments without @code{\begin}


@@ -1622,7 +1620,7 @@ for @RefTeX{}.
             (incf cnt))))))))
 @end lisp
 
             (incf cnt))))))))
 @end lisp
 

-@node Putting it Together, , Non-Standard Environments, Defining Label Environments
+@node Putting it Together

 @subsection Putting it all together
 
 When you have to put several entries into @code{reftex-label-alist}, just
 @subsection Putting it all together
 
 When you have to put several entries into @code{reftex-label-alist}, just


@@ -1640,7 +1638,7 @@ the entries described above:
     (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex."))))
 @end lisp
 
     (detect-linguex ?x "ex:" "~\\ref@{%s@}" nil ("Example" "Ex."))))
 @end lisp
 

-@node Reference Info, Reference Styles, Defining Label Environments, Labels and References
+@node Reference Info

 @section Reference Info
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref
 @section Reference Info
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref


@@ -1662,7 +1660,7 @@ message.
 @code{\label} macro.  @xref{Viewing Cross-References}, for more
 information.
 
 @code{\label} macro.  @xref{Viewing Cross-References}, for more
 information.
 

-@node Reference Styles, xr (LaTeX package), Reference Info, Labels and References
+@node Reference Styles

 @section Reference Styles
 
 In case you defined your own macros for referencing or you are using
 @section Reference Styles
 
 In case you defined your own macros for referencing or you are using


@@ -1750,7 +1748,7 @@ and @code{reftex-fref-is-default} respectively.  While still working,
 these variables are deprecated now.  Instead of setting them, the
 variable @code{reftex-ref-style-default-list} should be adapted now.
 
 these variables are deprecated now.  Instead of setting them, the
 variable @code{reftex-ref-style-default-list} should be adapted now.
 

-@node xr (LaTeX package), , Reference Styles, Labels and References
+@node LaTeX xr Package

 @section @code{xr}: Cross-Document References
 @cindex @code{xr}, LaTeX package
 @cindex LaTeX packages, @code{xr}
 @section @code{xr}: Cross-Document References
 @cindex @code{xr}, LaTeX package
 @cindex LaTeX packages, @code{xr}


@@ -1785,7 +1783,7 @@ For this kind of inter-document cross-references, saving of parsing
 information and the use of multiple selection buffers can mean a large
 speed-up (@pxref{Optimizations}).
 
 information and the use of multiple selection buffers can mean a large
 speed-up (@pxref{Optimizations}).
 

-@node Citations, Index Support, Labels and References, Top
+@node Citations

 @chapter Citations
 @cindex Citations
 @cindex @code{\cite}
 @chapter Citations
 @cindex Citations
 @cindex @code{\cite}


@@ -1805,7 +1803,7 @@ support for citations helps to select the correct key quickly.
 * BibTeX Database Subsets::          Extract parts of a big database.
 @end menu
 
 * BibTeX Database Subsets::          Extract parts of a big database.
 @end menu
 

-@node Creating Citations, Citation Styles, , Citations
+@node Creating Citations

 @section Creating Citations
 @cindex Creating citations
 @cindex Citations, creating
 @section Creating Citations
 @cindex Creating citations
 @cindex Citations, creating


@@ -1884,8 +1882,8 @@ which the selection process was started.
 @item mouse-2
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a citation will accept it like @key{RET}
 @item mouse-2
 @vindex reftex-highlight-selection
 Clicking with mouse button 2 on a citation will accept it like @key{RET}

-would.  See also variable @code{reftex-highlight-selection}, @ref{Options
-(Misc)}.
+would.  See also variable @code{reftex-highlight-selection},
+@ref{Options - Misc}.

 
 @item m
 Mark the current entry.  When one or several entries are marked,
 
 @item m
 Mark the current entry.  When one or several entries are marked,


@@ -1955,7 +1953,7 @@ buffers by adding the following expression to your init file:
 @end lisp
 
 
 @end lisp
 
 

-@node Citation Styles, Citation Info, Creating Citations, Citations
+@node Citation Styles

 @section Citation Styles
 @cindex Citation styles
 @cindex Citation styles, @code{natbib}
 @section Citation Styles
 @cindex Citation styles
 @cindex Citation styles, @code{natbib}


@@ -2020,7 +2018,7 @@ citation style based on the @code{usepackage} commands in a given
 document.  @xref{Style Files}, for information on how to set up the style
 files correctly.
 
 document.  @xref{Style Files}, for information on how to set up the style
 files correctly.
 

-@node Citation Info, Chapterbib and Bibunits, Citation Styles, Citations
+@node Citation Info

 @section Citation Info
 @cindex Displaying citations
 @cindex Citations, displaying
 @section Citation Info
 @cindex Displaying citations
 @cindex Citations, displaying


@@ -2041,7 +2039,7 @@ entry corresponding to a @code{\cite} macro, or all citation locations
 corresponding to a @code{\bibitem} or @BibTeX{} database entry.
 @xref{Viewing Cross-References}.
 
 corresponding to a @code{\bibitem} or @BibTeX{} database entry.
 @xref{Viewing Cross-References}.
 

-@node Chapterbib and Bibunits, Citations Outside LaTeX, Citation Info, Citations
+@node Chapterbib and Bibunits

 @section Chapterbib and Bibunits
 @cindex @code{chapterbib}, LaTeX package
 @cindex @code{bibunits}, LaTeX package
 @section Chapterbib and Bibunits
 @cindex @code{chapterbib}, LaTeX package
 @cindex @code{bibunits}, LaTeX package


@@ -2056,7 +2054,7 @@ separate file (as it is required for @code{chapterbib} anyway).  Then
 you have multiple bibliographies within a @emph{single file}, this may
 or may not be the case.
 
 you have multiple bibliographies within a @emph{single file}, this may
 or may not be the case.
 

-@node Citations Outside LaTeX, BibTeX Database Subsets, Chapterbib and Bibunits, Citations
+@node Citations Outside LaTeX

 @section Citations outside @LaTeX{}
 @cindex Citations outside LaTeX
 @vindex reftex-default-bibliography
 @section Citations outside @LaTeX{}
 @cindex Citations outside LaTeX
 @vindex reftex-default-bibliography


@@ -2081,7 +2079,7 @@ binding for @code{reftex-cite-format}.
                            (reftex-citation))))))
 @end lisp
 
                            (reftex-citation))))))
 @end lisp
 

-@node BibTeX Database Subsets, , Citations Outside LaTeX, Citations
+@node BibTeX Database Subsets

 @section Database Subsets
 @cindex BibTeX database subsets
 @findex reftex-create-bibtex-file
 @section Database Subsets
 @cindex BibTeX database subsets
 @findex reftex-create-bibtex-file


@@ -2109,7 +2107,7 @@ entries in the selection buffer with the @kbd{m} key and then export
 either the @i{marked} entries (with the @kbd{e} key) or the
 @i{unmarked} entries (with the @kbd{E} key).
 
 either the @i{marked} entries (with the @kbd{e} key) or the
 @i{unmarked} entries (with the @kbd{E} key).
 

-@node Index Support, Viewing Cross-References, Citations, Top
+@node Index Support

 @chapter Index Support
 @cindex Index Support
 @cindex @code{\index}
 @chapter Index Support
 @cindex Index Support
 @cindex @code{\index}


@@ -2176,7 +2174,7 @@ Style}), or globally for all your documents with
 * Defining Index Macros::                ... and macros it  doesn't.
 @end menu
 
 * Defining Index Macros::                ... and macros it  doesn't.
 @end menu
 

-@node Creating Index Entries, The Index Phrases File, , Index Support
+@node Creating Index Entries

 @section Creating Index Entries
 @cindex Creating index entries
 @cindex Index entries, creating
 @section Creating Index Entries
 @cindex Creating index entries
 @cindex Index entries, creating


@@ -2207,7 +2205,7 @@ index tag is a string identifying one of multiple indices.  With the
 @file{multind} and @file{index} packages, this tag is the first argument
 to the redefined @code{\index} macro.
 
 @file{multind} and @file{index} packages, this tag is the first argument
 to the redefined @code{\index} macro.
 

-@node The Index Phrases File, Displaying and Editing the Index, Creating Index Entries, Index Support
+@node The Index Phrases File

 @section The Index Phrases File
 @cindex Index phrase file
 @cindex Phrase file
 @section The Index Phrases File
 @cindex Index phrase file
 @cindex Phrase file


@@ -2255,7 +2253,7 @@ repeat @var{word} outside the macro.
 * Global Indexing::                  The interactive indexing process.
 @end menu
 
 * Global Indexing::                  The interactive indexing process.
 @end menu
 

-@node Collecting Phrases, Consistency Checks, , The Index Phrases File
+@node Collecting Phrases

 @subsection Collecting Phrases
 @cindex Collecting index phrases
 @cindex Index phrases, collection
 @subsection Collecting Phrases
 @cindex Collecting index phrases
 @cindex Index phrases, collection


@@ -2321,7 +2319,7 @@ Finally, every occurrence of @samp{Pluto} will be indexed as
 @samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto}
 and will therefore create two different index entries.
 
 @samp{\index@{Planets!Pluto@}\index@{Kuiper Belt Objects!Pluto@}Pluto}
 and will therefore create two different index entries.
 

-@node Consistency Checks, Global Indexing, Collecting Phrases, The Index Phrases File
+@node Consistency Checks

 @subsection Consistency Checks
 @cindex Index phrases, consistency checks
 @cindex Phrases, consistency checks
 @subsection Consistency Checks
 @cindex Index phrases, consistency checks
 @cindex Phrases, consistency checks


@@ -2354,7 +2352,7 @@ the buffer which is either duplicate or a subphrase of another phrase.
 In order to check the whole buffer like this, start at the beginning and
 execute this command repeatedly.
 
 In order to check the whole buffer like this, start at the beginning and
 execute this command repeatedly.
 

-@node Global Indexing, , Consistency Checks, The Index Phrases File
+@node Global Indexing

 @subsection Global Indexing
 @cindex Global indexing
 @cindex Indexing, global
 @subsection Global Indexing
 @cindex Global indexing
 @cindex Indexing, global


@@ -2404,8 +2402,9 @@ Abort the indexing process.
 
 The @samp{Find and Index in Document} menu in the phrases buffer also
 lists a few options for the indexing process.  The options have
 
 The @samp{Find and Index in Document} menu in the phrases buffer also
 lists a few options for the indexing process.  The options have

-associated customization variables to set the defaults (@pxref{Options
-(Index Support)}).  Here is a short explanation of what the options do:
+associated customization variables to set the defaults
+(@pxref{Options - Index Support}).  Here is a short explanation of
+what the options do:

 
 @table @i
 @item Match Whole Words
 
 @table @i
 @item Match Whole Words


@@ -2435,7 +2434,7 @@ to the changed regions.  The command
 purpose.  When called from a @LaTeX{} document with active region, it will
 apply @code{reftex-index-all-phrases} to the current region.
 
 purpose.  When called from a @LaTeX{} document with active region, it will
 apply @code{reftex-index-all-phrases} to the current region.
 

-@node Displaying and Editing the Index, Builtin Index Macros, The Index Phrases File, Index Support
+@node Displaying and Editing the Index

 @section Displaying and Editing the Index
 @cindex Displaying the Index
 @cindex Editing the Index
 @section Displaying and Editing the Index
 @cindex Displaying the Index
 @cindex Editing the Index


@@ -2616,7 +2615,7 @@ indices).
 @end table
 
 
 @end table
 
 

-@node Builtin Index Macros, Defining Index Macros, Displaying and Editing the Index, Index Support
+@node Builtin Index Macros

 @section Builtin Index Macros
 @cindex Builtin index macros
 @cindex Index macros, builtin
 @section Builtin Index Macros
 @cindex Builtin index macros
 @cindex Index macros, builtin


@@ -2634,7 +2633,7 @@ the different definitions of the @code{\index} macro are incompatible,
 you will have to explicitly specify the index style used.
 @xref{Creating Index Entries}, for information on how to do that.
 
 you will have to explicitly specify the index style used.
 @xref{Creating Index Entries}, for information on how to do that.
 

-@node Defining Index Macros, , Builtin Index Macros, Index Support
+@node Defining Index Macros

 @section Defining Index Macros
 @cindex  Defining Index Macros
 @cindex Index macros, defining
 @section Defining Index Macros
 @cindex  Defining Index Macros
 @cindex Index macros, defining


@@ -2731,7 +2730,7 @@ which specifies that the macro identified with the character @code{?x} (the
 in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}).
 The index tag is "idx".
 
 in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}).
 The index tag is "idx".
 

-@node Viewing Cross-References, RefTeXs Menu, Index Support, Top
+@node Viewing Cross-References

 @chapter Viewing Cross-References
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref
 @chapter Viewing Cross-References
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref


@@ -2760,7 +2759,7 @@ variants@footnote{all macros that start with @samp{ref} or end with
 @samp{ref} or @samp{refrange}} of the @code{\ref} macro are active for
 cross-reference display.  This works also for labels defined in an
 external document when the current document refers to them through the
 @samp{ref} or @samp{refrange}} of the @code{\ref} macro are active for
 cross-reference display.  This works also for labels defined in an
 external document when the current document refers to them through the

-@code{xr} interface (@pxref{xr (LaTeX package)}).
+@code{xr} interface (@pxref{LaTeX xr Package}).

 
 @item @code{\label}
 @cindex @code{\label}
 
 @item @code{\label}
 @cindex @code{\label}


@@ -2810,8 +2809,11 @@ in the variable @code{reftex-view-crossref-extra}.
 @iftex
 @chapter All the Rest
 @end iftex
 @iftex
 @chapter All the Rest
 @end iftex

+@ifnottex
+@raisesections
+@end ifnottex

 
 

-@node RefTeXs Menu, Key Bindings, Viewing Cross-References, Top
+@node RefTeXs Menu

 @section @RefTeX{}'s Menu
 @cindex RefTeXs Menu
 @cindex Menu, in the menu bar
 @section @RefTeX{}'s Menu
 @cindex RefTeXs Menu
 @cindex Menu, in the menu bar


@@ -2822,7 +2824,7 @@ which support this.  From this menu you can access all of
 @code{Customize} submenu which can be used to access @RefTeX{}'s
 entire set of options.
 
 @code{Customize} submenu which can be used to access @RefTeX{}'s
 entire set of options.
 

-@node Key Bindings, Faces, RefTeXs Menu, Top
+@node Key Bindings

 @section Default Key Bindings
 @cindex Key Bindings, summary
 
 @section Default Key Bindings
 @cindex Key Bindings, summary
 


@@ -2896,7 +2898,7 @@ Changing and adding to @RefTeX{}'s key bindings is best done in the hook
 @code{reftex-load-hook}.  For information on the keymaps
 which should be used to add keys, see @ref{Keymaps and Hooks}.
 
 @code{reftex-load-hook}.  For information on the keymaps
 which should be used to add keys, see @ref{Keymaps and Hooks}.
 

-@node Faces, AUCTeX, Key Bindings, Top
+@node Faces

 @section Faces
 @cindex Faces
 
 @section Faces
 @cindex Faces
 


@@ -2906,9 +2908,9 @@ the ones defined in @file{font-lock.el}.  Therefore, @RefTeX{} will
 use faces only when @code{font-lock} is loaded.  This seems to be
 reasonable because people who like faces will very likely have it
 loaded.  If you wish to turn off fontification or change the involved
 use faces only when @code{font-lock} is loaded.  This seems to be
 reasonable because people who like faces will very likely have it
 loaded.  If you wish to turn off fontification or change the involved

-faces, see @ref{Options (Fontification)}.
+faces, see @ref{Options - Fontification}.

 
 

-@node Multifile Documents, Language Support, AUCTeX, Top
+@node Multifile Documents

 @section Multifile Documents
 @cindex Multifile documents
 @cindex Documents, spread over files
 @section Multifile Documents
 @cindex Multifile documents
 @cindex Documents, spread over files


@@ -2961,7 +2963,7 @@ outside the current file can still use that section title as
 context.
 @end itemize
 
 context.
 @end itemize
 

-@node Language Support, Finding Files, Multifile Documents, Top
+@node Language Support

 @section Language Support
 @cindex Language support
 
 @section Language Support
 @cindex Language support
 


@@ -3003,7 +3005,7 @@ dependent.  See the variables @code{reftex-multiref-punctuation} and
 @code{reftex-cite-punctuation}.
 @end itemize
 
 @code{reftex-cite-punctuation}.
 @end itemize
 

-@node Finding Files, Optimizations, Language Support, Top
+@node Finding Files

 @section Finding Files
 @cindex Finding files
 
 @section Finding Files
 @cindex Finding files
 


@@ -3089,7 +3091,7 @@ the new extension must also be known to @AUCTeX{} via the variable
       '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))
 @end lisp
 
       '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))
 @end lisp
 

-@node Optimizations, Problems and Work-Arounds, Finding Files, Top
+@node Optimizations

 @section Optimizations
 @cindex Optimizations
 
 @section Optimizations
 @cindex Optimizations
 


@@ -3242,7 +3244,7 @@ with the @kbd{g} key.  To get this behavior, use instead
 @end group
 @end lisp
 
 @end group
 @end lisp
 

-@node AUCTeX, Multifile Documents, Faces, Top
+@node AUCTeX

 @section @AUCTeX{}
 @cindex @code{AUCTeX}, Emacs package
 @cindex Emacs packages, @code{AUCTeX}
 @section @AUCTeX{}
 @cindex @code{AUCTeX}, Emacs package
 @cindex Emacs packages, @code{AUCTeX}


@@ -3259,7 +3261,7 @@ XEmacs package.} by FTP from the @value{AUCTEXSITE}.
 * Bib-Cite::                         Hypertext reading of a document
 @end menu
 
 * Bib-Cite::                         Hypertext reading of a document
 @end menu
 

-@node AUCTeX-RefTeX Interface, Style Files, , AUCTeX
+@node AUCTeX-RefTeX Interface

 @subsection The @AUCTeX{}-@RefTeX{} Interface
 
 @RefTeX{} contains code to interface with @AUCTeX{}.  When this
 @subsection The @AUCTeX{}-@RefTeX{} Interface
 
 @RefTeX{} contains code to interface with @AUCTeX{}.  When this


@@ -3343,7 +3345,7 @@ Labels}).
 @RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list.
 @end itemize
 
 @RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list.
 @end itemize
 

-@node Style Files, Bib-Cite, AUCTeX-RefTeX Interface, AUCTeX
+@node Style Files

 @subsection Style Files
 @cindex Style files, AUCTeX
 @findex TeX-add-style-hook, @r{AUCTeX}
 @subsection Style Files
 @cindex Style files, AUCTeX
 @findex TeX-add-style-hook, @r{AUCTeX}


@@ -3463,7 +3465,7 @@ is a style file @file{foils.el} that will inform @RefTeX{} about these:
                                       ("rotatefoilhead" . 3))))))
 @end lisp
 
                                       ("rotatefoilhead" . 3))))))
 @end lisp
 

-@node Bib-Cite, , Style Files, AUCTeX
+@node Bib-Cite

 @subsection Bib-Cite
 @cindex @code{bib-cite}, Emacs package
 @cindex Emacs packages, @code{bib-cite}
 @subsection Bib-Cite
 @cindex @code{bib-cite}, Emacs package
 @cindex Emacs packages, @code{bib-cite}


@@ -3491,7 +3493,7 @@ make use of this feature, try
 @end lisp
 
 @page
 @end lisp
 
 @page

-@node Problems and Work-Arounds, Imprint, Optimizations, Top
+@node Problems and Work-Arounds

 @section Problems and Work-arounds
 @cindex Problems and work-arounds
 
 @section Problems and Work-arounds
 @cindex Problems and work-arounds
 


@@ -3627,7 +3629,7 @@ With @i{Viper} mode prior to Vipers version 3.01, you need to protect
 @end itemize
 
 @page
 @end itemize
 
 @page

-@node Imprint, Commands, Problems and Work-Arounds, Top
+@node Imprint

 @section Imprint
 @cindex Imprint
 @cindex Maintainer
 @section Imprint
 @cindex Imprint
 @cindex Maintainer


@@ -3637,8 +3639,8 @@ With @i{Viper} mode prior to Vipers version 3.01, you need to protect
 @cindex @code{http}, @RefTeX{} home page
 @cindex @code{ftp}, @RefTeX{} site
 
 @cindex @code{http}, @RefTeX{} home page
 @cindex @code{ftp}, @RefTeX{} site
 

-@RefTeX{} was written by @i{Carsten Dominik}
-@email{dominik@@science.uva.nl}, with contributions by @i{Stephen
+@c dominik@@science.uva.nl
+@RefTeX{} was written by @i{Carsten Dominik}, with contributions by @i{Stephen

 Eglen}.  @RefTeX{} is currently maintained by @value{MAINTAINER}, see
 the @value{MAINTAINERSITE} for detailed information.
 
 Eglen}.  @RefTeX{} is currently maintained by @value{MAINTAINER}, see
 the @value{MAINTAINERSITE} for detailed information.
 


@@ -3674,7 +3676,12 @@ Finally thanks to @i{Uwe Bolick} who first got me interested in
 supporting @LaTeX{} labels and references with an editor (which was
 MicroEmacs at the time).
 
 supporting @LaTeX{} labels and references with an editor (which was
 MicroEmacs at the time).
 

-@node Commands, Options, Imprint, Top
+@c Turn off the raising that we turned on in ``All the rest''.
+@ifnottex
+@lowersections
+@end ifnottex
+
+@node Commands

 @chapter Commands
 @cindex Commands, list of
 
 @chapter Commands
 @cindex Commands, list of
 


@@ -3876,7 +3883,7 @@ Enforce rebuilding of several internal lists and variables.  Also
 removes the parse file associated with the current document.
 @end deffn
 
 removes the parse file associated with the current document.
 @end deffn
 

-@node Options, Keymaps and Hooks, Commands, Top
+@node Options

 @chapter Options, Keymaps, Hooks
 @cindex Options, list of
 
 @chapter Options, Keymaps, Hooks
 @cindex Options, list of
 


@@ -3887,20 +3894,21 @@ Lisp (and even if you are) you might find it more comfortable to use
 reftex-customize} will get you there.
 
 @menu
 reftex-customize} will get you there.
 
 @menu

-* Options (Table of Contents)::
-* Options (Defining Label Environments)::
-* Options (Creating Labels)::
-* Options (Referencing Labels)::
-* Options (Creating Citations)::
-* Options (Index Support)::
-* Options (Viewing Cross-References)::
-* Options (Finding Files)::
-* Options (Optimizations)::
-* Options (Fontification)::
-* Options (Misc)::
+* Options - Table of Contents::
+* Options - Defining Label Environments::
+* Options - Creating Labels::
+* Options - Referencing Labels::
+* Options - Creating Citations::
+* Options - Index Support::
+* Options - Viewing Cross-References::
+* Options - Finding Files::
+* Options - Optimizations::
+* Options - Fontification::
+* Options - Misc::
+* Keymaps and Hooks::

 @end menu
 
 @end menu
 

-@node Options (Table of Contents), Options (Defining Label Environments), ,  Options
+@node Options - Table of Contents

 @section Table of Contents
 @cindex Options, table of contents
 @cindex Table of contents, options
 @section Table of Contents
 @cindex Options, table of contents
 @cindex Table of contents, options


@@ -4024,7 +4032,7 @@ The keymap which is active in the @file{*toc*} buffer.
 (@pxref{Table of Contents}).
 @end deffn
 
 (@pxref{Table of Contents}).
 @end deffn
 

-@node Options (Defining Label Environments), Options (Creating Labels), Options (Table of Contents), Options
+@node Options - Defining Label Environments

 @section Defining Label Environments
 @cindex Options, defining label environments
 @cindex Defining label environments, options
 @section Defining Label Environments
 @cindex Options, defining label environments
 @cindex Defining label environments, options


@@ -4251,7 +4259,7 @@ labels fn:xxx, you may want to set this variable to the value "^fn:$" or
 non-footnote labels.
 @end defopt
 
 non-footnote labels.
 @end defopt
 

-@node Options (Creating Labels), Options (Referencing Labels), Options (Defining Label Environments), Options
+@node Options - Creating Labels

 @section Creating Labels
 @cindex Options, creating labels
 @cindex Creating labels, options
 @section Creating Labels
 @cindex Options, creating labels
 @cindex Creating labels, options


@@ -4367,7 +4375,7 @@ Character class after  abbrev point in word.
 @end table
 @end defopt
 
 @end table
 @end defopt
 

-@node Options (Referencing Labels), Options (Creating Citations), Options (Creating Labels), Options
+@node Options - Referencing Labels

 @section Referencing Labels
 @cindex Options, referencing labels
 @cindex Referencing labels, options
 @section Referencing Labels
 @cindex Options, referencing labels
 @cindex Referencing labels, options


@@ -4489,7 +4497,7 @@ The keymap which is active in the labels selection process
 (@pxref{Referencing Labels}).
 @end deffn
 
 (@pxref{Referencing Labels}).
 @end deffn
 

-@node Options (Creating Citations), Options (Index Support), Options (Referencing Labels), Options
+@node Options - Creating Citations

 @section Creating Citations
 @cindex Options, creating citations
 @cindex Creating citations, options
 @section Creating Citations
 @cindex Options, creating citations
 @cindex Creating citations, options


@@ -4668,7 +4676,7 @@ Footer to insert in BibTeX files generated by
 @end defopt
 
 
 @end defopt
 
 

-@node Options (Index Support), Options (Viewing Cross-References), Options (Creating Citations),  Options
+@node Options - Index Support, Options - Viewing Cross-References, Options - Creating Citations,  Options

 @section Index Support
 @cindex Options, Index support
 @cindex Index support, options
 @section Index Support
 @cindex Options, Index support
 @cindex Index support, options


@@ -4888,7 +4896,7 @@ The keymap which is active in the @file{*Index*} buffer
 (@pxref{Index Support}).
 @end deffn
 
 (@pxref{Index Support}).
 @end deffn
 

-@node Options (Viewing Cross-References), Options (Finding Files), Options (Index Support),  Options
+@node Options - Viewing Cross-References

 @section Viewing Cross-References
 @cindex Options, viewing cross-references
 @cindex Viewing cross-references, options
 @section Viewing Cross-References
 @cindex Options, viewing cross-references
 @cindex Viewing cross-references, options


@@ -4947,7 +4955,7 @@ saved along with the parsing information.  The cache survives document
 scans.  In order to clear it, use @kbd{M-x reftex-reset-mode}.
 @end defopt
 
 scans.  In order to clear it, use @kbd{M-x reftex-reset-mode}.
 @end defopt
 

-@node Options (Finding Files), Options (Optimizations), Options (Viewing Cross-References),  Options
+@node Options - Finding Files

 @section Finding Files
 @cindex Options, Finding Files
 @cindex Finding files, options
 @section Finding Files
 @cindex Options, Finding Files
 @cindex Finding files, options


@@ -5037,7 +5045,7 @@ non-@code{nil}.
 @end defopt
 
 @page
 @end defopt
 
 @page

-@node Options (Optimizations), Options (Fontification), Options (Finding Files), Options
+@node Options - Optimizations

 @section Optimizations
 @cindex Options, optimizations
 @cindex Optimizations, options
 @section Optimizations
 @cindex Options, optimizations
 @cindex Optimizations, options


@@ -5146,7 +5154,7 @@ effect when @code{reftex-use-multiple-selection-buffers} is
 non-@code{nil}.
 @end defopt
 
 non-@code{nil}.
 @end defopt
 

-@node Options (Fontification), Options (Misc), Options (Optimizations), Options
+@node Options - Fontification

 @section Fontification
 @cindex Options, fontification
 @cindex Fontification, options
 @section Fontification
 @cindex Options, fontification
 @cindex Fontification, options


@@ -5244,7 +5252,7 @@ Face name for index names (for multiple indices).
 Face name for index entries.
 @end defopt
 
 Face name for index entries.
 @end defopt
 

-@node Options (Misc), , Options (Fontification), Options
+@node Options - Misc

 @section Miscellaneous
 @cindex Options, misc
 
 @section Miscellaneous
 @cindex Options, misc
 


@@ -5289,7 +5297,7 @@ this will be the case even if @code{\bb} is defined with zero or one
 argument.
 @end defopt
 
 argument.
 @end defopt
 

-@node Keymaps and Hooks, Changes, Options, Top
+@node Keymaps and Hooks

 @section Keymaps and Hooks
 @cindex Keymaps
 
 @section Keymaps and Hooks
 @cindex Keymaps
 


@@ -5313,7 +5321,7 @@ their own keymaps and mode hooks.  See the respective sections.  There
 are many more hooks which are described in the relevant sections about
 options for a specific part of @RefTeX{}.
 
 are many more hooks which are described in the relevant sections about
 options for a specific part of @RefTeX{}.
 

-@node Changes, GNU Free Documentation License, Keymaps and Hooks, Top
+@node Changes

 @chapter Changes
 @cindex Changes
 
 @chapter Changes
 @cindex Changes
 


@@ -6078,11 +6086,11 @@ new labels.
 released on 7 Jan 1997.
 @end itemize
 
 released on 7 Jan 1997.
 @end itemize
 

-@node GNU Free Documentation License, Index, Changes, Top
+@node GNU Free Documentation License

 @appendix GNU Free Documentation License
 @include doclicense.texi
 
 @appendix GNU Free Documentation License
 @include doclicense.texi
 

-@node Index, , GNU Free Documentation License, Top
+@node Index

 @unnumbered Index
 @printindex cp
 
 @unnumbered Index
 @printindex cp