Commit 563a450c authored by Glenn Morris's avatar Glenn Morris

Remove more hand-written node pointers in doc/misc

parent fdf4d02e
2012-12-22 Glenn Morris <rgm@gnu.org>
* ada-mode.texi, ebrowse.texi, ediff.texi, ert.texi, eshell.texi:
* eudc.texi, idlwave.texi, rcirc.texi, remember.texi, ses.texi:
* speedbar.texi, vip.texi: Nuke hand-written node pointers.
* Makefile.in (gfdl): New variable. Use throughout where
appropriate so that targets depend on doclicense.texi.
......
......@@ -37,7 +37,7 @@ modify this GNU manual.''
@contents
@node Top, Overview, (dir), (dir)
@node Top
@top Ada Mode
@ifnottex
......@@ -64,7 +64,7 @@ modify this GNU manual.''
@end menu
@node Overview, Installation, Top, Top
@node Overview
@chapter Overview
The Emacs mode for programming in Ada helps the user in understanding
......@@ -96,7 +96,7 @@ and other GNAT commands.
See the Emacs info manual, section 'Running Debuggers Under Emacs',
for general information on debugging.
@node Installation, Customization, Overview, Top
@node Installation
@chapter Installation
Ada mode is part of the standard Emacs distribution; if you use that,
......@@ -136,7 +136,7 @@ GNAT-specific).
@end itemize
@node Customization, Compiling Executing, Installation, Top
@node Customization
@chapter Customizing Ada mode
Here we assume you are familiar with setting variables in Emacs,
......@@ -175,7 +175,7 @@ See the Emacs help for each of these variables for more information.
* Other customization::
@end menu
@node Non-standard file names, Other compiler, Customization, Customization
@node Non-standard file names
@section Non-standard file names
By default, Ada mode is configured to use the GNAT file naming
......@@ -217,7 +217,7 @@ rewrite the function @code{ada-make-filename-from-adaname}. Doing that
is beyond the scope of this manual; see the current definitions in
@file{ada-mode.el} and @file{ada-xref.el} for examples.
@node Other compiler, Other customization, Non-standard file names, Customization
@node Other compiler
@section Other compiler
By default, Ada mode is configured to use the Gnu Ada compiler GNAT.
......@@ -227,7 +227,7 @@ used to run that compiler, either in lisp variables or in Emacs
Ada mode project files. See @ref{Project file variables} for the list
of project variables, and the corresponding lisp variables.
@node Other customization, , Other compiler, Customization
@node Other customization
@section Other customization
All user-settable Ada mode variables can be set via the menu
......@@ -245,7 +245,7 @@ and the syntax to set a variable is the following:
(setq variable-name value)
@end example
@node Compiling Executing, Project files, Customization, Top
@node Compiling Executing
@chapter Compiling Executing
Ada projects can be compiled, linked, and executed using commands on
......@@ -263,7 +263,7 @@ file variables referenced here.
* Compiler errors::
@end menu
@node Compile commands, Compiler errors, Compiling Executing, Compiling Executing
@node Compile commands
@section Compile commands
Here are the commands for building and using an Ada project, as
......@@ -346,7 +346,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code
@end enumerate
@node Compiler errors, , Compile commands, Compiling Executing
@node Compiler errors
@section Compiler errors
The @code{Check file}, @code{Compile file}, and @code{Build} commands
......@@ -366,7 +366,7 @@ Some error messages might also include references to other files. These
references are also clickable in the same way, or put point after the
line number and press @key{RET}.
@node Project files, Compiling Examples, Compiling Executing, Top
@node Project files
@chapter Project files
An Emacs Ada mode project file specifies what directories hold sources
......@@ -385,7 +385,7 @@ an Emacs Ada mode project file.
* Project file variables::
@end menu
@node Project File Overview, GUI Editor, Project files, Project files
@node Project File Overview
@section Project File Overview
Project files have a simple syntax; they may be edited directly. Each
......@@ -450,7 +450,7 @@ file extension; if it is @code{.gpr}, the file is treated as a GNAT
project file. Any other extension is treated as an Emacs Ada mode
project file.
@node GUI Editor, Project file variables, Project File Overview, Project files
@node GUI Editor
@section GUI Editor
The project file editor is invoked with the menu @samp{Ada | Projects
......@@ -461,7 +461,7 @@ modification using the @samp{[save]} button at the bottom of the
buffer, or the @kbd{C-x C-s} binding. To cancel your modifications,
kill the buffer or click on the @samp{[cancel]} button.
@node Project file variables, , GUI Editor, Project files
@node Project file variables
@section Project file variables
The following variables can be defined in a project file; some can
......@@ -648,7 +648,7 @@ commands and source navigation.
@end table
@node Compiling Examples, Moving Through Ada Code, Project files, Top
@node Compiling Examples
@chapter Compiling Examples
We present several small projects, and walk thru the process of
......@@ -670,7 +670,7 @@ website mentioned in @xref{Installation}.
* Use multiple GNAT project files::
@end menu
@node No project files, Set compiler options, Compiling Examples, Compiling Examples
@node No project files
@section No project files
This example uses no project files.
......@@ -836,7 +836,7 @@ Invoke @samp{Ada | Project | Load}, and load a project file that specifies @code
@end enumerate
@node Set compiler options, Set source search path, No project files, Compiling Examples
@node Set compiler options
@section Set compiler options
This example illustrates using an Emacs Ada mode project file to set a
......@@ -898,7 +898,7 @@ used to set the compiler options.
Fixing the error, linking and running the code proceed as in @ref{No
project files}.
@node Set source search path, Use GNAT project file, Set compiler options, Compiling Examples
@node Set source search path
@section Set source search path
In this example, we show how to deal with files in more than one
......@@ -982,7 +982,7 @@ compiler error message.
Fixing the error, linking and running the code proceed as in @ref{No
project files}.
@node Use GNAT project file, Use multiple GNAT project files, Set source search path, Compiling Examples
@node Use GNAT project file
@section Use GNAT project file
In this example, we show how to use a GNAT project file, with no Ada
......@@ -1061,7 +1061,7 @@ set the compiler options.
Fixing the error, linking and running the code proceed as in @ref{No
project files}.
@node Use multiple GNAT project files, , Use GNAT project file, Compiling Examples
@node Use multiple GNAT project files
@section Use multiple GNAT project files
In this example, we show how to use multiple GNAT project files,
......@@ -1125,7 +1125,7 @@ Now type @kbd{C-x `}. @file{Example_4/hello_pkg.adb} is shown,
demonstrating that @file{hello_5.gpr} and @file{hello_4.gpr} are being
used to set the compilation search path.
@node Moving Through Ada Code, Identifier completion, Compiling Examples, Top
@node Moving Through Ada Code
@chapter Moving Through Ada Code
There are several easy to use commands to navigate through Ada code. All
......@@ -1179,7 +1179,7 @@ If the @code{ada-xref-create-ali} variable is non-@code{nil}, Emacs
will try to run GNAT for you whenever cross-reference information is
needed, and is older than the current source file.
@node Identifier completion, Automatic Smart Indentation, Moving Through Ada Code, Top
@node Identifier completion
@chapter Identifier completion
Emacs and Ada mode provide two general ways for the completion of
......@@ -1224,7 +1224,7 @@ Complete current identifier using cross-reference information.
Complete identifier using buffer information (not Ada-specific).
@end table
@node Automatic Smart Indentation, Formatting Parameter Lists, Identifier completion, Top
@node Automatic Smart Indentation
@chapter Automatic Smart Indentation
Ada mode comes with a full set of rules for automatic indentation. You
......@@ -1301,7 +1301,7 @@ Indent the current line and display the name of the variable used for
indentation.
@end table
@node Formatting Parameter Lists, Automatic Casing, Automatic Smart Indentation, Top
@node Formatting Parameter Lists
@chapter Formatting Parameter Lists
@table @kbd
......@@ -1314,7 +1314,7 @@ This aligns the declarations on the colon (@samp{:}) separating
argument names and argument types, and aligns the @code{in},
@code{out} and @code{in out} keywords.
@node Automatic Casing, Statement Templates, Formatting Parameter Lists, Top
@node Automatic Casing
@chapter Automatic Casing
Casing of identifiers, attributes and keywords is automatically
......@@ -1403,7 +1403,7 @@ Rereads the exception dictionary from the file
@code{ada-case-exception-file} (@code{ada-case-read-exceptions}).
@end table
@node Statement Templates, Comment Handling, Automatic Casing, Top
@node Statement Templates
@chapter Statement Templates
Templates are defined for most Ada statements, using the Emacs
......@@ -1494,7 +1494,7 @@ exception (@code{ada-exception}).
type (@code{ada-type}).
@end table
@node Comment Handling, GNU Free Documentation License, Statement Templates, Top
@node Comment Handling
@chapter Comment Handling
By default, comment lines get indented like Ada code. There are a few
......@@ -1513,11 +1513,11 @@ Uncomment the selected region
autofill the current comment.
@end table
@node GNU Free Documentation License, Index, Comment Handling, Top
@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include doclicense.texi
@node Index, , GNU Free Documentation License, Top
@node Index
@unnumbered Index
@printindex fn
......
......@@ -44,7 +44,7 @@ modify this GNU manual.''
@contents
@ifnottex
@node Top, Overview, (dir), (dir)
@node Top
@top Ebrowse
You can browse C++ class hierarchies from within Emacs by using
......@@ -67,7 +67,7 @@ Ebrowse.
@node Overview, Generating browser files, Top, Top
@node Overview
@chapter Introduction
When working in software projects using C++, I frequently missed
......@@ -177,8 +177,7 @@ them, if you like.
@node Generating browser files, Loading a Tree, Overview, Top
@comment node-name, next, previous, up
@node Generating browser files
@chapter Processing Source Files
@cindex @command{ebrowse}, the program
......@@ -225,7 +224,7 @@ available command line options.@refill
@comment name, next, prev, up
@node Input files, Output file, Generating browser files, Generating browser files
@node Input files
@section Specifying Input Files
@table @samp
......@@ -266,7 +265,7 @@ properly identifying friend functions of a class.
@comment name, next, prev, up
@node Output file, Structs and unions, Input files, Generating browser files
@node Output file
@section Changing the Output File Name
@table @samp
......@@ -301,7 +300,7 @@ with this command line option.
@comment name, next, prev, up
@node Structs and unions, Matching, Output file, Generating browser files
@node Structs and unions
@section Structs and Unions
@cindex structs
@cindex unions
......@@ -321,7 +320,7 @@ tree.
@comment name, next, prev, up
@node Matching, Verbosity, Structs and unions, Generating browser files
@node Matching
@section Regular Expressions
@cindex regular expressions, recording
......@@ -374,8 +373,7 @@ the probability that it will no longer match after editing the file.
@node Verbosity, , Matching, Generating browser files
@comment node-name, next, previous, up
@node Verbosity
@section Verbose Mode
@cindex verbose operation
......@@ -395,8 +393,7 @@ the names of the classes seen.
@node Loading a Tree, Tree Buffers, Generating browser files, Top
@comment node-name, next, previous, up
@node Loading a Tree
@chapter Starting to Browse
@cindex loading
@cindex browsing
......@@ -436,8 +433,7 @@ where no highlight is displayed.
@comment ***
@comment ****************************************************************
@node Tree Buffers, Member Buffers, Loading a Tree, Top
@comment node-name, next, previous, up
@node Tree Buffers
@chapter Tree Buffers
@cindex tree buffer mode
@cindex class trees
......@@ -468,8 +464,7 @@ buffers.
@node Source Display, Member Display, Tree Buffers, Tree Buffers
@comment node-name, next, previous, up
@node Source Display
@section Viewing and Finding Class Declarations
@cindex viewing, class
@cindex finding a class
......@@ -497,8 +492,7 @@ The same functionality is available from the menu opened with
@node Member Display, Go to Class, Source Display, Tree Buffers
@comment node-name, next, previous, up
@node Member Display
@section Displaying Members
@cindex @samp{*Members*} buffer
@cindex @samp{*Globals*}
......@@ -561,8 +555,7 @@ These lists are also available from the class' context menu invoked with
@node Go to Class, Quitting, Member Display, Tree Buffers
@comment node-name, next, previous, up
@node Go to Class
@section Finding a Class
@cindex locate class
@cindex expanding branches
......@@ -589,8 +582,7 @@ local copy of the regular expression last searched in it.
@node Quitting, File Name Display, Go to Class, Tree Buffers
@comment node-name, next, previous, up
@node Quitting
@section Burying a Tree Buffer
@cindex burying tree buffer
......@@ -602,8 +594,7 @@ Is a synonym for @kbd{M-x bury-buffer}.
@node File Name Display, Expanding and Collapsing, Quitting, Tree Buffers
@comment node-name, next, previous, up
@node File Name Display
@section Displaying File Names
@table @kbd
......@@ -633,8 +624,7 @@ Here is an example of a tree buffer with file names displayed.
@end example
@node Expanding and Collapsing, Tree Indentation, File Name Display, Tree Buffers
@comment node-name, next, previous, up
@node Expanding and Collapsing
@section Expanding and Collapsing a Tree
@cindex expand tree branch
@cindex collapse tree branch
......@@ -673,8 +663,7 @@ This command expands all collapsed branches in the tree.
@node Tree Indentation, Killing Classes, Expanding and Collapsing, Tree Buffers
@comment node-name, next, previous, up
@node Tree Indentation
@section Changing the Tree Indentation
@cindex tree indentation
@cindex indentation of the tree
......@@ -689,8 +678,7 @@ available from the tree buffer's context menu.
@node Killing Classes, Saving a Tree, Tree Indentation, Tree Buffers
@comment node-name, next, previous, up
@node Killing Classes
@section Removing Classes from the Tree
@cindex killing classes
@cindex class, remove from tree
......@@ -705,9 +693,7 @@ deletion is actually performed.
@node Saving a Tree, Statistics, Killing Classes, Tree Buffers
@comment node-name, next, previous, up
@comment node-name, next, previous, up
@node Saving a Tree
@section Saving a Tree
@cindex save tree to a file
@cindex tree, save to a file
......@@ -725,8 +711,8 @@ Writes the tree to a file whose name is read from the minibuffer.
@node Statistics, Marking Classes, Saving a Tree, Tree Buffers
@comment node-name, next, previous, up
@node Statistics
@section Statistics
@cindex statistics for a tree
@cindex tree statistics
@cindex class statistics
......@@ -741,8 +727,8 @@ context menu.
@node Marking Classes, , Statistics, Tree Buffers
@comment node-name, next, previous, up
@node Marking Classes
@section Marking Classes
@cindex marking classes
@cindex operations on marked classes
......@@ -783,8 +769,7 @@ display, like in the following example
@c ***
@c ****************************************************************
@node Member Buffers, Tags-like Functions, Tree Buffers, Top
@comment node-name, next, previous, up
@node Member Buffers
@chapter Member Buffers
@cindex members
@cindex member buffer mode
......@@ -834,8 +819,7 @@ buffer: members, classes, and the buffer itself.
@node Switching Member Lists, Finding/Viewing, Member Buffers, Member Buffers
@comment node-name, next, previous, up
@node Switching Member Lists
@section Switching Member Lists
@cindex member lists, in member buffers
@cindex static members
......@@ -881,8 +865,7 @@ context menu.
@node Finding/Viewing, Inherited Members, Switching Member Lists, Member Buffers
@comment node-name, next, previous, up
@node Finding/Viewing
@section Finding and Viewing Member Source
@cindex finding members, in member buffers
@cindex viewing members, in member buffers
......@@ -919,8 +902,7 @@ displayed when clicking @kbd{Mouse-2} on a member name.
@node Inherited Members, Searching Members, Finding/Viewing, Member Buffers
@comment node-name, next, previous, up
@node Inherited Members
@section Display of Inherited Members
@cindex superclasses, members
@cindex base classes, members
......@@ -935,8 +917,7 @@ buffer. This is also in the buffer's context menu.
@node Searching Members, Switching to Tree, Inherited Members, Member Buffers
@comment node-name, next, previous, up
@node Searching Members
@section Searching Members
@cindex searching members
......@@ -965,8 +946,7 @@ a mouse.
@node Switching to Tree, Filters, Searching Members, Member Buffers
@comment node-name, next, previous, up
@node Switching to Tree
@section Switching to Tree Buffer
@cindex tree buffer, switch to
@cindex buffer switching
......@@ -984,8 +964,7 @@ displayed in the member buffer.
@node Filters, Attributes, Switching to Tree, Member Buffers
@comment node-name, next, previous, up
@node Filters
@section Filters
@cindex filters
......@@ -1029,8 +1008,7 @@ These commands are also found in the buffer's context menu.
@node Attributes, Long and Short Display, Filters, Member Buffers
@comment node-name, next, previous, up
@node Attributes
@section Displaying Member Attributes
@cindex attributes
@cindex member attribute display
......@@ -1086,8 +1064,7 @@ This command is also in the buffer's context menu.
@node Long and Short Display, Regexp Display, Attributes, Member Buffers
@comment node-name, next, previous, up
@node Long and Short Display
@section Long and Short Member Display
@cindex display form
@cindex long display
......@@ -1121,8 +1098,7 @@ not been produced with the @command{ebrowse} option @samp{--no-regexps}.
@node Regexp Display, Switching Classes, Long and Short Display, Member Buffers
@comment node-name, next, previous, up
@node Regexp Display
@section Display of Regular Expressions
@cindex regular expression display
......@@ -1140,8 +1116,7 @@ see @ref{Matching, --no-regexps, Regular Expressions}.
@node Switching Classes, Killing/Burying, Regexp Display, Member Buffers
@comment node-name, next, previous, up
@node Switching Classes
@section Displaying Another Class
@cindex base class, display
@cindex derived class, display
......@@ -1173,8 +1148,7 @@ Switch to the next sibling of the class in the class tree.
@node Killing/Burying, Column Width, Switching Classes, Member Buffers
@comment node-name, next, previous, up
@node Killing/Burying
@section Burying a Member Buffer
@cindex burying member buffers
......@@ -1186,8 +1160,7 @@ This command is a synonym for @kbd{M-x bury-buffer}.
@node Column Width, Redisplay, Killing/Burying, Member Buffers
@comment node-name, next, previous, up
@node Column Width
@section Setting the Column Width
@cindex column width
@cindex member indentation
......@@ -1202,8 +1175,7 @@ This command sets the column width depending on the display form used
@node Redisplay, Getting Help, Column Width, Member Buffers
@comment node-name, next, previous, up
@node Redisplay
@section Forced Redisplay
@cindex redisplay of member buffers
......@@ -1218,8 +1190,8 @@ columns.
@node Getting Help, , Redisplay, Member Buffers
@comment node-name, next, previous, up
@node Getting Help
@section Getting Help
@cindex help
@table @kbd
......@@ -1234,8 +1206,7 @@ This key is bound to @code{describe-mode}.
@comment *** TAGS LIKE FUNCTIONS
@comment **************************************************************
@node Tags-like Functions, GNU Free Documentation License, Member Buffers, Top
@comment node-name, next, previous, up
@node Tags-like Functions
@chapter Tags-like Functions
Ebrowse provides tags functions similar to those of the standard
......@@ -1254,8 +1225,7 @@ Emacs Tags facility, but better suited to the needs of C++ programmers.
@node Finding and Viewing, Position Stack, Tags-like Functions, Tags-like Functions
@comment node-name, next, previous, up
@node Finding and Viewing
@section Finding and Viewing Members
@cindex finding class member, in C++ source
@cindex viewing class member, in C++ source
......@@ -1314,8 +1284,7 @@ View a member's declaration in another frame.
@node Position Stack, Search & Replace, Finding and Viewing, Tags-like Functions
@comment node-name, next, previous, up
@node Position Stack
@section The Position Stack
@cindex position stack
......@@ -1351,8 +1320,7 @@ view a position with @kbd{v}.
@node Search & Replace, Members in Files, Position Stack, Tags-like Functions
@comment node-name, next, previous, up
@node Search & Replace
@section Searching and Replacing
@cindex searching multiple C++ files
@cindex replacing in multiple C++ files
......@@ -1389,8 +1357,7 @@ This restarts the last tags operation with the next file in the list.
@node Members in Files, Apropos, Search & Replace, Tags-like Functions
@comment node-name, next, previous, up
@node Members in Files
@section Members in Files
@cindex files
@cindex members in file, listing
......@@ -1403,8 +1370,7 @@ name is read from the minibuffer with completion.
@node Apropos, Symbol Completion, Members in Files, Tags-like Functions
@comment node-name, next, previous, up
@node Apropos
@section Member Apropos
@cindex apropos on class members
@cindex members, matching regexp
......@@ -1421,8 +1387,7 @@ command @kbd{C-c C-m f}, for example, to jump to a specific member.
@node Symbol Completion, Member Buffer Display, Apropos, Tags-like Functions
@comment node-name, next, previous, up
@node Symbol Completion
@section Symbol Completion
@cindex completion