(1) new Appendix, Renamed Commands;

(2) new leading subsection, Contributors to GDB

gdb/doc/gdb.texinfo

@@ -116,7 +116,38 @@ original English.
 @end titlepage
 @page
 
-@node Top, New Features, (dir), (dir)
+@node Top, Summary, (dir), (dir)
+@ifinfo
+This file describes version 4.0 of GDB, the GNU symbolic debugger.
+@end ifinfo
+
+@menu
+* Summary::			Summary of _GDBN__
+* New Features::		New Features in _GDBN__ version 4.0
+* Sample Session::		A Sample _GDBN__ Session
+* Invocation::			Getting In and Out of _GDBN__
+* Commands::			_GDBN__ Commands
+* Running::			Running Programs Under _GDBN__
+* Stopping::			Stopping and Continuing
+* Stack::			Examining the Stack
+* Source::			Examining Source Files
+* Data::			Examining Data
+* Symbols::			Examining the Symbol Table
+* Altering::			Altering Execution
+* _GDBN__ Files::		_GDBN__'s Files
+* Targets::			Specifying a Debugging Target 
+* Controlling _GDBN__::		Controlling _GDBN__
+* Sequences::			Canned Sequences of Commands
+* Emacs::			Using _GDBN__ under GNU Emacs
+* _GDBN__ Bugs::		Reporting Bugs in _GDBN__
+* Renamed Commands::		_GDBN__ 4.0 Renamed Commands
+* Installing _GDBN__::		Installing _GDBN__
+* Copying::			GNU GENERAL PUBLIC LICENSE
+* Index::			Index
+
+@end menu
+
+@node Summary, New Features, Top, Top
 @unnumbered Summary of _GDBN__
 
 The purpose of a debugger such as _GDBN__ is to allow you to see what is
@@ -145,6 +176,12 @@ _GDBN__ can be used to debug programs written in C and C++.  Pascal support
 is being implemented, and Fortran support will be added when a GNU
 Fortran compiler is ready.
 
+@menu
+* Free Software::		Free Software
+* Contributors::		Contributors to GDB
+@end menu
+
+@node Free Software, Contributors, Summary, Summary
 @unnumberedsec Free Software
 _GDBN__ is @dfn{free software}, protected by the GNU General Public License (GPL).
 The GPL gives you the freedom to copy or adapt a licensed
@@ -159,31 +196,74 @@ you have these freedoms and that you can't take these freedoms away
 from anyone else.
 
 For full details, @pxref{Copying}.
+@node Contributors,  , Free Software, Summary
+@unnumberedsec Contributors to GDB
 
-@menu
+Richard Stallman was the original author of GDB, as with many GNU
-* New Features::                New Features in _GDBN__ version 4.0
+programs.  Many others have contributed to its development.  This
-* Sample Session::              A Sample _GDBN__ Session
+section attempts to credit major contributors.  One of the virtues of
-* Invocation::                  Getting In and Out of _GDBN__
+free software is that everyone is free to contribute to it; with
-* Commands::                    _GDBN__ Commands
+regret, we cannot actually acknowledge everyone here.  The file
-* Running::                     Running Programs Under _GDBN__
+@file{ChangeLog} in the GDB distribution approximates a blow-by-blow
-* Stopping::                    Stopping and Continuing
+account.
-* Stack::                       Examining the Stack
-* Source::                      Examining Source Files
-* Data::                        Examining Data
-* Symbols::                     Examining the Symbol Table
-* Altering::                    Altering Execution
-* GDB Files::                   _GDBN__'s Files
-* Targets::                     Specifying a Debugging Target 
-* Controlling _GDBN__::         Controlling _GDBN__
-* Sequences::                   Canned Sequences of Commands
-* Emacs::                       Using _GDBN__ under GNU Emacs
-* _GDBN__ Bugs::                Reporting Bugs in _GDBN__
-* Installing _GDBN__::          Installing _GDBN__
-* Copying::                     GNU GENERAL PUBLIC LICENSE
-* Index::                       Index
-@end menu
 
-@node New Features, Sample Session, Top, Top
+Changes much prior to version 2.0 are lost in the mists of time.
+
+@quotation
+@emph{Plea:} Additions to this section are particularly welcome.  If you
+or your friends (or enemies; let's be evenhanded) have been unfairly
+omitted from this list, we would like to add your names!
+@end quotation
+
+So that they may not regard their long labor as thankless, we
+particularly thank those who shepherded GDB through major releases:
+John Gilmore (release 4.0); Jim Kingdon (releases 3.9, 3.5, 3.4, 3.3);
+and Randy Smith (releases 3.2, 3.1, 3.0).  As major maintainer of GDB
+for some period, each contributed significantly to the structure,
+stability, and capabilities of the entire debugger.
+
+Richard Stallman, assisted at various times by Pete TerMaat, Chris
+Hanson, and Richard Mlynarik, handled releases through 2.8.
+
+Michael Tiemann is the author of most of the GNU C++ support in GDB,
+with significant additional contributions from Per Bothner.  James
+Clark wrote the GNU C++ demangler.  Early work on C++ was by Peter
+TerMaat (who also did much general update work leading to release 3.0).
+
+GDB 4.0 uses the BFD subroutine library to examine multiple
+object-file formats; BFD was a joint project of V. Gumby
+Henkel-Wallace, Rich Pixley, Steve Chamberlain, and John Gilmore.
+
+David Johnson wrote the original COFF support; Pace Willison did
+the original support for encapsulated COFF.
+
+Adam de Boor and Bradley Davis contributed the ISI Optimum V support.
+Per Bothner, Noboyuki Hikichi, and Alessandro Forin contributed MIPS
+support.  Jean-Daniel Fekete contributed Sun 386i support.  Chris
+Hanson improved the HP9000 support.  Noboyuki Hikichi and Tomoyuki
+Hasei contributed Sony/News OS 3 support.  David Johnson contributed
+Encore Umax support.  Jyrki Kuoppala contributed Altos 3068 support.
+Keith Packard contributed NS32K support.  Doug Rabson contributed
+Acorn Risc Machine support.  Chris Smith contributed Convex support
+(and Fortran debugging).  Jonathan Stone contributed Pyramid support.
+Michael Tiemann contributed SPARC support.  Tim Tucker contributed
+support for the Gould NP1 and Gould Powernode.  Pace Willison
+contributed Intel 386 support.  Jay Vosburgh contributed Symmetry
+support.
+
+Rich Schaefer helped with support of SunOS shared libraries.
+
+Jay Fenlason and Roland McGrath ensured that GDB and GAS agree about
+several machine instruction sets.
+
+Patrick Duval, Ted Goldstein, Vikram Koka and Glenn Engel helped
+develop remote debugging.  Intel Corporation and Wind River Systems
+contributed remote debugging modules for their products.
+
+Brian Fox is the author of the readline libraries providing
+command-line editing and command history.
+
+@node New Features, Sample Session, Summary, Top
 @unnumbered New Features in _GDBN__ version 4.0
 
 @table @emph
@@ -232,6 +312,13 @@ before the stack is peeled back to the exception handler's context.  You
 can suppress output of machine-level addresses, displaying only source
 language information.
 
+@item Command Rationalization
+Many _GDBN__ commands have been renamed to make them easier to remember
+and use.  In particular, the subcommands of @code{info} and
+@code{show}/@code{set} are grouped to make the former refer to the state
+of your program, and the latter refer to the state of _GDBN__ itself.
+@xref{Renamed Commands}, for details on what commands were renamed.
+
 @item Ports
 _GDBN__ has been ported to the following new architectures: AT&T 3b1,
 Acorn RISC machine, HP300 running HPUX, big- and little-endian MIPS
@@ -552,9 +639,9 @@ in sequential order.  The order makes a difference when the
 @menu
 * File Options::		Choosing Files
 * Mode Options::		Choosing Modes
-* i960-Nindy Remote::           _GDBN__ with a Remote i960 (Nindy)
+* i960-Nindy Remote::		
-* EB29K Remote::                _GDBN__ with a Remote EB29K
+* EB29K Remote::		
-* VxWorks Remote::              _GDBN__ and VxWorks
+* VxWorks Remote::		
 @end menu
 
 @node File Options, Mode Options, Starting _GDBN__, Starting _GDBN__
@@ -1684,7 +1771,7 @@ enable it again.
 * Disabling::			Disabling Breakpoints
 * Conditions::			Break Conditions
 * Break Commands::		Breakpoint Command Lists
-* Error in Breakpoints::        ``Cannot Insert Breakpoints''
+* Error in Breakpoints::	
 @end menu
 
 @node Set Breaks, Set Watchpoints, Breakpoints, Breakpoints
@@ -4001,7 +4088,7 @@ Write a complete dump of the debugger's symbol data into the
 file @var{filename}.
 @end table
 
-@node Altering, GDB Files, Symbols, Top
+@node Altering, _GDBN__ Files, Symbols, Top
 @chapter Altering Execution
 
 Once you think you have found an error in the program, you might want to
@@ -4184,7 +4271,7 @@ execute a function from your program, but without cluttering the output
 with @code{void} returned values.  The result is printed and saved in
 the value history, if it is not void.
 
-@node GDB Files, Targets, Altering, Top
+@node _GDBN__ Files, Targets, Altering, Top
 @chapter _GDBN__'s Files
 
 @menu
@@ -4192,7 +4279,7 @@ the value history, if it is not void.
 * Symbol Errors::		Errors Reading Symbol Files
 @end menu
 
-@node Files, Symbol Errors, GDB Files, GDB Files
+@node Files, Symbol Errors, _GDBN__ Files, _GDBN__ Files
 @section Commands to Specify Files
 @cindex core dump file
 @cindex symbol table
@@ -4384,7 +4471,7 @@ Print the names of the shared libraries which are currently loaded.
 @code{sharedlibrary} does not repeat automatically when you press
 @key{RET} after using it once.
 
-@node Symbol Errors,  , Files, GDB Files
+@node Symbol Errors,  , Files, _GDBN__ Files
 @section Errors Reading Symbol Files
 While a symbol file is being read, _GDBN__ will occasionally encounter
 problems, such as symbol types it does not recognize, or known bugs in
@@ -4477,7 +4564,7 @@ for some C++ object.
 
 @end table
 
-@node     Targets, Controlling _GDBN__, GDB Files, Top
+@node     Targets, Controlling _GDBN__, _GDBN__ Files, Top
 @chapter Specifying a Debugging Target 
 @cindex debugging target
 @kindex target
@@ -5294,7 +5381,7 @@ environment.  Users of this environment can use a new command,
 each value is printed in its own window.
 @end ignore
 
-@node _GDBN__ Bugs, Installing _GDBN__, Emacs, Top
+@node _GDBN__ Bugs, Renamed Commands, Emacs, Top
 @c  node-name,  next,  previous,  up
 @chapter Reporting Bugs in _GDBN__
 @cindex Bugs in _GDBN__
@@ -5518,7 +5605,115 @@ things without first using the debugger to find the facts.
 @include readline/inc-history.texinfo
 @end iftex
 
-@node Installing _GDBN__, Copying, _GDBN__ Bugs, Top
+@node Renamed Commands, Installing _GDBN__, _GDBN__ Bugs, Top
+@appendix _GDBN__ 4.0 Renamed Commands
+
+The following commands were renamed in _GDBN__ 4.0, in order to make the
+command set as a whole more consistent and easier to use and remember:
+
+@kindex add-syms                   
+@kindex delete environment         
+@kindex info copying               
+@kindex info convenience           
+@kindex info directories           
+@kindex info editing               
+@kindex info history               
+@kindex info targets               
+@kindex info values                
+@kindex info version               
+@kindex info warranty              
+@kindex set addressprint      
+@kindex set arrayprint        
+@kindex set prettyprint       
+@kindex set screen-height     
+@kindex set screen-width      
+@kindex set unionprint        
+@kindex set vtblprint         
+@kindex set demangle          
+@kindex set asm-demangle      
+@kindex set sevenbit-strings  
+@kindex set array-max         
+@kindex set caution           
+@kindex set history write     
+@kindex show addressprint      
+@kindex show arrayprint        
+@kindex show prettyprint       
+@kindex show screen-height     
+@kindex show screen-width      
+@kindex show unionprint        
+@kindex show vtblprint         
+@kindex show demangle          
+@kindex show asm-demangle      
+@kindex show sevenbit-strings  
+@kindex show array-max         
+@kindex show caution           
+@kindex show history write     
+@kindex unset                      
+
+@ifinfo
+OLD COMMAND                NEW COMMAND
+---------------            ----------------------------------
+add-syms                   add-symbol-file
+delete environment         unset environment
+info convenience           show convenience
+info copying               show copying
+info directories           show directories     
+info editing               show commands
+info history               show values
+info targets               help target
+info values                show values
+info version               show version
+info warranty              show warranty
+set/show addressprint      set/show print address
+set/show array-max         set/show print elements
+set/show arrayprint        set/show print array
+set/show asm-demangle      set/show print asm-demangle
+set/show caution           set/show confirm
+set/show demangle          set/show print demangle
+set/show history write     set/show history save
+set/show prettyprint       set/show print pretty
+set/show screen-height     set/show height
+set/show screen-width      set/show width
+set/show sevenbit-strings  set/show print sevenbit-strings
+set/show unionprint        set/show print union
+set/show vtblprint         set/show print vtbl
+
+unset                      [ No longer an alias for delete ]
+@end ifinfo
+
+@tex
+\halign{\tt # &\qquad#&\tt #\cr
+{\bf Old Command}         &&{\bf New Command}\cr
+add-syms                  &&add-symbol-file\cr
+delete environment        &&unset environment\cr
+info convenience          &&show convenience\cr
+info copying              &&show copying\cr
+info directories          &&show directories     \cr
+info editing              &&show commands\cr
+info history              &&show values\cr
+info targets              &&help target\cr
+info values               &&show values\cr
+info version              &&show version\cr
+info warranty             &&show warranty\cr
+set{\rm / }show addressprint     &&set{\rm / }show print address\cr
+set{\rm / }show array-max        &&set{\rm / }show print elements\cr
+set{\rm / }show arrayprint       &&set{\rm / }show print array\cr
+set{\rm / }show asm-demangle     &&set{\rm / }show print asm-demangle\cr
+set{\rm / }show caution          &&set{\rm / }show confirm\cr
+set{\rm / }show demangle         &&set{\rm / }show print demangle\cr
+set{\rm / }show history write    &&set{\rm / }show history save\cr
+set{\rm / }show prettyprint      &&set{\rm / }show print pretty\cr
+set{\rm / }show screen-height    &&set{\rm / }show height\cr
+set{\rm / }show screen-width     &&set{\rm / }show width\cr
+set{\rm / }show sevenbit-strings &&set{\rm / }show print sevenbit-strings\cr
+set{\rm / }show unionprint       &&set{\rm / }show print union\cr
+set{\rm / }show vtblprint        &&set{\rm / }show print vtbl\cr
+\cr
+unset                     &&\rm(No longer an alias for delete)\cr
+}
+@end tex
+
+@node Installing _GDBN__, Copying, Renamed Commands, Top
 @appendix Installing _GDBN__
 @cindex configuring _GDBN__
 @cindex installation