[Emacs-diffs] /srv/bzr/emacs/trunk r111304: Remove hand-written node pointers in doc/misc/reftex.texi

[Glenn Morris]

------------------------------------------------------------
revno: 111304
committer: Glenn Morris <address@hidden>
branch nick: trunk
timestamp: Sat 2012-12-22 12:29:16 -0800
message:
  Remove hand-written node pointers in doc/misc/reftex.texi
  Fix up sectioning
modified:
  doc/misc/ChangeLog
  doc/misc/reftex.texi

=== modified file 'doc/misc/ChangeLog'
--- a/doc/misc/ChangeLog        2012-12-22 20:19:41 +0000
+++ b/doc/misc/ChangeLog        2012-12-22 20:29:16 +0000
@@ -1,9 +1,9 @@
 2012-12-22  Glenn Morris  <address@hidden>
 
        * ada-mode.texi, ebrowse.texi, ediff.texi, ert.texi, eshell.texi:
-       * eudc.texi, idlwave.texi, pcl-cvs.texi, rcirc.texi, remember.texi:
-       * ses.texi, speedbar.texi, vip.texi, viper.texi, widget.texi:
-       * wisent.texi: Nuke hand-written node pointers.
+       * eudc.texi, idlwave.texi, pcl-cvs.texi, rcirc.texi, reftex.texi:
+       * remember.texi, ses.texi, speedbar.texi, vip.texi, viper.texi:
+       * widget.texi, wisent.texi: Nuke hand-written node pointers.
 
        * Makefile.in (gfdl): New variable.  Use throughout where
        appropriate so that targets depend on doclicense.texi.

=== modified file 'doc/misc/reftex.texi'
--- a/doc/misc/reftex.texi      2012-12-22 16:25:40 +0000
+++ b/doc/misc/reftex.texi      2012-12-22 20:29:16 +0000
@@ -95,7 +95,7 @@
 @contents
 
 @ifnottex
address@hidden Top,,,(dir)
address@hidden Top
 @top @RefTeX{}
 
 @RefTeX{} is a package for managing Labels, References, Citations and
@@ -123,14 +123,13 @@
 * Multifile Documents::              Document spread over many files.
 * Language Support::                 How to support other languages.
 * Finding Files::                    Included @TeX{} files and @BibTeX{} .bib 
files.
+* Optimizations::                    When RefTeX is too slow.
 * AUCTeX::                           Cooperation with @AUCTeX{}.
-* Optimizations::                    When RefTeX is too slow.
 * 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.
 
@@ -214,7 +213,7 @@
 
 @end ifnottex
 
address@hidden Introduction, Table of Contents, , Top
address@hidden Introduction
 @chapter Introduction
 @cindex Introduction
 
@@ -242,7 +241,7 @@
 * RefTeX in a Nutshell::             A brief summary and quick guide.
 @end menu
 
address@hidden Installation, RefTeX in a Nutshell, , Introduction
address@hidden Installation
 @section Installation
 @cindex Installation
 
@@ -360,7 +359,7 @@
 @xref{Finding Files}.
 
 @page
address@hidden RefTeX in a Nutshell, , Installation, Introduction
address@hidden RefTeX in a Nutshell
 @section @RefTeX{} in a Nutshell
 @cindex Quick-Start
 @cindex Getting Started
@@ -516,7 +515,7 @@
 part is a command and variable reference.
 @end enumerate
 
address@hidden Table of Contents, Labels and References, Introduction, Top
address@hidden Table of Contents
 @chapter Table of Contents
 @cindex @file{*toc*} buffer
 @cindex Structure editing
@@ -765,7 +764,7 @@
 theorem-like environments. @xref{Defining Label Environments}, for an
 example.
 
address@hidden Labels and References, Citations, Table of Contents, Top
address@hidden Labels and References
 @chapter Labels and References
 @cindex Labels in LaTeX
 @cindex References in LaTeX
@@ -800,7 +799,7 @@
 * xr (LaTeX package)::               References to external documents.
 @end menu
 
address@hidden Creating Labels, Referencing Labels, , Labels and References
address@hidden Creating Labels
 @section Creating Labels
 @cindex Creating labels
 @cindex Labels, creating
@@ -867,7 +866,7 @@
 set it up to delegate the creation of labels to
 @RefTeX{}. @xref{AUCTeX}, for more information.
 
address@hidden Referencing Labels, Builtin Label Environments, Creating Labels, 
Labels and References
address@hidden Referencing Labels
 @section Referencing Labels
 @cindex Referencing labels
 @cindex Labels, referencing
@@ -1092,7 +1091,7 @@
 In order to define additional commands for the selection process, the
 keymap @code{reftex-select-label-map} may be used.
 
address@hidden Builtin Label Environments, Defining Label Environments, 
Referencing Labels, Labels and References
address@hidden Builtin Label Environments
 @section Builtin Label Environments
 @cindex Builtin label environments
 @cindex Label environments, builtin
@@ -1197,7 +1196,7 @@
 @code{\newtheorem}, @RefTeX{} needs to be configured to recognize
 them (@pxref{Defining Label Environments}).
 
address@hidden Defining Label Environments, Reference Info, Builtin Label 
Environments, Labels and References
address@hidden Defining Label Environments
 @section Defining Label Environments
 @cindex Label environments, defining
 
@@ -1230,7 +1229,7 @@
 * Putting it Together::              How to combine many entries.
 @end menu
 
address@hidden Theorem and Axiom, Quick Equation, , Defining Label Environments
address@hidden Theorem and Axiom
 @subsection Theorem and Axiom Environments
 @cindex @code{theorem}, newtheorem
 @cindex @code{axiom}, newtheorem
@@ -1362,7 +1361,7 @@
 Labels)}).
 
 
address@hidden Quick Equation, Figure Wrapper, Theorem and Axiom , Defining 
Label Environments
address@hidden Quick Equation
 @subsection Quick Equation Macro
 @cindex Quick equation macro
 @cindex Macros as environment wrappers
@@ -1410,7 +1409,7 @@
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 
address@hidden Figure Wrapper, Adding Magic Words, Quick Equation, Defining 
Label Environments
address@hidden Figure Wrapper
 @subsection Figure Wrapping Macro
 @cindex Macros as environment wrappers
 @cindex Figure wrapping macro
@@ -1470,7 +1469,7 @@
             [ ] Make TOC entry    : [Value Menu] No entry
 @end example
 
address@hidden Adding Magic Words, Using \eqref, Figure Wrapper, Defining Label 
Environments
address@hidden Adding Magic Words
 @subsection Adding Magic Words
 @cindex Magic words
 @cindex German magic words
@@ -1494,7 +1493,7 @@
     (nil ?i nil nil nil ("Punkt"))))
 @end lisp
 
address@hidden Using \eqref, Non-Standard Environments, Adding Magic Words, 
Defining Label Environments
address@hidden Using \eqref
 @subsection Using @code{\eqref}
 @cindex @code{\eqref}, AMS-LaTeX macro
 @cindex AMS-LaTeX
@@ -1521,7 +1520,7 @@
 of @AUCTeX{} (@pxref{Style Files}); so if you use @AUCTeX{},
 this configuration will not be necessary.
 
address@hidden Non-Standard Environments, Putting it Together, Using \eqref, 
Defining Label Environments
address@hidden Non-Standard Environments
 @subsection Non-standard Environments
 @cindex Non-standard environments
 @cindex Environments without @code{\begin}
@@ -1622,7 +1621,7 @@
             (incf cnt))))))))
 @end lisp
 
address@hidden Putting it Together, , Non-Standard Environments, Defining Label 
Environments
address@hidden Putting it Together
 @subsection Putting it all together
 
 When you have to put several entries into @code{reftex-label-alist}, just
@@ -1640,7 +1639,7 @@
     (detect-linguex ?x "ex:" "address@hidden@}" nil ("Example" "Ex."))))
 @end lisp
 
address@hidden Reference Info, Reference Styles, Defining Label Environments, 
Labels and References
address@hidden Reference Info
 @section Reference Info
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref
@@ -1662,7 +1661,7 @@
 @code{\label} macro.  @xref{Viewing Cross-References}, for more
 information.
 
address@hidden Reference Styles, xr (LaTeX package), Reference Info, Labels and 
References
address@hidden Reference Styles
 @section Reference Styles
 
 In case you defined your own macros for referencing or you are using
@@ -1750,7 +1749,7 @@
 these variables are deprecated now.  Instead of setting them, the
 variable @code{reftex-ref-style-default-list} should be adapted now.
 
address@hidden xr (LaTeX package), , Reference Styles, Labels and References
address@hidden xr (LaTeX package)
 @section @code{xr}: Cross-Document References
 @cindex @code{xr}, LaTeX package
 @cindex LaTeX packages, @code{xr}
@@ -1785,7 +1784,7 @@
 information and the use of multiple selection buffers can mean a large
 speed-up (@pxref{Optimizations}).
 
address@hidden Citations, Index Support, Labels and References, Top
address@hidden Citations
 @chapter Citations
 @cindex Citations
 @cindex @code{\cite}
@@ -1805,7 +1804,7 @@
 * BibTeX Database Subsets::          Extract parts of a big database.
 @end menu
 
address@hidden Creating Citations, Citation Styles, , Citations
address@hidden Creating Citations
 @section Creating Citations
 @cindex Creating citations
 @cindex Citations, creating
@@ -1955,7 +1954,7 @@
 @end lisp
 
 
address@hidden Citation Styles, Citation Info, Creating Citations, Citations
address@hidden Citation Styles
 @section Citation Styles
 @cindex Citation styles
 @cindex Citation styles, @code{natbib}
@@ -2020,7 +2019,7 @@
 document.  @xref{Style Files}, for information on how to set up the style
 files correctly.
 
address@hidden Citation Info, Chapterbib and Bibunits, Citation Styles, 
Citations
address@hidden Citation Info
 @section Citation Info
 @cindex Displaying citations
 @cindex Citations, displaying
@@ -2041,7 +2040,7 @@
 corresponding to a @code{\bibitem} or @BibTeX{} database entry.
 @xref{Viewing Cross-References}.
 
address@hidden Chapterbib and Bibunits, Citations Outside LaTeX, Citation Info, 
Citations
address@hidden Chapterbib and Bibunits
 @section Chapterbib and Bibunits
 @cindex @code{chapterbib}, LaTeX package
 @cindex @code{bibunits}, LaTeX package
@@ -2056,7 +2055,7 @@
 you have multiple bibliographies within a @emph{single file}, this may
 or may not be the case.
 
address@hidden Citations Outside LaTeX, BibTeX Database Subsets, Chapterbib and 
Bibunits, Citations
address@hidden Citations Outside LaTeX
 @section Citations outside @LaTeX{}
 @cindex Citations outside LaTeX
 @vindex reftex-default-bibliography
@@ -2081,7 +2080,7 @@
                            (reftex-citation))))))
 @end lisp
 
address@hidden BibTeX Database Subsets, , Citations Outside LaTeX, Citations
address@hidden BibTeX Database Subsets
 @section Database Subsets
 @cindex BibTeX database subsets
 @findex reftex-create-bibtex-file
@@ -2109,7 +2108,7 @@
 either the @i{marked} entries (with the @kbd{e} key) or the
 @i{unmarked} entries (with the @kbd{E} key).
 
address@hidden Index Support, Viewing Cross-References, Citations, Top
address@hidden Index Support
 @chapter Index Support
 @cindex Index Support
 @cindex @code{\index}
@@ -2176,7 +2175,7 @@
 * Defining Index Macros::                ... and macros it  doesn't.
 @end menu
 
address@hidden Creating Index Entries, The Index Phrases File, , Index Support
address@hidden Creating Index Entries
 @section Creating Index Entries
 @cindex Creating index entries
 @cindex Index entries, creating
@@ -2207,7 +2206,7 @@
 @file{multind} and @file{index} packages, this tag is the first argument
 to the redefined @code{\index} macro.
 
address@hidden The Index Phrases File, Displaying and Editing the Index, 
Creating Index Entries, Index Support
address@hidden The Index Phrases File
 @section The Index Phrases File
 @cindex Index phrase file
 @cindex Phrase file
@@ -2255,7 +2254,7 @@
 * Global Indexing::                  The interactive indexing process.
 @end menu
 
address@hidden Collecting Phrases, Consistency Checks, , The Index Phrases File
address@hidden Collecting Phrases
 @subsection Collecting Phrases
 @cindex Collecting index phrases
 @cindex Index phrases, collection
@@ -2321,7 +2320,7 @@
 @address@hidden@address@hidden Belt address@hidden
 and will therefore create two different index entries.
 
address@hidden Consistency Checks, Global Indexing, Collecting Phrases, The 
Index Phrases File
address@hidden Consistency Checks
 @subsection Consistency Checks
 @cindex Index phrases, consistency checks
 @cindex Phrases, consistency checks
@@ -2354,7 +2353,7 @@
 In order to check the whole buffer like this, start at the beginning and
 execute this command repeatedly.
 
address@hidden Global Indexing, , Consistency Checks, The Index Phrases File
address@hidden Global Indexing
 @subsection Global Indexing
 @cindex Global indexing
 @cindex Indexing, global
@@ -2435,7 +2434,7 @@
 purpose.  When called from a @LaTeX{} document with active region, it will
 apply @code{reftex-index-all-phrases} to the current region.
 
address@hidden Displaying and Editing the Index, Builtin Index Macros, The 
Index Phrases File, Index Support
address@hidden Displaying and Editing the Index
 @section Displaying and Editing the Index
 @cindex Displaying the Index
 @cindex Editing the Index
@@ -2616,7 +2615,7 @@
 @end table
 
 
address@hidden Builtin Index Macros, Defining Index Macros, Displaying and 
Editing the Index, Index Support
address@hidden Builtin Index Macros
 @section Builtin Index Macros
 @cindex Builtin index macros
 @cindex Index macros, builtin
@@ -2634,7 +2633,7 @@
 you will have to explicitly specify the index style used.
 @xref{Creating Index Entries}, for information on how to do that.
 
address@hidden Defining Index Macros, , Builtin Index Macros, Index Support
address@hidden Defining Index Macros
 @section Defining Index Macros
 @cindex  Defining Index Macros
 @cindex Index macros, defining
@@ -2731,7 +2730,7 @@
 in the buffer with @kbd{C-c /} (@code{reftex-index-selection-or-word}).
 The index tag is "idx".
 
address@hidden Viewing Cross-References, RefTeXs Menu, Index Support, Top
address@hidden Viewing Cross-References
 @chapter Viewing Cross-References
 @findex reftex-view-crossref
 @findex reftex-mouse-view-crossref
@@ -2810,8 +2809,11 @@
 @iftex
 @chapter All the Rest
 @end iftex
address@hidden
address@hidden
address@hidden ifnottex
 
address@hidden RefTeXs Menu, Key Bindings, Viewing Cross-References, Top
address@hidden RefTeXs Menu
 @section @RefTeX{}'s Menu
 @cindex RefTeXs Menu
 @cindex Menu, in the menu bar
@@ -2822,7 +2824,7 @@
 @code{Customize} submenu which can be used to access @RefTeX{}'s
 entire set of options.
 
address@hidden Key Bindings, Faces, RefTeXs Menu, Top
address@hidden Key Bindings
 @section Default Key Bindings
 @cindex Key Bindings, summary
 
@@ -2896,7 +2898,7 @@
 @code{reftex-load-hook}.  For information on the keymaps
 which should be used to add keys, see @ref{Keymaps and Hooks}.
 
address@hidden Faces, AUCTeX, Key Bindings, Top
address@hidden Faces
 @section Faces
 @cindex Faces
 
@@ -2908,7 +2910,7 @@
 loaded.  If you wish to turn off fontification or change the involved
 faces, see @ref{Options (Fontification)}.
 
address@hidden Multifile Documents, Language Support, AUCTeX, Top
address@hidden Multifile Documents
 @section Multifile Documents
 @cindex Multifile documents
 @cindex Documents, spread over files
@@ -2961,7 +2963,7 @@
 context.
 @end itemize
 
address@hidden Language Support, Finding Files, Multifile Documents, Top
address@hidden Language Support
 @section Language Support
 @cindex Language support
 
@@ -3003,7 +3005,7 @@
 @code{reftex-cite-punctuation}.
 @end itemize
 
address@hidden Finding Files, Optimizations, Language Support, Top
address@hidden Finding Files
 @section Finding Files
 @cindex Finding files
 
@@ -3089,7 +3091,7 @@
       '( "nw" "tex" "sty" "cls" "ltx" "texi" "texinfo"))
 @end lisp
 
address@hidden Optimizations, Problems and Work-Arounds, Finding Files, Top
address@hidden Optimizations
 @section Optimizations
 @cindex Optimizations
 
@@ -3242,7 +3244,7 @@
 @end group
 @end lisp
 
address@hidden AUCTeX, Multifile Documents, Faces, Top
address@hidden AUCTeX
 @section @AUCTeX{}
 @cindex @code{AUCTeX}, Emacs package
 @cindex Emacs packages, @code{AUCTeX}
@@ -3259,7 +3261,7 @@
 * Bib-Cite::                         Hypertext reading of a document
 @end menu
 
address@hidden AUCTeX-RefTeX Interface, Style Files, , AUCTeX
address@hidden AUCTeX-RefTeX Interface
 @subsection The @address@hidden Interface
 
 @RefTeX{} contains code to interface with @AUCTeX{}.  When this
@@ -3343,7 +3345,7 @@
 @RefTeX{} will add all newly created labels to @AUCTeX{}'s completion list.
 @end itemize
 
address@hidden Style Files, Bib-Cite, AUCTeX-RefTeX Interface, AUCTeX
address@hidden Style Files
 @subsection Style Files
 @cindex Style files, AUCTeX
 @findex TeX-add-style-hook, @r{AUCTeX}
@@ -3463,7 +3465,7 @@
                                       ("rotatefoilhead" . 3))))))
 @end lisp
 
address@hidden Bib-Cite, , Style Files, AUCTeX
address@hidden Bib-Cite
 @subsection Bib-Cite
 @cindex @code{bib-cite}, Emacs package
 @cindex Emacs packages, @code{bib-cite}
@@ -3491,7 +3493,7 @@
 @end lisp
 
 @page
address@hidden Problems and Work-Arounds, Imprint, Optimizations, Top
address@hidden Problems and Work-Arounds
 @section Problems and Work-arounds
 @cindex Problems and work-arounds
 
@@ -3627,7 +3629,7 @@
 @end itemize
 
 @page
address@hidden Imprint, Commands, Problems and Work-Arounds, Top
address@hidden Imprint
 @section Imprint
 @cindex Imprint
 @cindex Maintainer
@@ -3674,7 +3676,12 @@
 supporting @LaTeX{} labels and references with an editor (which was
 MicroEmacs at the time).
 
address@hidden Commands, Options, Imprint, Top
address@hidden Turn off the raising that we turned on in ``All the rest''.
address@hidden
address@hidden
address@hidden ifnottex
+
address@hidden Commands
 @chapter Commands
 @cindex Commands, list of
 
@@ -3876,7 +3883,7 @@
 removes the parse file associated with the current document.
 @end deffn
 
address@hidden Options, Keymaps and Hooks, Commands, Top
address@hidden Options
 @chapter Options, Keymaps, Hooks
 @cindex Options, list of
 
@@ -3898,9 +3905,10 @@
 * Options (Optimizations)::
 * Options (Fontification)::
 * Options (Misc)::
+* Keymaps and Hooks::
 @end menu
 
address@hidden Options (Table of Contents), Options (Defining Label 
Environments), ,  Options
address@hidden Options (Table of Contents)
 @section Table of Contents
 @cindex Options, table of contents
 @cindex Table of contents, options
@@ -4024,7 +4032,7 @@
 (@pxref{Table of Contents}).
 @end deffn
 
address@hidden Options (Defining Label Environments), Options (Creating 
Labels), Options (Table of Contents), Options
address@hidden Options (Defining Label Environments)
 @section Defining Label Environments
 @cindex Options, defining label environments
 @cindex Defining label environments, options
@@ -4251,7 +4259,7 @@
 non-footnote labels.
 @end defopt
 
address@hidden Options (Creating Labels), Options (Referencing Labels), Options 
(Defining Label Environments), Options
address@hidden Options (Creating Labels)
 @section Creating Labels
 @cindex Options, creating labels
 @cindex Creating labels, options
@@ -4367,7 +4375,7 @@
 @end table
 @end defopt
 
address@hidden Options (Referencing Labels), Options (Creating Citations), 
Options (Creating Labels), Options
address@hidden Options (Referencing Labels)
 @section Referencing Labels
 @cindex Options, referencing labels
 @cindex Referencing labels, options
@@ -4489,7 +4497,7 @@
 (@pxref{Referencing Labels}).
 @end deffn
 
address@hidden Options (Creating Citations), Options (Index Support), Options 
(Referencing Labels), Options
address@hidden Options (Creating Citations)
 @section Creating Citations
 @cindex Options, creating citations
 @cindex Creating citations, options
@@ -4667,7 +4675,7 @@
 @end defopt
 
 
address@hidden Options (Index Support), Options (Viewing Cross-References), 
Options (Creating Citations),  Options
address@hidden Options (Index Support)
 @section Index Support
 @cindex Options, Index support
 @cindex Index support, options
@@ -4887,7 +4895,7 @@
 (@pxref{Index Support}).
 @end deffn
 
address@hidden Options (Viewing Cross-References), Options (Finding Files), 
Options (Index Support),  Options
address@hidden Options (Viewing Cross-References)
 @section Viewing Cross-References
 @cindex Options, viewing cross-references
 @cindex Viewing cross-references, options
@@ -4946,7 +4954,7 @@
 scans.  In order to clear it, use @kbd{M-x reftex-reset-mode}.
 @end defopt
 
address@hidden Options (Finding Files), Options (Optimizations), Options 
(Viewing Cross-References),  Options
address@hidden Options (Finding Files)
 @section Finding Files
 @cindex Options, Finding Files
 @cindex Finding files, options
@@ -5036,7 +5044,7 @@
 @end defopt
 
 @page
address@hidden Options (Optimizations), Options (Fontification), Options 
(Finding Files), Options
address@hidden Options (Optimizations)
 @section Optimizations
 @cindex Options, optimizations
 @cindex Optimizations, options
@@ -5145,7 +5153,7 @@
 address@hidden
 @end defopt
 
address@hidden Options (Fontification), Options (Misc), Options 
(Optimizations), Options
address@hidden Options (Fontification)
 @section Fontification
 @cindex Options, fontification
 @cindex Fontification, options
@@ -5243,7 +5251,7 @@
 Face name for index entries.
 @end defopt
 
address@hidden Options (Misc), , Options (Fontification), Options
address@hidden Options (Misc)
 @section Miscellaneous
 @cindex Options, misc
 
@@ -5288,7 +5296,7 @@
 argument.
 @end defopt
 
address@hidden Keymaps and Hooks, Changes, Options, Top
address@hidden Keymaps and Hooks
 @section Keymaps and Hooks
 @cindex Keymaps
 
@@ -5312,7 +5320,7 @@
 are many more hooks which are described in the relevant sections about
 options for a specific part of @RefTeX{}.
 
address@hidden Changes, GNU Free Documentation License, Keymaps and Hooks, Top
address@hidden Changes
 @chapter Changes
 @cindex Changes
 
@@ -6077,11 +6085,11 @@
 released on 7 Jan 1997.
 @end itemize
 
address@hidden GNU Free Documentation License, Index, Changes, Top
address@hidden GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include doclicense.texi
 
address@hidden Index, , GNU Free Documentation License, Top
address@hidden Index
 @unnumbered Index
 @printindex cp