* gdb.texinfo: Fix mistakes noticed in printout of last

draft, add Alpha to discussion of heuristic fence post.

gdb/doc/ChangeLog

@@ -1,3 +1,8 @@
+Mon Feb  8 17:33:57 1999  Stan Shebs  <shebs@andros.cygnus.com>
+
+	* gdb.texinfo: Fix mistakes noticed in printout of last
+	draft, add Alpha to discussion of heuristic fence post.
+
 Fri Feb  5 17:20:00 1999  Stan Shebs  <shebs@andros.cygnus.com>
 
 	* gdb.texinfo, remote.texi: Many changes; update to Seventh

gdb/doc/gdb.texinfo

@@ -1,5 +1,5 @@
 \input texinfo      @c -*-texinfo-*-
-@c Copyright 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999
+@c Copyright 1988-1999
 @c Free Software Foundation, Inc.
 @c
 @c %**start of header 
@@ -56,8 +56,7 @@ This is the @value{EDITION} Edition, @value{DATE},
 of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger}
 for @value{GDBN} Version @value{GDBVN}.
 
-Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999
+Copyright (C) 1988-1999 Free Software Foundation, Inc.
-Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -103,7 +102,6 @@ into another language, under the above conditions for modified versions.
 \hfill (Send bugs and comments on @value{GDBN} to bug-gdb\@prep.ai.mit.edu.)\par
 \hfill {\it Debugging with @value{GDBN}}\par
 \hfill \TeX{}info \texinfoversion\par
-\hfill doc\@cygnus.com\par
 }
 @end tex
 @end ifclear
@@ -117,8 +115,7 @@ into another language, under the above conditions for modified versions.
 @end ifset
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999
+Copyright @copyright{} 1988-1999 Free Software Foundation, Inc. 
-Free Software Foundation, Inc. 
 @sp 2
 @ifclear HPPA
 Published by the Free Software Foundation @*
@@ -151,8 +148,7 @@ This file describes @value{GDBN}, the @sc{gnu} symbolic debugger.
 This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version 
 @value{GDBVN}.
 
-Copyright (C) 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1997, 1998, 1999
+Copyright (C) 1988-1999 Free Software Foundation, Inc.
-Free Software Foundation, Inc.
 @menu
 * Summary::                     Summary of @value{GDBN}
 @ifclear BARETARGET
@@ -272,9 +268,7 @@ Examining the Stack
 * Backtrace::                   Backtraces
 * Selection::                   Selecting a frame
 * Frame Info::                  Information on a frame
-@ifset MIPS
+* Alpha/MIPS Stack::            Alpha and MIPS machines and the function stack
-* MIPS Stack::                  MIPS machines and the function stack
-@end ifset
 
 Examining Source Files
 
@@ -551,16 +545,18 @@ 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:
+particularly thank those who shepherded @value{GDBN} through major
+releases:
+Jason Molenda (release 4.17),
 Stan Shebs (release 4.14),
-Fred Fish (releases 4.13, 4.12, 4.11, 4.10, and 4.9),
+Fred Fish (releases 4.16, 4.15, 4.13, 4.12, 4.11, 4.10, and 4.9),
 Stu Grossman and John Gilmore (releases 4.8, 4.7, 4.6, 4.5, and 4.4),
 John Gilmore (releases 4.3, 4.2, 4.1, 4.0, and 3.9);
 Jim Kingdon (releases 3.5, 3.4, and 3.3);
 and Randy Smith (releases 3.2, 3.1, and 3.0).
-As major maintainer of @value{GDBN} for some period, each
+As major maintainer of @value{GDBN} for some period, each contributed
-contributed significantly to the structure, stability, and capabilities
+significantly to the structure, stability, and capabilities of the
-of the entire debugger.
+entire debugger.
 
 Richard Stallman, assisted at various times by Peter TerMaat, Chris
 Hanson, and Richard Mlynarik, handled releases through 2.8.
@@ -708,7 +704,7 @@ $ @b{@value{GDBP} m4}
 There is absolutely no warranty for @value{GDBN}; type "show warranty" 
  for details.
 
-@value{GDBN} @value{GDBVN}, Copyright 1995 Free Software Foundation, Inc...
+@value{GDBN} @value{GDBVN}, Copyright 1999 Free Software Foundation, Inc...
 (@value{GDBP})
 @end smallexample
 @end ifclear
@@ -3844,9 +3840,7 @@ currently executing frame and describes it briefly, similar to the
 * Backtrace::                   Backtraces
 * Selection::                   Selecting a frame
 * Frame Info::                  Information on a frame
-@ifset MIPS
+* Alpha/MIPS Stack::            Alpha and MIPS machines and the function stack
-* MIPS Stack::                  MIPS machines and the function stack
-@end ifset
 
 @end menu
 
@@ -4069,14 +4063,8 @@ in @value{GDBN} command scripts, where the output might be unnecessary and
 distracting.
 @end table
 
-@ifset MIPS
+@node Frame Info, Alpha/MIPS Stack, Selection, Stack
-@node Frame Info, MIPS Stack, Selection, Stack
 @section Information about a frame
-@end ifset
-@ifclear MIPS
-@node Frame Info,  , Selection, Stack
-@section Information about a frame
-@end ifclear
 
 There are several other commands to print information about the selected
 stack frame.
@@ -4151,15 +4139,16 @@ exception handlers, visit the associated frame (using the @code{up},
 @end ifclear
 @end table
 
-@ifset MIPS
+@node Alpha/MIPS Stack,  , Frame Info, Stack
-@node MIPS Stack,  , Frame Info, Stack
+@section MIPS/Alpha machines and the function stack
-@section MIPS machines and the function stack
 
+@cindex stack on Alpha
 @cindex stack on MIPS
+@cindex Alpha stack
 @cindex MIPS stack
-MIPS based computers use an unusual stack frame, which sometimes
+Alpha- and MIPS-based computers use an unusual stack frame, which
-requires @value{GDBN} to search backward in the object code to find the
+sometimes requires @value{GDBN} to search backward in the object code to
-beginning of a function.
+find the beginning of a function.
 
 @cindex response time, MIPS debugging
 To improve response time (especially for embedded applications, where
@@ -4168,7 +4157,7 @@ you may want to limit the size of this search, using one of these
 commands:
 
 @table @code
-@cindex @code{heuristic-fence-post} (MIPS)
+@cindex @code{heuristic-fence-post} (Alpha,MIPS)
 @item set heuristic-fence-post @var{limit}
 Restrict @value{GDBN} to examining at most @var{limit} bytes in its search
 for the beginning of a function.  A value of @var{0} (the default)
@@ -4182,8 +4171,8 @@ Display the current limit.
 
 @noindent
 These commands are available @emph{only} when @value{GDBN} is configured
-for debugging programs on MIPS processors.
+for debugging programs on Alpha or MIPS processors.
-@end ifset
+
 
 @node Source, Data, Stack, Top
 @chapter Examining Source Files
@@ -5889,16 +5878,7 @@ Assembler source file.  This actually behaves almost like C, but
 @end table
 
 In addition, you may set the language associated with a filename
-extension.
+extension.  @xref{Show, , Displaying the language}.
-
-@kindex set extensions
-@kindex show extensions
-@table @code
-@item set extension-language @var{.ext} @var{language}
-
-@item info extensions
-
-@end table
 
 @node Manually, Automatically, Filenames, Setting
 @subsection Setting the working language
@@ -6005,8 +5985,8 @@ with a language explicitly:
 @kindex set extension-language
 @kindex info extensions
 @table @code
-@item set extension-language @var{ext} @var{language}
+@item set extension-language @var{.ext} @var{language}
-Set source files with extension @var{ext} to be assumed to be in
+Set source files with extension @var{.ext} to be assumed to be in
 the source language @var{language}.
 
 @item info extensions
@@ -8662,6 +8642,11 @@ W89K monitor, running on a Winbond HPPA board.
 @end ifclear
 @end table
 
+@ifset GENERIC
+Different targets are available on different configurations of @value{GDBN}; 
+your configuration may have more or fewer targets.
+@end ifset
+
 Many remote targets require you to download the executable's code
 once you've successfully established a connection.
 
@@ -8715,11 +8700,6 @@ opens it as the current executable target for @value{GDBN} on your host
 @code{load} does not repeat if you press @key{RET} again after using it.
 @end table
 
-@ifset GENERIC
-Different targets are available on different configurations of @value{GDBN}; 
-your configuration may have more or fewer targets.
-@end ifset
-
 @ifset REMOTESTUB
 @node Byte Order, Remote, Target Commands, Targets
 @section Choosing target byte order
@@ -8740,9 +8720,11 @@ GDB's idea of processor endian-ness manually.
 @table @code
 @kindex set endian big
 @item set endian big
+Instruct @value{GDBN} to assume the target is big-endian.
 
 @kindex set endian little
 @item set endian little
+Instruct @value{GDBN} to assume the target is little-endian.
 
 @kindex set endian auto
 @item set endian auto
@@ -9907,22 +9889,22 @@ on-line information and a printed manual.  You can use one of the Info
 formatting commands to create the on-line version of the documentation
 and @TeX{} (or @code{texi2roff}) to typeset the printed version.
 
-@value{GDBN} includes an already formatted copy of the on-line Info version of
+@value{GDBN} includes an already formatted copy of the on-line Info
-this manual in the @file{gdb} subdirectory.  The main Info file is
+version of this manual in the @file{gdb} subdirectory.  The main Info
-@file{gdb-@r{version-number}/gdb/gdb.info}, and it refers to
+file is @file{gdb-@value{GDBVN}/gdb/gdb.info}, and it refers to
 subordinate files matching @samp{gdb.info*} in the same directory.  If
 necessary, you can print out these files, or read them with any editor;
-but they are easier to read using the @code{info} subsystem in @sc{gnu} Emacs
+but they are easier to read using the @code{info} subsystem in @sc{gnu}
-or the standalone @code{info} program, available as part of the @sc{gnu}
+Emacs or the standalone @code{info} program, available as part of the
-Texinfo distribution.
+@sc{gnu} Texinfo distribution.
 
 If you want to format these Info files yourself, you need one of the
 Info formatting programs, such as @code{texinfo-format-buffer} or
 @code{makeinfo}.
 
-If you have @code{makeinfo} installed, and are in the top level @value{GDBN}
+If you have @code{makeinfo} installed, and are in the top level
-source directory (@file{gdb-@value{GDBVN}}, in the case of version @value{GDBVN}), you can
+@value{GDBN} source directory (@file{gdb-@value{GDBVN}}, in the case of
-make the Info file by typing:
+version @value{GDBVN}), you can make the Info file by typing:
 
 @example
 cd gdb
@@ -9951,11 +9933,13 @@ directory.
 If you have @TeX{} and a @sc{dvi} printer program installed, you can
 typeset and print this manual.  First switch to the the @file{gdb}
 subdirectory of the main source directory (for example, to
-@file{gdb-@value{GDBVN}/gdb}) and then type:
+@file{gdb-@value{GDBVN}/gdb}) and type:
 
 @example
 make gdb.dvi
 @end example
+
+Then give @file{gdb.dvi} to your @sc{dvi} printing program.
 @end ifclear
 
 @node Installing GDB, Index, Using History Interactively, Top