]> code.delx.au - gnu-emacs/blobdiff - doc/misc/ebrowse.texi
Merge from emacs-24; up to 2012-12-17T11:17:34Z!rgm@gnu.org
[gnu-emacs] / doc / misc / ebrowse.texi
index 86cae35a6f49de732661751861fd358ef63ec350..c7f3e3b1a61db827e0295b0f56ebc6b9fca14ba8 100644 (file)
@@ -10,8 +10,7 @@
 @copying
 This file documents Ebrowse, a C++ class browser for GNU Emacs.
 
-Copyright @copyright{} 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007,
-2008, 2009, 2010  Free Software Foundation, Inc.
+Copyright @copyright{} 2000--2013 Free Software Foundation, Inc.
 
 @quotation
 Permission is granted to copy, distribute and/or modify this document
@@ -22,12 +21,11 @@ and with the Back-Cover Texts as in (a) below.  A copy of the license
 is included in the section entitled ``GNU Free Documentation License''.
 
 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
-modify this GNU manual.  Buying copies from the FSF supports it in
-developing GNU and promoting software freedom.''
+modify this GNU manual.''
 @end quotation
 @end copying
 
-@dircategory Emacs
+@dircategory Emacs misc features
 @direntry
 * Ebrowse: (ebrowse).           A C++ class browser for Emacs.
 @end direntry
@@ -46,7 +44,8 @@ developing GNU and promoting software freedom.''
 @contents
 
 @ifnottex
-@node Top, Overview, (dir), (dir)
+@node Top
+@top Ebrowse
 
 You can browse C++ class hierarchies from within Emacs by using
 Ebrowse.
@@ -68,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
@@ -149,7 +148,7 @@ importantly you can find or view member declarations and definitions
 with a keystroke.  @xref{Member Buffers}.
 
 These two buffer types and the commands they provide support the
-navigational use of the browser.  The second form resembles Emacs' Tags
+navigational use of the browser.  The second form resembles Emacs's Tags
 package for C and other procedural languages.  Ebrowse's commands of
 this type are not confined to special buffers; they are most often used
 while you are editing your source code.
@@ -178,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
@@ -226,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
@@ -267,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
@@ -302,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
@@ -322,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
@@ -375,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
 
@@ -396,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
@@ -437,15 +433,14 @@ 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
 
 Class trees are displayed in @dfn{tree buffers} which install their own
 major mode.  Most Emacs keys work in tree buffers in the usual way,
-e.g.@: you can move around in the buffer with the usual @kbd{C-f},
+e.g., you can move around in the buffer with the usual @kbd{C-f},
 @kbd{C-v} etc., or you can search with @kbd{C-s}.
 
 Tree-specific commands are bound to simple keystrokes, similar to
@@ -469,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
@@ -482,7 +476,7 @@ name.
 @table @kbd
 @item SPC
 This command views the class declaration if the database
-contains informations about it.  If you don't parse the entire source
+contains information about it.  If you don't parse the entire source
 you are working on, some classes will only be known to exist but the
 location of their declarations and definitions will not be known.@refill
 
@@ -498,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*}
@@ -562,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
@@ -590,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
 
@@ -603,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
@@ -634,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
@@ -674,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
@@ -690,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
@@ -706,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
@@ -726,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
@@ -742,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
 
@@ -784,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
@@ -835,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
@@ -882,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
@@ -920,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
@@ -936,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
 
@@ -953,7 +933,7 @@ the completion list.  If necessary, the current member list is switched
 to the one containing the member.
 
 With a prefix argument (@kbd{C-u}), all members in the class tree,
-i.e.@: all members the browser knows about appear in the completion
+i.e., all members the browser knows about appear in the completion
 list.  The member display will be switched to the class and member list
 containing the member.
 
@@ -966,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
@@ -985,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
 
@@ -1030,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
@@ -1087,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
@@ -1122,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
 
@@ -1141,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
@@ -1174,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
 
@@ -1187,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
@@ -1203,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
 
@@ -1219,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
@@ -1235,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
@@ -1255,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
@@ -1315,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
 
@@ -1333,7 +1301,7 @@ This command sets point to the previous position in the position stack.
 Directly after you performed a jump, this will put you back to the
 position where you came from.
 
-The stack is not popped, i.e.@: you can always switch back and forth
+The stack is not popped, i.e., you can always switch back and forth
 between positions in the stack.  To avoid letting the stack grow to
 infinite size there is a maximum number of positions defined.  When this
 number is reached, older positions are discarded when new positions are
@@ -1352,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
@@ -1390,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
@@ -1404,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
@@ -1415,15 +1380,14 @@ given regular expression.  This command can be very useful if you
 remember only part of a member name, and not its beginning.
 
 A special buffer is popped up containing all identifiers matching the
-regular expression, and what kind of symbol it is (e.g.@: a member
+regular expression, and what kind of symbol it is (e.g., a member
 function, or a type).  You can then switch to this buffer, and use the
 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
 @cindex symbol completion
@@ -1433,7 +1397,7 @@ The command @kbd{C-c C-m @key{TAB}} completes the symbol in front of point.
 
 
 
-@node Member Buffer Display, , Symbol Completion, Tags-like Functions
+@node Member Buffer Display
 @section Quick Member Display
 @cindex member buffer, for member at point
 
@@ -1441,17 +1405,13 @@ You can quickly display a member buffer containing the member the cursor
 in on with the command @kbd{C-c C-m m}.
 
 
-@node GNU Free Documentation License, Concept Index, Tags-like Functions, Top
+@node GNU Free Documentation License
 @appendix GNU Free Documentation License
 @include doclicense.texi
 
 
-@node Concept Index, , GNU Free Documentation License, Top
+@node Concept Index
 @unnumbered Concept Index
 @printindex cp
 
 @bye
-
-@ignore
-   arch-tag: 52fe78ac-a1c4-48e7-815e-0a31acfad4bf
-@end ignore