[PATCH] GDB docs is now under GFDL

Eli Zaretskii eliz@is.elta.co.il
Mon Mar 26 03:56:00 GMT 2001


FYI: I've just committed the attached patches, which place the GDB docs 
under the GNU Free Documentation License.  I also updated the copyright 
notices of the docs where appropriate.

Andrew, okay to remove the TODO item about GFDL?

2001-03-25  Eli Zaretskii  <eliz@is.elta.co.il>

	* gdbmi.texinfo: Update copyright.  Change Permissions to GFDL.


--- gdb/mi/gdbmi.t~3	Mon Oct 16 10:34:02 2000
+++ gdb/mi/gdbmi.texinfo	Sun Mar 25 22:17:14 2001
@@ -8,27 +8,19 @@
 @c  @ifinfo
 @c  This file documents GDB/MI, a Machine Interface to GDB.
 
-@c  Copyright (C) 2000, Free Software Foundation, Inc.
+@c  Copyright (C) 2000, 2001, Free Software Foundation, Inc.
 @c  Contributed by Cygnus Solutions.
 
-@c  Permission is granted to make and distribute verbatim copies of this
-@c  manual provided the copyright notice and this permission notice are
-@c  preserved on all copies.
-
-@c  @ignore
-@c  Permission is granted to process this file through TeX and print the
-@c  results, provided the printed document carries copying permission notice
-@c  identical to this one except for the removal of this paragraph (this
-@c  paragraph not being relevant to the printed manual).
-
-@c  @end ignore
-@c  Permission is granted to copy and distribute modified versions of this
-@c  manual under the conditions for verbatim copying, provided also that the
-@c  entire resulting derived work is distributed under the terms of a
-@c  permission notice identical to this one.
-
-@c  Permission is granted to copy and distribute translations of this manual
-@c  into another language, under the above conditions for modified versions.
+@c  Permission is granted to copy, distribute and/or modify this document
+@c  under the terms of the GNU Free Documentation License, Version 1.1 or
+@c  any later version published by the Free Software Foundation; with the
+@c  Invariant Sections being ``The GDB/MI Interface'' and ``GGDB/MI
+@c  Command Syntax'', with the Front-Cover texts being ``A GNU Manual,''
+@c  and with the Back-Cover Texts as in (a) below.
+
+@c  (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+@c  this GNU Manual, like GNU software.  Copies published by the Free
+@c  Software Foundation raise funds for GNU development.''
 @c  @end ifinfo
 
 @c  @c  This title page illustrates only one of the
@@ -36,19 +28,27 @@
 
 @c  @titlepage
 @c  @title GDB/MI
-@c  @subtitle Version 0.2
-@c  @subtitle Feb 2000
+@c  @subtitle Version 0.3
+@c  @subtitle Apr 2001
 @c  @author Andrew Cagney, Fernando Nasser and Elena Zannoni
 
 @c  @c  The following two commands
 @c  @c  start the copyright page.
 @c  @page
 @c  @vskip 0pt plus 1filll
-@c  Permission is granted to make and distribute verbatim copies of this
-@c  manual provided the copyright notice and this permission notice are
-@c  preserved on all copies.
 
-@c  Copyright @copyright{} 2000, Free Software Foundation, Inc.
+@c  Copyright @copyright{} 2000, 2001, Free Software Foundation, Inc.
+
+@c  Permission is granted to copy, distribute and/or modify this document
+@c  under the terms of the GNU Free Documentation License, Version 1.1 or
+@c  any later version published by the Free Software Foundation; with the
+@c  Invariant Sections being ``The GDB/MI Interface'' and ``GGDB/MI
+@c  Command Syntax'', with the Front-Cover texts being ``A GNU Manual,''
+@c  and with the Back-Cover Texts as in (a) below.
+
+@c  (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+@c  this GNU Manual, like GNU software.  Copies published by the Free
+@c  Software Foundation raise funds for GNU development.''
 @c  @end titlepage
 
 @c %%%%%%%%%%%%%%%%%%%%%%%%%%%% CHAPTER %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

2001-03-26  Eli Zaretskii  <eliz@is.elta.co.il>

	* gdbint.texinfo: Change Permissions to GFDL.  Update Copyright.

	* gdbgui.texinfo: Change Permissions to GFDL.  Update Copyright.
	Replace "GDB" with "@value{GDBN}".  Fix markup.

	* annotate.texi: Change Permissions to GFDL.  Update Copyright.

	* gdb.texinfo: Change Permissions to GFDL.  Update Copyright.


--- gdb/doc/gdb.t~3	Fri Mar 23 21:50:52 2001
+++ gdb/doc/gdb.texinfo	Sun Mar 25 22:23:14 2001
@@ -27,10 +27,10 @@
 @syncodeindex fn cp
 
 @c !!set GDB manual's edition---not the same as GDB version!
-@set EDITION Eighth
+@set EDITION Ninth
 
 @c !!set GDB manual's revision date
-@set DATE March 2000
+@set DATE April 2001
 
 @c THIS MANUAL REQUIRES TEXINFO 3.12 OR LATER.
 
@@ -49,26 +49,19 @@
 of @cite{Debugging with @value{GDBN}: the @sc{gnu} Source-Level Debugger}
 for @value{GDBN} Version @value{GDBVN}.
 
-Copyright (C) 1988-2000 Free Software Foundation, Inc.
+Copyright (C) 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001
+   Free Software Foundation, Inc.
 
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``A Sample GDB Session'' and ``Free
+Software'', with the Front-Cover texts being ``A GNU Manual,'' and
+with the Back-Cover Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end ifinfo
 
 @titlepage
@@ -88,24 +81,24 @@
 @end tex
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1988-2000 Free Software Foundation, Inc. 
+Copyright @copyright{} 1988,1989,1990,1991,1992,1993,1994,1995,1996,1998,1999,2000,2001
+   Free Software Foundation, Inc.
 @sp 2
 Published by the Free Software Foundation @*
 59 Temple Place - Suite 330, @*
 Boston, MA 02111-1307 USA @*
 ISBN 1-882114-77-9 @*
-                
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
 
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``A Sample GDB Session'' and ``Free
+Software'', with the Front-Cover texts being ``A GNU Manual,'' and
+with the Back-Cover Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end titlepage
 @page
 
@@ -119,7 +112,7 @@
 This is the @value{EDITION} Edition, @value{DATE}, for @value{GDBN} Version
 @value{GDBVN}.
 
-Copyright (C) 1988-2000 Free Software Foundation, Inc.
+Copyright (C) 1988-2001 Free Software Foundation, Inc.
 
 @menu
 * Summary::                     Summary of @value{GDBN}
--- gdb/doc/annotate.t~3	Mon May  1 11:34:34 2000
+++ gdb/doc/annotate.texi	Sun Mar 25 19:43:26 2001
@@ -12,28 +12,18 @@
 @c  This file documents GDB annotations.
 
 @c  This is Edition @value{EDITION}, @value{DATE}, of @cite{GDB
-@c  Annotations}.  Copyright 1994 Free Software Foundation
+@c  Annotations}.  Copyright 1994,1995,2000,2001 Free Software Foundation
 
-@c  Permission is granted to make and distribute verbatim copies of
-@c  this manual provided the copyright notice and this permission notice
-@c  are preserved on all copies.
-@c  @end ignore
-
-@c  @ignore
-@c  Permission is granted to process this file through TeX and print the
-@c  results, provided the printed document carries copying permission
-@c  notice identical to this one except for the removal of this paragraph
-@c  (this paragraph not being relevant to the printed manual).
-
-@c  @end ignore
-@c  Permission is granted to copy and distribute modified versions of this
-@c  manual under the conditions for verbatim copying, provided also that the
-@c  entire resulting derived work is distributed under the terms of a
-@c  permission notice identical to this one.
-
-@c  Permission is granted to copy and distribute translations of this manual
-@c  into another language, under the above conditions for modified versions.
-@c  @end ifinfo
+@c Permission is granted to copy, distribute and/or modify this document
+@c under the terms of the GNU Free Documentation License, Version 1.1 or
+@c any later version published by the Free Software Foundation; with the
+@c Invariant Sections being ``Annotations Overview'' and ``Source
+@c Annotations'', with the Front-Cover texts being ``A GNU Manual,''
+@c and with the Back-Cover Texts as in (a) below.
+
+@c (a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+@c this GNU Manual, like GNU software.  Copies published by the Free
+@c Software Foundation raise funds for GNU development.''
 
 @c  @titlepage
 @c  @title GDB Annotations
@@ -46,7 +36,7 @@
 @c  this manual provided the copyright notice and this permission notice
 @c  are preserved on all copies.
 
-@c  Copyright @copyright{} 1994 Free Software Foundation
+@c  Copyright @copyright{} 1994,1995,2000,2001 Free Software Foundation
 @c  @end titlepage
 
 @c  @ifinfo
@@ -59,8 +49,8 @@
 @chapter @value{GDBN} Annotations
 
 This chapter describes annotations in @value{GDBN}.  Annotations are
-designed to interface @value{GDBN} to graphical user interfaces or other
-similar programs which want to interact with @value{GDBN} at a
+designed to interface @value{GDBN} to graphical user interfaces or
+other similar programs which want to interact with @value{GDBN} at a
 relatively high level.
 
 @ignore
--- gdb/doc/gdbint.t~3	Tue Mar 20 19:37:28 2001
+++ gdb/doc/gdbint.texinfo	Sun Mar 25 22:10:12 2001
@@ -1,35 +1,31 @@
 \input texinfo   @c -*- texinfo -*-
 @setfilename gdbint.info
 @include gdb-cfg.texi
-@ifinfo
-@format
+@dircategory Programming & development tools.
+@direntry
 START-INFO-DIR-ENTRY
 * Gdb-Internals: (gdbint).	The GNU debugger's internals.
 END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
+@end direntry
 
 @ifinfo
 This file documents the internals of the GNU debugger @value{GDBN}.
 
-Copyright 1990-1999 Free Software Foundation, Inc.
+Copyright 1990,1991,1992,1993,1994,1996,1998,1999,2000,2001
+   Free Software Foundation, Inc.
 Contributed by Cygnus Solutions.  Written by John Gilmore.
 Second Edition by Stan Shebs.
 
-Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-
-@ignore
-Permission is granted to process this file through Tex and print the
-results, provided the printed document carries copying permission notice
-identical to this one except for the removal of this paragraph (this
-paragraph not being relevant to the printed manual).
-
-@end ignore
-Permission is granted to copy or distribute modified versions of this
-manual under the terms of the GPL (for which purpose this text may be
-regarded as a program in the language TeX).
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``Algorithms'' and ``Porting GDB'', with the
+Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover
+Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end ifinfo
 
 @setchapternewpage off
@@ -58,12 +54,19 @@
 @end tex
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1990-1999 Free Software Foundation, Inc.
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
+Copyright @copyright{} 1990,1991,1992,1993,1994,1996,1998,1999,2000,2001
+   Free Software Foundation, Inc.
 
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``Algorithms'' and ``Porting GDB'', with the
+Front-Cover texts being ``A GNU Manual,'' and with the Back-Cover
+Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end titlepage
 
 @c TeX can handle the contents at the start but makeinfo 3.12 can not
--- gdb/doc/gdbgui.t~3	Mon Feb  7 02:19:38 2000
+++ gdb/doc/gdbgui.texinfo	Sun Mar 25 19:59:12 2001
@@ -1,7 +1,7 @@
 \input texinfo      @c -*-texinfo-*-
-@c Copyright 1988 1989 1990 1991 1992 1993 1994 Free Software Foundation, Inc.
+@c Copyright 1994, 1995, 2001 Free Software Foundation, Inc.
 @c
-@c %**start of header 
+@c %**start of header
 @c makeinfo ignores cmds prev to setfilename, so its arg cannot make use
 @c of @set vars.  However, you can override filename with makeinfo -o.
 @setfilename gdb.info
@@ -32,52 +32,41 @@
 @syncodeindex vr cp
 
 @c !!set GDB manual's edition---not the same as GDB version!
-@set EDITION 4.13
+@set EDITION 4.14
 
 @c !!set GDB manual's revision date
-@set DATE January 1995
+@set DATE April 2001
 
 @c THIS MANUAL REQUIRES TEXINFO-2 macros and info-makers to format properly.
 
-@ifinfo
-@c This is a dir.info fragment to support semi-automated addition of
-@c manuals to an info tree.  zoo@cygnus.com is developing this facility.
-@format
+@dircategory Programming & development tools
+@direntry
 START-INFO-DIR-ENTRY
 * Gdb: (gdb).                     The GNU debugger.
 END-INFO-DIR-ENTRY
-@end format
-@end ifinfo
+@end direntry
 @c
 @c
 @ifinfo
 This file documents the graphical interface to the GNU debugger @value{GDBN}.
 
 
-This is Edition @value{EDITION}, @value{DATE}, 
+This is Edition @value{EDITION}, @value{DATE},
 of @cite{Using the Graphical Interface to @value{GDBN}}
 for GDB Version @value{GDBVN}.
 
-Copyright (C) 1994, 1995 Free Software Foundation, Inc.
-
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
+Copyright (C) 1994, 1995, 2001 Free Software Foundation, Inc.
 
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``Using the Graphical Interface to ``GDB'' and
+``Starting up GUI GDB'', with the Front-Cover texts being ``A GNU
+Manual,'' and with the Back-Cover Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end ifinfo
 
 @titlepage
@@ -89,11 +78,11 @@
 @sp 1
 @subtitle Edition @value{EDITION}, for @value{GDBN} version @value{GDBVN}
 @subtitle @value{DATE}
-@author Stanley T. Shebs
+@author Stanley T.@: Shebs
 @page
 @tex
 {\parskip=0pt
-\hfill (Send bugs and comments on @value{GDBN} to bug-gdb\@prep.ai.mit.edu.)\par
+\hfill (Send bugs and comments on @value{GDBN} to bug-gdb\@gnu.org.)\par
 \hfill {\it Debugging with @value{GDBN}}\par
 \hfill \TeX{}info \texinfoversion\par
 \hfill doc\@cygnus.com\par
@@ -101,20 +90,19 @@
 @end tex
 
 @vskip 0pt plus 1filll
-Copyright @copyright{} 1994, 1995 Free Software Foundation, Inc. 
+Copyright @copyright{} 1994, 1995, 2001 Free Software Foundation, Inc.
 @sp 2
 
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided also that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions.
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.1 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``Using the Graphical Interface to ``GDB'' and
+``Starting up GUI GDB'', with the Front-Cover texts being ``A GNU
+Manual,'' and with the Back-Cover Texts as in (a) below.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software.  Copies published by the Free
+Software Foundation raise funds for GNU development.''
 @end titlepage
 @page
 
@@ -136,79 +124,73 @@
 you must of course be using an X server and/or workstation,
 and your @code{DISPLAY} environment variable must be set correctly.
 If either of these is not true, then @value{GDBN} will still start up,
-but will use only the traditional command interface.
+zbut will use only the traditional command interface.
 
 The exact layout and appearance of the windows will depend on the host
-system type.  For instance, GDB under Windows will display its windows
-inside a larger window, while under Unix/X, each window is a separate
-toplevel window.  However, general behavior and layout is consistent
-across all platforms; omissions or restrictions on particular platforms,
-if not documented as unavoidable, should be considered bugs and
-reported.
-
-All GDB windows have a common structure.  Each window has an associated
-menu bar, which may be at the top of the window or perhaps elsewhere.
-Some of the menus and menu items in the menu bar are common to all GDB
-windows, while others are specific to particular types of windows.
-Below the menu bar is the working data area of the window.  If the data
-is too large to display all at once, the data area will have scroll bars
-on its right and bottom sides.  Below the data area are two optional
-features; a status/data line, and a button box.
+system type.  For instance, @value{GDBN} on MS-Windows will display
+its windows inside a larger window, while on X on a GNU/Linux or a
+Unix machine, each window is a separate toplevel window.  However,
+general behavior and layout is consistent across all platforms;
+omissions or restrictions on particular platforms, if not documented
+as unavoidable, should be considered bugs and reported.
+
+All @value{GDBN} windows have a common structure.  Each window has an
+associated menu bar, which may be at the top of the window or perhaps
+elsewhere.  Some of the menus and menu items in the menu bar are
+common to all @value{GDBN} windows, while others are specific to
+particular types of windows.  Below the menu bar is the working data
+area of the window.  If the data is too large to display all at once,
+the data area will have scroll bars on its right and bottom sides.
+Below the data area are two optional features; a status/data line, and
+a button box.
 
 @section Menus
 
 @subsection File Menu
 
 The standard file menu provides operations that affect the overall state
-of GDB, mainly file operations, but other things as well.
-
-About GDB...
-
-Displays the startup window for GDB.
+of @value{GDBN}, mainly file operations, but other things as well.
 
-File...
-
-Lets you set the combined executable and symbol file that GDB will use.
-(Like "file".)
-
-Target...
-
-Brings up a dialog that you can use to connect GDB to a target program.
-The dialog is described in more depth later.
-(Like "target".)
-
-Edit...
+@table @code
+@item About @value{GDBN}...
+Displays the startup window for @value{GDBN}.
+
+@item File...
+Lets you set the combined executable and symbol file that @value{GDBN}
+will use.  (Like the @samp{file} command in the command-line version
+of @value{GDBN}.)
+
+@item Target...
+Brings up a dialog that you can use to connect @value{GDBN} to a
+target program.  The dialog is described in more depth later.  (Like
+the @samp{target} command.)
 
+@item Edit...
 Starts up an editor to modify the source file being displayed.
 
-Exec File...
-
-Lets you set the executable file that GDB will use.
-(Like "exec-file".)
-
-Symbol File...
-
-Lets you set the symbol file that GDB will use.
-(Like "symbol-file".)
-
-Add Symbol File...
+@item Exec File...
+Lets you set the executable file that @value{GDBN} will use.
+(Like the @samp{exec-file} command.)
+
+@item Symbol File...
+Lets you set the symbol file that @value{GDBN} will use.
+(Like the @samp{symbol-file} command.)
 
+@item Add Symbol File...
 Lets you add additional symbol files.
-(Like "add-symbol-file".)
-
-Core File...
-
-Lets you set the core file that GDB will use.
-(Like "core-file".)
+(Like the @samp{add-symbol-file} command.)
 
-Shared Libraries...
-
-(Like "sharedlibrary".)
-
-Quit
-
-quits GDB.
-(Like @samp{quit}.)
+@item Core File...
+Lets you set the core file that @value{GDBN} will use.
+(Like the @samp{core-file} command.)
+
+@item Shared Libraries...
+(Like the @samp{sharedlibrary} command.)
+
+@item Quit
+Quits @value{GDBN}.
+(Like the @samp{quit} command.)
+@end table
 
 
 @c @subsection Commands Menu
@@ -216,29 +198,32 @@
 @c The commands menu consists of items that let you run and control the program being
 @c debugged.
 @c 
-@c Run
+@c @table @code
+@c @item Run
 @c 
-@c Step
+@c @item Step
 @c 
-@c Next
+@c @item Next
 @c 
-@c Finish
+@c @item Finish
 @c 
-@c Stepi
+@c @item Stepi
 @c 
-@c Nexti
+@c @item Nexti
 
 @subsection Windows Menu
 
-The windows menu allows access to all the windows available in GDB.
-The first part of the menu lists all of the predefined individual windows.
-If the window exists already, its item will be marked as such;
-selecting the item will cause the window to be put in front if it is
-obscured.  If it does not exist, then it will be created.
+The @samp{Windows} menu allows access to all the windows available in
+@value{GDBN}.  The first part of the menu lists all of the predefined
+individual windows.  If the window exists already, its item will be
+marked as such; selecting the item will cause the window to be put in
+front if it is obscured.  If it does not exist, then it will be
+created.
 
 The second part of the menu lists additional windows that you may have
 created, such as source windows or variable displays.
 
+@display
 Command
 ---
 Source
@@ -250,68 +235,77 @@
 Files
 @c ---
 @c <extra windows>
+@end display
 
 @subsection View Menu
 
-All windows have a view menu, but its contents are highly specific to
-window type.  For instance, a source window will have a view menu item
-to control the display of line numbers, but a register window will instead
-have an option to choose the radix in which to display register contents.
-You can find the full description of view options with each window type.
+All windows have a @samp{view} menu, but its contents are highly
+specific to window type.  For instance, a source window will have a
+view menu item to control the display of line numbers, but a register
+window will instead have an option to choose the radix in which to
+display register contents.  You can find the full description of view
+options with each window type.
 
 @subsection Help Menu
 
-The help menu includes access to GDB's online help.
+The @samp{Help} menu includes access to @value{GDBN}'s online help.
 
 @section Windows
 
 @subsection Command Window
 
-The command window provides access to the standard GDB command
-interpreter.  In nearly all cases, commands typed into this window
-will behave exactly as for a non-windowing GDB. 
-
-Note that not all changes to GDB will be reflected in this window.  For instance,
-if you were to type a "step" command, then click on the "step" menu item in
-the source window, then go back, and type another "step" command, the command
-buffer will only show two steps, when you have actually done three.  GDB will
-put a "..." into the command buffer when operations in other windows are done,
-as a reminder that the command buffer is incomplete.
+The @samp{Command} window provides access to the standard @value{GDBN}
+command interpreter.  In nearly all cases, commands typed into this
+window will behave exactly as for a non-windowing @value{GDBN}.
+
+Note that not all changes to @value{GDBN} will be reflected in this
+window.  For instance, if you were to type a @samp{step} command, then
+click on the @samp{step} menu item in the source window, then go back,
+and type another @samp{step} command, the command buffer will only
+show two steps, when you have actually done three.  @value{GDBN} will
+put a ``@dots'' into the command buffer when operations in other
+windows are done, as a reminder that the command buffer is incomplete.
 
 @c Also note that as a side effect of having the interface and possibly an
 @c associated scripting language built in, additional commands may be
-@c available.  For instance, if tcl is in GDB, the command ``tcl <tcl code>''
-@c will be available.
+@c available.  For instance, if tcl is in @value{GDBN}, the command 
+@c ``tcl <tcl code>'' will be available.
 
 The command window has no status line or button box.
 
 @subsection Files Window
 
-The files window lists all of the files that were used to build the
+The @samp{Files} window lists all of the files that were used to build the
 executable.
 
-Clicking on the xxx in the left margin expands/contracts the display of
-included files and symbols defined by the file.
+Clicking on the @samp{xxx} in the left margin expands/contracts the
+display of included files and symbols defined by the file.
 
-The View menu for this window includes the following items:
-Name/Full Pathname
-@c Sort by Name
-@c Sort by Section&Offset
-@c Show All Included Files
-@c Included File Indentation...
+The @samp{View} menu for this window includes the following items:
+
+@table @code
+@item Name/Full Pathname
+@c @item Sort by Name
+@c @item Sort by Section&Offset
+@c @item Show All Included Files
+@c @item Included File Indentation...
+@end table
 
 @subsection Source Window
 
-A source window displays a single file of source code.
+A @samp{Source} window displays a single file of source code.
+
+The left margin includes an indicator for the current PC, breakpoints
+and potential breakpoints, and (optionally) line numbers.
 
-The left margin includes an indicator for the current PC, breakpoints and potential breakpoints,
-and (optionally) line numbers.
+The @samp{View} menu for this window includes the following items:
 
-The View menu for this window includes the following items:
-Show Line Numbers
-Show Breakdots
-@c Jump to PC (if pc changes, scroll back so PC is centered)
-@c Tab... (set tabbing)
+@table @code
+@item Show Line Numbers
+@item Show Breakdots
+@c @item Jump to PC (if pc changes, scroll back so PC is centered)
+@c @item Tab... (set tabbing)
+@end table
 
 @section Extensions
 
@@ -342,7 +336,7 @@
 @c 
 @c Is an *optional* window.
 @c 
-@c Behavior mimics command-line GDB running in an Emacs buffer as much
+@c Behavior mimics command-line @value{GDBN} running in an Emacs buffer as much
 @c as possible.
 @c 
 @c Assembly Window
@@ -399,8 +393,8 @@
 
 @section How to Build
 
-If GDB is configured with --enable-gdbtk, then upon startup, it will
-open windows.
+If @value{GDBN} is configured with @samp{--enable-gdbtk}, then upon
+startup, it will open windows.
 
 @node Index
 @unnumbered Index



More information about the Gdb-patches mailing list