Improve ptrace-error detection on Linux targets

[deliverable/binutils-gdb.git] / gdb / doc / refcard.tex

diff --git a/gdb/doc/refcard.tex b/gdb/doc/refcard.tex
index 768e9bd38289041c035764ba9dc11862c5d618bb..5b65e51a2b2fdd9f95b0e819566200bed687a74f 100644 (file)
--- a/gdb/doc/refcard.tex
+++ b/gdb/doc/refcard.tex
@@ -1,6 +1,7 @@
+%%%%%%%%%%%%%%%% gdb-refcard.tex %%%%%%%%%%%%%%%%
+

 %This file is TeX source for a reference card describing GDB, the GNU debugger.
 %This file is TeX source for a reference card describing GDB, the GNU debugger.

-%$Id$
-%Copyright (C) 1991 Free Software Foundation, Inc.
+%Copyright (C) 1991-2019 Free Software Foundation, Inc.

 %Permission is granted to make and distribute verbatim copies of
 %this reference provided the copyright notices and permission notices
 %are preserved on all copies.
 %Permission is granted to make and distribute verbatim copies of
 %this reference provided the copyright notices and permission notices
 %are preserved on all copies.


@@ -10,7 +11,7 @@
 %
 %This program is free software; you can redistribute it and/or modify
 %it under the terms of the GNU General Public License as published by
 %
 %This program is free software; you can redistribute it and/or modify
 %it under the terms of the GNU General Public License as published by

-%the Free Software Foundation; either version 1, or (at your option)
+%the Free Software Foundation; either version 3, or (at your option)

 %any later version.
 %
 %This program is distributed in the hope that it will be useful, but
 %any later version.
 %
 %This program is distributed in the hope that it will be useful, but


@@ -18,64 +19,206 @@
 %MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 %General Public License for more details.
 %
 %MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 %General Public License for more details.
 %

-%You can find a copy of the GNU General Public License in the GDB
-%manual; or write to the Free Software Foundation, Inc.,
-%675 Mass Ave, Cambridge, MA 02139, USA.
+%You should have received a copy of the GNU General Public License
+%along with this program.  If not, see <http://www.gnu.org/licenses/>.
+%
+%You can contact the maintainer at:  doc@cygnus.com
+%
+%                                Documentation Department
+%                                Cygnus Solutions
+%                                1325 Chesapeake Terrace
+%                                Sunnyvale, CA 94089  USA
+%
+%                                +1 800 CYGNUS-1
+%
+%
+%
+% 22-AUG-1993 Andreas Vogel

 %
 %

-%You can contact the author as:  pesch@cygnus.com
+%   Modifications made in order to handle different papersizes correctly.
+%   You only have to set the total width and height of the paper, the
+%   horizontal and vertical margin space measured from *paper edge*
+%   and the interline and interspec spacing.
+%   In order to support a new papersize, you have to fiddle with the
+%   latter four dimensions. Just try out a few values.
+%   All other values will be computed at process time so it should be
+%   quite easy to support different paper sizes - only four values to
+%   guess :-)

 %
 %

-%                                Roland Pesch
-%                                Cygnus Support
-%                                814 University Ave.
-%                                Palo Alto, CA 94301 USA
+%   To find the configuration places, just search for the string
+%   "CONFIGURATION".

 %
 %

-%                                +1 415 322 3811
+%   Andreas Vogel (av@ssw.de)

 %
 %

-%            Cygnus Support is an organization devoted to commercial
-%            support of free software.  For general information
-%            contact ``info@cygnus.com''
+%
+%
+% Uncomment the following `magnification' command if you want to print
+% out in a larger font.  Caution!  You may need larger paper.  You had
+% best avoid using 3-column output if you try this.  See the ``Three
+% column format'' section below if you want to print in three column
+% format.
+%
+%\magnification=\magstep 1

 %
 % NOTE ON INTENTIONAL OMISSIONS: This reference card includes most GDB
 % commands, but due to space constraints there are some things I chose
 %
 % NOTE ON INTENTIONAL OMISSIONS: This reference card includes most GDB
 % commands, but due to space constraints there are some things I chose

-% to omit.  In general, not all synonyms for commands are covered.
+% to omit.  In general, not all synonyms for commands are covered, nor
+% all variations of a command.

 % The GDB-under-Emacs section omits gdb-mode functions without default
 % keybindings.  GDB startup options are not described.
 % The GDB-under-Emacs section omits gdb-mode functions without default
 % keybindings.  GDB startup options are not described.

+% set print sevenbit-strings omitted.
+% printsyms, printpsyms, omitted since they're for GDB maintenance primarily
+% share omitted due to obsolescence
+% set check range/type omitted at least til code is in GDB.

 %
 %

+%-------------------- Three column format -----------------------
+
+%%%% --- To disable three column format, comment out this entire section
+
+% Three-column format for landscape printing
+
+%-------- Papersize defs:
+
+\newdimen\totalwidth \newdimen\totalheight
+\newdimen\hmargin    \newdimen\vmargin
+\newdimen\secskip    \newdimen\lskip
+\newdimen\barwidth   \newdimen\barheight
+\newdimen\intersecwidth
+
+%%
+%%  START CONFIGURATION - PAPERSIZE DEFINITIONS
+%------- Papersize params:
+%%  US letter paper (8.5x11in)
+%%
+\totalwidth=11in    % total width of paper
+\totalheight=8.5in  % total height of paper
+\hmargin=.25in      % horizontal margin width
+\vmargin=.25in      % vertical margin width
+\secskip=1pc        % space between refcard secs
+\lskip=2pt          % extra skip between \sec entries
+\ifx\pdfoutput\undefined\else   % check if we are using pdfTeX
+  \pdfpagewidth=\totalwidth     % width of paper in pdf output
+  \pdfpageheight=\totalheight   % height of paper in pdf output
+\fi
+%------- end papersize params
+%%
+%%  change according to personal taste, not papersize dependent
+%%
+\barwidth=.1pt       % width of the cropmark bar
+\barheight=2pt       % height of the cropmark bar
+\intersecwidth=0.5em % width between \itmwid and \dfnwid
+%%
+%%  END CONFIGURATION - PAPERSIZE DEFINITIONS
+%%
+
+%%
+%%  values to be computed - nothing to configure
+%%
+\newdimen\fullhsize     % width of area without margins
+\newdimen\itmwid        % width of item column
+\newdimen\dfnwid        % width of definition column
+\newdimen\temp          % only for temporary use
+
+%%
+%%  adjust the offsets so the margins are measured *from paper edge*
+%%
+\hoffset=-1in \advance \hoffset by \hmargin
+\voffset=-1in \advance \voffset by \vmargin
+
+%%
+%%  fullhsize = totalwidth - (2 * hmargin)
+%%
+\fullhsize=\totalwidth
+\temp=\hmargin \multiply \temp by 2 \advance \fullhsize by -\temp
+
+%%
+%%  hsize = (fullhsize - (4 * hmargin) - (2 * barwidth)) / 3
+%%
+\hsize=\fullhsize
+\temp=\hmargin \multiply \temp by 4 \advance \hsize by -\temp
+\temp=\barwidth \multiply \temp by 2 \advance \hsize by -\temp
+\divide \hsize by 3
+
+%%
+%%  vsize = totalheight - (2 * vmargin)
+%%
+\vsize=\totalheight
+\temp=\vmargin \multiply \temp by 2 \advance \vsize by -\temp
+
+%%
+%%  itmwid = (hsize - intersecwidth) * 1/3
+%%  dfnwid = (hsize - intersecwidth) * 2/3
+%%
+\temp=\hsize \advance \temp by -\intersecwidth \divide \temp by 3
+\itmwid=\temp
+\dfnwid=\hsize \advance \dfnwid by -\itmwid
+
+%-------- end papersize defs
+
+
+\def\fulline{\hbox to \fullhsize}
+\let\lcr=L \newbox\leftcolumn\newbox\centercolumn
+\output={\if L\lcr
+            \global\setbox\leftcolumn=\columnbox \global\let\lcr=C
+        \else
+            \if C\lcr
+               \global\setbox\centercolumn=\columnbox \global\let\lcr=R
+            \else \tripleformat \global\let\lcr=L
+            \fi
+         \fi
+%         \ifnum\outputpenalty>-20000 \else\dosupereject\fi
+      }
+
+%%
+%%  START CONFIGURATION - ALTERNATIVE FOLDING GUIDES
+%%
+%%  For NO printed folding guide,
+%%  comment out other \def\vdecor's and uncomment:
+
+%\def\vdecor{\hskip\hmargin plus1fil\hskip\barwidth plus1fil\hskip\hmargin plus1fil}
+
+%%  For SOLID LINE folding guide,
+%%  comment out other \def\vdecor's and uncomment:
+
+%\def\vdecor{\hskip\hmargin plus1fil \vrule width \barwidth \hskip\hmargin plus1fil}
+
+%%  For SMALL MARKS NEAR TOP AND BOTTOM as folding guide,
+%%  comment out other \def\vdecor's and uncomment:
+
+\def\vdecor{\hskip\hmargin plus1fil
+\vbox to \vsize{\hbox to \barwidth{\vrule height\barheight width\barwidth}\vfill
+\hbox to \barwidth{\vrule height\barheight width\barwidth}}%THIS PERCENT SIGN IS ESSENTIAL
+\hskip\hmargin plus1fil}
+
+%%
+%%  END CONFIGURATION - ALTERNATIVES FOR FOLDING GUIDES
+%%
+
+\def\tripleformat{\shipout\vbox{\fulline{\box\leftcolumn\vdecor
+                                        \box\centercolumn\vdecor
+                                        \columnbox}
+                              }
+                 \advancepageno}
+\def\columnbox{\leftline{\pagebody}}
+\def\bye{\par\vfill
+         \supereject
+         \if R\lcr \null\vfill\eject\fi
+         \end}
+
+%-------------------- end three column format -----------------------
+
+%-------------------- Computer Modern font defs: --------------------
+\font\bbf=cmbx10
+\font\vbbf=cmbx12
+\font\smrm=cmr6
+\font\brm=cmr10
+\font\rm=cmr7
+\font\it=cmti7
+\font\tt=cmtt8
+%-------------------- end font defs ---------------------------------
+

 %
 %

-\input threecol
-{%
-\def\$#1${{#1}}%   Kluge: collect RCS revision info without $...$
-\xdef\manvers{\$Revision$}%
-}
-\vsize=8in

 \hyphenpenalty=5000\tolerance=2000\raggedright\raggedbottom
 \hyphenpenalty=5000\tolerance=2000\raggedright\raggedbottom

-%
-%The Times-Roman family is used below because it is both more
-%attractive and more compact than Computer Modern.  On the other hand,
-%while common, it is not Free.  The commented-out font definitions
-%will be close (but may cause some column overflows) if you must use
-%the CM fonts.
-%\font\bbf=cmbx10
-\font\bbf=Times-Bold at 10pt
-%\font\vbbf=cmbx12
-\font\vbbf=Times-Bold at 12pt
-%\font\smrm=cmr5
-\font\smrm=Times-Roman at 6pt
-%\font\brm=cmr10
-\font\brm=Times-Roman at 10pt
-%\font\rm=cmr7
-\font\rm=Times-Roman at 8pt
-%\font\it=cmti7
-\font\it=Times-Italic at 8pt
-% We *do* use CMtt rather than Courier because TeX and PS fonts have
-% different ideas about where ``funny'' chars go.
-\font\tt=cmtt8
-% Finally, the following common-but-not-free font (Symbol) is used
-% only for the copyright symbol.  Comment out the whole definition of
-% \copyright if you insist on using only Free fonts, and you'll pick
-% up the kluge in plain.tex that defines \copyright by overstriking.
-\font\sym=Symbol at 7pt
-\def\copyright{{\sym\char'323}}

 \normalbaselineskip=9pt\baselineskip=9pt
 %
 \parindent=0pt
 \normalbaselineskip=9pt\baselineskip=9pt
 %
 \parindent=0pt


@@ -86,41 +229,40 @@
 \def\opt#1{{\brm[{\rm #1}]}}
 \def\xtra#1{\noalign{\smallskip{\tt#1}}}
 %
 \def\opt#1{{\brm[{\rm #1}]}}
 \def\xtra#1{\noalign{\smallskip{\tt#1}}}
 %

-\long\def\sec#1;#2\endsec{\vskip 1pc
+\long\def\sec#1;#2\endsec{\vskip \secskip

 \halign{%
 %COL 1 (of halign):
 \halign{%
 %COL 1 (of halign):

-\vtop{\hsize=1in\tt
-##\par\vskip 2pt
-}\quad
+\vtop{\hsize=\itmwid\tt
+##\par\vskip \lskip }\hfil

 %COL 2 (of halign):
 %COL 2 (of halign):

-&\vtop{\hsize=2.1in\hangafter=1\hangindent=0.5em
-\rm ##\par\vskip 2pt}\cr
+&\vtop{\hsize=\dfnwid\hangafter=1\hangindent=\intersecwidth
+\rm ##\par\vskip \lskip}\cr

 %Tail of \long\def fills in halign body with \sec args:
 %Tail of \long\def fills in halign body with \sec args:

-\noalign{{\bbf #1}\vskip 2pt}
+\noalign{{\bbf #1}\vskip \lskip}

 #2
 }
 }
 
 #2
 }
 }
 

-{\vbbf GDB QUICK REFERENCE}
-\vskip 5pt
-{\smrm GDB Version 4.0---Cygnus Support 1991}
+{\vbbf GDB QUICK REFERENCE}\hfil{\smrm GDB Version 5}\qquad

 
 \sec Essential Commands;
 gdb {\it program} \opt{{\it core}}&debug {\it program} \opt{using
 coredump {\it core}}\cr
 
 \sec Essential Commands;
 gdb {\it program} \opt{{\it core}}&debug {\it program} \opt{using
 coredump {\it core}}\cr

-bt& backtrace: display program stack\cr

 b \opt{\it file\tt:}{\it function}&set breakpoint at {\it function} \opt{in \it file}\cr
 run \opt{{\it arglist}}&start your program \opt{with {\it arglist}}\cr
 b \opt{\it file\tt:}{\it function}&set breakpoint at {\it function} \opt{in \it file}\cr
 run \opt{{\it arglist}}&start your program \opt{with {\it arglist}}\cr

+bt& backtrace: display program stack\cr

 p {\it expr}&display the value of an expression\cr
 c &continue running your program\cr
 p {\it expr}&display the value of an expression\cr
 c &continue running your program\cr

-n &execute next line, including function calls\cr
-s &execute until another line is reached\cr
+n &next line, stepping over function calls\cr
+s &next line, stepping into function calls\cr

 \endsec
 
 \sec Starting GDB;
 \endsec
 
 \sec Starting GDB;

-gdb&starts GDB, with no debugging files\cr
+gdb&start GDB, with no debugging files\cr

 gdb {\it program}&begin debugging {\it program}\cr
 gdb {\it program}&begin debugging {\it program}\cr

-gdb {\it program core}&debug coredump {\it core} produced by {\it program}\cr
+gdb {\it program core}&debug coredump {\it core} produced by {\it
+program}\cr
+gdb --help&describe command line options\cr

 \endsec
 
 \sec Stopping GDB;
 \endsec
 
 \sec Stopping GDB;


@@ -137,7 +279,7 @@ help {\it command}&describe {\it command}\cr
 \sec Executing your Program;
 run {\it arglist}&start your program with {\it arglist}\cr
 run&start your program with current argument list\cr
 \sec Executing your Program;
 run {\it arglist}&start your program with {\it arglist}\cr
 run&start your program with current argument list\cr

-run $\ldots$ <{\it inf} >{\it outf}&start program with input, output
+run $\ldots$ <{\it inf} >{\it outf}&start your program with input, output

 redirected\cr
 \cr
 kill&kill running program\cr
 redirected\cr
 \cr
 kill&kill running program\cr


@@ -148,7 +290,7 @@ set args {\it arglist}&specify {\it arglist} for next
 set args&specify empty argument list\cr
 show args&display argument list\cr
 \cr
 set args&specify empty argument list\cr
 show args&display argument list\cr
 \cr

-show environment&show all environment variables\cr
+show env&show all environment variables\cr

 show env {\it var}&show value of environment variable {\it var}\cr
 set env {\it var} {\it string}&set environment variable {\it var}\cr
 unset env {\it var}&remove {\it var} from environment\cr
 show env {\it var}&show value of environment variable {\it var}\cr
 set env {\it var} {\it string}&set environment variable {\it var}\cr
 unset env {\it var}&remove {\it var} from environment\cr


@@ -162,14 +304,17 @@ shell {\it cmd}&execute arbitrary shell command string\cr
 \endsec
 
 \vfill
 \endsec
 
 \vfill

-\centerline{\smrm \copyright 1991 Free Software Foundation, Inc.\qquad Permissions on back}
+\line{\smrm \opt{ } surround optional arguments \hfill $\ldots$ show
+one or more arguments}
+\vskip\baselineskip
+\centerline{\smrm \copyright 1998-2019 Free Software Foundation, Inc.\qquad Permissions on back}

 \eject
 \sec Breakpoints and Watchpoints;
 break \opt{\it file\tt:}{\it line}\par
 b \opt{\it file\tt:}{\it line}&set breakpoint at {\it line} number \opt{in \it file}\par 
 eg:\quad{\tt break main.c:37}\quad\cr
 \eject
 \sec Breakpoints and Watchpoints;
 break \opt{\it file\tt:}{\it line}\par
 b \opt{\it file\tt:}{\it line}&set breakpoint at {\it line} number \opt{in \it file}\par 
 eg:\quad{\tt break main.c:37}\quad\cr

-break \opt{\it file\tt:}{\it function}&set breakpoint at {\it
-function} \opt{in \it file}\cr
+break \opt{\it file\tt:}{\it func}&set breakpoint at {\it
+func} \opt{in \it file}\cr

 break +{\it offset}\par
 break -{\it offset}&set break at {\it offset} lines from current stop\cr
 break *{\it addr}&set breakpoint at address {\it addr}\cr
 break +{\it offset}\par
 break -{\it offset}&set break at {\it offset} lines from current stop\cr
 break *{\it addr}&set breakpoint at address {\it addr}\cr


@@ -178,9 +323,11 @@ break $\ldots$ if {\it expr}&break conditionally on nonzero {\it expr}\cr
 cond {\it n} \opt{\it expr}&new conditional expression on breakpoint
 {\it n}; make unconditional if no {\it expr}\cr
 tbreak $\ldots$&temporary break; disable when reached\cr
 cond {\it n} \opt{\it expr}&new conditional expression on breakpoint
 {\it n}; make unconditional if no {\it expr}\cr
 tbreak $\ldots$&temporary break; disable when reached\cr

-rbreak {\it regex}&break on all functions matching {\it regex}\cr
+rbreak \opt{\it file\tt:}{\it regex}&break on all functions matching {\it
+regex} \opt{in \it file}\cr

 watch {\it expr}&set a watchpoint for expression {\it expr}\cr
 watch {\it expr}&set a watchpoint for expression {\it expr}\cr

-catch {\it x}&break at C++ handler for exception {\it x}\cr
+catch {\it event}&break at {\it event}, which may be {\tt catch}, {\tt throw},
+{\tt exec}, {\tt fork}, {\tt vfork}, {\tt load}, or {\tt unload}.\cr

 \cr
 info break&show defined breakpoints\cr
 info watch&show defined watchpoints\cr
 \cr
 info break&show defined breakpoints\cr
 info watch&show defined watchpoints\cr


@@ -188,21 +335,30 @@ info watch&show defined watchpoints\cr
 clear&delete breakpoints at next instruction\cr
 clear \opt{\it file\tt:}{\it fun}&delete breakpoints at entry to {\it fun}()\cr
 clear \opt{\it file\tt:}{\it line}&delete breakpoints on source line \cr
 clear&delete breakpoints at next instruction\cr
 clear \opt{\it file\tt:}{\it fun}&delete breakpoints at entry to {\it fun}()\cr
 clear \opt{\it file\tt:}{\it line}&delete breakpoints on source line \cr

-delete \opt{{\it n}}&delete breakpoints {\it n};
-\opt{or all breakpoints}\cr
+delete \opt{{\it n}}&delete breakpoints
+\opt{or breakpoint {\it n}}\cr
+\cr
+disable \opt{{\it n}}&disable breakpoints
+\opt{or breakpoint {\it n}}
+\cr
+enable \opt{{\it n}}&enable breakpoints 
+\opt{or breakpoint {\it n}}
+\cr
+enable once \opt{{\it n}}&enable breakpoints \opt{or breakpoint {\it n}}; 
+disable again when reached
+\cr
+enable del \opt{{\it n}}&enable breakpoints \opt{or breakpoint {\it n}}; 
+delete when reached

 \cr
 \cr

-disable \opt{{\it n}}&disable breakpoints {\it n} \opt{or all}\cr
-enable \opt{{\it n}}&enable breakpoints {\it n} \opt{or all}\cr
-enable once \opt{{\it n}}&enable breakpoints; disable again when
-reached\cr
-enable del \opt{{\it n}}&enable breakpoints; delete when reached\cr

 \cr
 ignore {\it n} {\it count}&ignore breakpoint {\it n}, {\it count}
 times\cr
 \cr
 commands {\it n}\par
 \cr
 ignore {\it n} {\it count}&ignore breakpoint {\it n}, {\it count}
 times\cr
 \cr
 commands {\it n}\par

-\qquad {\it command list}&execute GDB {\it command list} every time breakpoint {\it n} is reached\cr
-end&end of {\it command list}\cr
+\qquad \opt{\tt silent}\par
+\qquad {\it command-list}&execute GDB {\it command-list} every time breakpoint {\it n} is reached. \opt{{\tt silent} suppresses default
+display}\cr
+end&end of {\it command-list}\cr

 \endsec
 
 \sec Program Stack;
 \endsec
 
 \sec Program Stack;


@@ -217,8 +373,9 @@ info frame \opt{\it addr}&describe selected frame, or frame at
 {\it addr}\cr
 info args&arguments of selected frame\cr
 info locals&local variables of selected frame\cr
 {\it addr}\cr
 info args&arguments of selected frame\cr
 info locals&local variables of selected frame\cr

-info reg \opt{\it{rn}}&register values \opt{for reg {\it rn\/}} in selected frame\cr
-info catch&exception handlers active in selected frame\cr
+info reg \opt{\it rn}$\ldots$\par
+info all-reg \opt{\it rn}&register values \opt{for regs {\it rn\/}} in
+selected frame; {\tt all-reg} includes floating point\cr

 \endsec
 
 \vfill\eject
 \endsec
 
 \vfill\eject


@@ -230,14 +387,12 @@ this breakpoint next {\it count} times\cr
 step \opt{\it count}\par
 s \opt{\it count}&execute until another line reached; repeat {\it count} times if
 specified\cr
 step \opt{\it count}\par
 s \opt{\it count}&execute until another line reached; repeat {\it count} times if
 specified\cr

-\cr

 stepi \opt{\it count}\par
 si \opt{\it count}&step by machine instructions rather than source
 lines\cr
 \cr
 next \opt{\it count}\par
 n \opt{\it count}&execute next line, including any function calls\cr
 stepi \opt{\it count}\par
 si \opt{\it count}&step by machine instructions rather than source
 lines\cr
 \cr
 next \opt{\it count}\par
 n \opt{\it count}&execute next line, including any function calls\cr

-\cr

 nexti \opt{\it count}\par
 ni \opt{\it count}&next machine instruction rather than source
 line\cr
 nexti \opt{\it count}\par
 ni \opt{\it count}&next machine instruction rather than source
 line\cr


@@ -256,12 +411,14 @@ altering program variables\cr
 \endsec
 
 \sec Display;
 \endsec
 
 \sec Display;

-print \opt{\tt/{\it f}\/} {\it expr}\par
-p \opt{\tt/{\it f}\/} {\it expr}&show value of {\it expr} according to format {\it f}:\cr
+print \opt{\tt/{\it f}\/} \opt{\it expr}\par
+p \opt{\tt/{\it f}\/} \opt{\it expr}&show value of {\it expr} \opt{or
+last value \tt \$} according to format {\it f}:\cr

 \qquad x&hexadecimal\cr
 \qquad d&signed decimal\cr
 \qquad u&unsigned decimal\cr
 \qquad o&octal\cr
 \qquad x&hexadecimal\cr
 \qquad d&signed decimal\cr
 \qquad u&unsigned decimal\cr
 \qquad o&octal\cr

+\qquad t&binary\cr

 \qquad a&address, absolute and relative\cr
 \qquad c&character\cr
 \qquad f&floating point\cr
 \qquad a&address, absolute and relative\cr
 \qquad c&character\cr
 \qquad f&floating point\cr


@@ -278,7 +435,7 @@ optional format spec follows slash\cr
 \quad {\it f}&printing format.  Any {\tt print} format, or\cr
 &{\tt\qquad s}\ null-terminated string\cr
 &{\tt\qquad i}\ machine instructions\cr
 \quad {\it f}&printing format.  Any {\tt print} format, or\cr
 &{\tt\qquad s}\ null-terminated string\cr
 &{\tt\qquad i}\ machine instructions\cr

-disassemble \opt{\it addr}&display memory as machine instructions\cr
+disassem \opt{\it addr}&display memory as machine instructions\cr

 \endsec
 
 \sec Automatic Display;
 \endsec
 
 \sec Automatic Display;


@@ -287,9 +444,9 @@ program stops \opt{according to format {\it f}\/}\cr
 display&display all enabled expressions on list\cr
 undisplay {\it n}&remove number(s) {\it n} from list of
 automatically displayed expressions\cr
 display&display all enabled expressions on list\cr
 undisplay {\it n}&remove number(s) {\it n} from list of
 automatically displayed expressions\cr

-disable display {\it n}&disable display for expression(s) number {\it
+disable disp {\it n}&disable display for expression(s) number {\it

 n}\cr
 n}\cr

-enable display {\it n}&enable display for expression(s) number {\it
+enable disp {\it n}&enable display for expression(s) number {\it

 n}\cr
 info display&numbered list of display expressions\cr
 \endsec
 n}\cr
 info display&numbered list of display expressions\cr
 \endsec


@@ -297,7 +454,7 @@ info display&numbered list of display expressions\cr
 \vfill\eject
 
 \sec Expressions;
 \vfill\eject
 
 \sec Expressions;

-{\it expr}&an expression in C or C++ (including function calls), or:\cr
+{\it expr}&an expression in C, C++, or Modula-2 (including function calls), or:\cr

 {\it addr\/}@{\it len}&an array of {\it len} elements beginning at {\it
 addr}\cr
 {\it file}::{\it nm}&a variable or function {\it nm} defined in {\it
 {\it addr\/}@{\it len}&an array of {\it len} elements beginning at {\it
 addr}\cr
 {\it file}::{\it nm}&a variable or function {\it nm} defined in {\it


@@ -314,7 +471,7 @@ $\tt\{${\it type}$\tt\}${\it addr}&read memory at {\it addr} as specified
 \cr
 show values \opt{{\it n}}&show last 10 values \opt{or surrounding
 \${\it n}}\cr
 \cr
 show values \opt{{\it n}}&show last 10 values \opt{or surrounding
 \${\it n}}\cr

-show convenience&display all convenience variables\cr
+show conv&display all convenience variables\cr

 \endsec
 
 \sec Symbol Table;
 \endsec
 
 \sec Symbol Table;


@@ -323,9 +480,9 @@ info func \opt{\it regex}&show names, types of defined functions
 (all, or matching {\it regex})\cr
 info var \opt{\it regex}&show names, types of global variables (all,
 or matching {\it regex})\cr
 (all, or matching {\it regex})\cr
 info var \opt{\it regex}&show names, types of global variables (all,
 or matching {\it regex})\cr

-whatis {\it expr}\par
-ptype {\it expr}&show data type of {\it expr} without evaluating; {\tt
-ptype} gives more detail\cr
+whatis \opt{\it expr}\par
+ptype \opt{\it expr}&show data type of {\it expr} \opt{or \tt \$}
+without evaluating; {\tt ptype} gives more detail\cr

 ptype {\it type}&describe type, struct, union, or enum\cr
 \endsec
 
 ptype {\it type}&describe type, struct, union, or enum\cr
 \endsec
 


@@ -334,19 +491,19 @@ source {\it script}&read, execute GDB commands from file {\it
 script}\cr
 \cr
 define {\it cmd}\par
 script}\cr
 \cr
 define {\it cmd}\par

-\qquad {\it command list}&new GDB command {\it cmd}, executes script
-defined by {\it command list} \cr
-end&end of {\it command list}\cr
+\qquad {\it command-list}&create new GDB command {\it cmd}; 
+execute script defined by {\it command-list}\cr
+end&end of {\it command-list}\cr

 document {\it cmd}\par
 document {\it cmd}\par

-\qquad {\it help text}&new online documentation for GDB command {\it
-cmd}\cr
-end&end of {\it help text}\cr
+\qquad {\it help-text}&create online documentation 
+for new GDB command {\it cmd}\cr
+end&end of {\it help-text}\cr

 \endsec
 
 \sec Signals;
 \endsec
 
 \sec Signals;

-handle {\it signal} {\it act}&specify GDB actions when {\it signal} occurs:\cr
-\quad print&announce when signal occurs\cr
-\quad noprint&be silent when signal occurs\cr
+handle {\it signal} {\it act}&specify GDB actions for {\it signal}:\cr
+\quad print&announce signal\cr
+\quad noprint&be silent for signal\cr

 \quad stop&halt execution on signal\cr
 \quad nostop&do not halt execution\cr
 \quad pass&allow your program to handle signal\cr
 \quad stop&halt execution on signal\cr
 \quad nostop&do not halt execution\cr
 \quad pass&allow your program to handle signal\cr


@@ -363,41 +520,46 @@ detach&release target from GDB control\cr
 
 \vfill\eject
 \sec Controlling GDB;
 
 \vfill\eject
 \sec Controlling GDB;

-set {\it param} {\it expr}&set one of GDB's internal parameters\cr
-show {\it param}&display current setting of a GDB parameter\cr
+set {\it param} {\it value}&set one of GDB's internal parameters\cr
+show {\it param}&display current setting of parameter\cr

 \xtra{\rm Parameters understood by {\tt set} and {\tt show}:}
 \xtra{\rm Parameters understood by {\tt set} and {\tt show}:}

-\quad complaints {\it limit}&number of messages on unusual symbols\cr
+\quad complaint {\it limit}&number of messages on unusual symbols\cr

 \quad confirm {\it on/off}&enable or disable cautionary queries\cr
 \quad editing {\it on/off}&control {\tt readline} command-line editing\cr
 \quad confirm {\it on/off}&enable or disable cautionary queries\cr
 \quad editing {\it on/off}&control {\tt readline} command-line editing\cr

-\quad height {\it lpp}&number of lines before pause in
-display\cr
+\quad height {\it lpp}&number of lines before pause in display\cr
+\quad language {\it lang}&Language for GDB expressions ({\tt auto}, {\tt c} or
+{\tt modula-2})\cr
+\quad listsize {\it n}&number of lines shown by {\tt list}\cr

 \quad prompt {\it str}&use {\it str} as GDB prompt\cr
 \quad radix {\it base}&octal, decimal, or hex number representation\cr
 \quad verbose {\it on/off}&control messages when loading
 \quad prompt {\it str}&use {\it str} as GDB prompt\cr
 \quad radix {\it base}&octal, decimal, or hex number representation\cr
 \quad verbose {\it on/off}&control messages when loading

-symbol table\cr
+symbols\cr

 \quad width {\it cpl}&number of characters before line folded\cr
 \quad width {\it cpl}&number of characters before line folded\cr

+\quad write {\it on/off}&Allow or forbid patching binary, core files
+(when reopened with {\tt exec} or {\tt core})

 \cr
 \cr

-\quad history $\ldots$&({\tt h}) groups the following options:\cr
-\quad h exp {\it off/on}&disable or enable {\tt readline} history expansion\cr
+\quad history $\ldots$\par
+\quad h $\ldots$&groups with the following options:\cr
+\quad h exp {\it off/on}&disable/enable {\tt readline} history expansion\cr

 \quad h file {\it filename}&file for recording GDB command history\cr
 \quad h size {\it size}&number of commands kept in history list\cr
 \quad h save {\it off/on}&control use of external file for
 command history\cr
 \cr
 \quad h file {\it filename}&file for recording GDB command history\cr
 \quad h size {\it size}&number of commands kept in history list\cr
 \quad h save {\it off/on}&control use of external file for
 command history\cr
 \cr

-\quad print $\ldots$&({\tt p}) groups the following options:\cr
+\quad print $\ldots$\par
+\quad p $\ldots$&groups with the following options:\cr

 \quad p address {\it on/off}&print memory addresses in stacks,
 values\cr
 \quad p  array {\it off/on}&compact or attractive format for
 arrays\cr
 \quad p address {\it on/off}&print memory addresses in stacks,
 values\cr
 \quad p  array {\it off/on}&compact or attractive format for
 arrays\cr

-\quad p demangle {\it on/off}&source or internal form for C++
+\quad p demangl {\it on/off}&source (demangled) or internal form for C++

 symbols\cr
 \quad p asm-dem {\it on/off}&demangle C++ symbols in
 machine-instruction output\cr
 symbols\cr
 \quad p asm-dem {\it on/off}&demangle C++ symbols in
 machine-instruction output\cr

-\quad p elements {\it limit}&number of elements to display from an
-array\cr
+\quad p elements {\it limit}&number of array elements to display\cr

 \quad p object {\it on/off}&print C++ derived types for objects\cr
 \quad p pretty {\it off/on}&struct display: compact or indented\cr
 \quad p object {\it on/off}&print C++ derived types for objects\cr
 \quad p pretty {\it off/on}&struct display: compact or indented\cr

-\quad p union {\it on/off}&enable or disable display of union members\cr
+\quad p union {\it on/off}&display of union members\cr

 \quad p vtbl {\it off/on}&display of C++ virtual function
 tables\cr
 \cr
 \quad p vtbl {\it off/on}&display of C++ virtual function
 tables\cr
 \cr


@@ -407,19 +569,18 @@ show commands +&show next 10 commands\cr
 \endsec
 
 \sec Working Files;
 \endsec
 
 \sec Working Files;

-file {\it name}&use {\it file} for symbols and executable\cr
-core {\it name}&read {\it file} as coredump\cr
-exec {\it name}&use {\it file} as executable only\cr
-symbol {\it name}&use only symbol table from {\it file}\cr
+file \opt{\it file}&use {\it file} for both symbols and executable;
+with no arg, discard both\cr
+core \opt{\it file}&read {\it file} as coredump; or discard\cr
+exec \opt{\it file}&use {\it file} as executable only; or discard\cr
+symbol \opt{\it file}&use symbol table from {\it file}; or discard\cr

 load {\it file}&dynamically link {\it file\/} and add its symbols\cr
 add-sym {\it file} {\it addr}&read additional symbols from {\it file},
 dynamically loaded at {\it addr}\cr
 info files&display working files and targets in use\cr
 path {\it dirs}&add {\it dirs} to front of path searched for
 executable and symbol files\cr
 load {\it file}&dynamically link {\it file\/} and add its symbols\cr
 add-sym {\it file} {\it addr}&read additional symbols from {\it file},
 dynamically loaded at {\it addr}\cr
 info files&display working files and targets in use\cr
 path {\it dirs}&add {\it dirs} to front of path searched for
 executable and symbol files\cr

-info path&display executable and symbol file path\cr
-share \opt{\it regex}&add symbol information for shared libraries
-matching {\it regex}, or all shared libraries\cr
+show path&display executable and symbol file path\cr

 info share&list names of shared libraries currently loaded\cr
 \endsec
 
 info share&list names of shared libraries currently loaded\cr
 \endsec
 


@@ -431,8 +592,8 @@ show dir&show current source path\cr
 \cr
 list&show next ten lines of source\cr
 list -&show previous ten lines\cr
 \cr
 list&show next ten lines of source\cr
 list -&show previous ten lines\cr

-list {\it lines}&display source centered around {\it lines}, 
-specified as one of:\cr
+list {\it lines}&display source surrounding {\it lines}, 
+specified as:\cr

 \quad{\opt{\it file\tt:}\it num}&line number \opt{in named file}\cr
 \quad{\opt{\it file\tt:}\it function}&beginning of function \opt{in
 named file}\cr
 \quad{\opt{\it file\tt:}\it num}&line number \opt{in named file}\cr
 \quad{\opt{\it file\tt:}\it function}&beginning of function \opt{in
 named file}\cr


@@ -462,16 +623,28 @@ M-d&down {\it arg} frames ({\tt down})\cr
 \ctl{x} SPC&(in source file) set break at point\cr
 \endsec
 
 \ctl{x} SPC&(in source file) set break at point\cr
 \endsec
 

+\sec GDB License;
+show copying&Display GNU General Public License\cr
+show warranty&There is NO WARRANTY for GDB.  Display full no-warranty
+statement.\cr 
+\endsec
+

 
 \vfill
 {\smrm\parskip=6pt
 
 \vfill
 {\smrm\parskip=6pt

-\centerline{Copyright \copyright 1991 Free Software Foundation, Inc.}
-\centerline{Roland Pesch (pesch@cygnus.com), May 1991---\manvers}
-\centerline{The author assumes no responsibility for any errors on this card.}
+Copyright \copyright 1991-2019 Free Software Foundation, Inc.
+Author: Roland H. Pesch
+
+The author assumes no responsibility for any errors on this card.

 
 This card may be freely distributed under the terms of the GNU
 General Public License.
 
 
 This card may be freely distributed under the terms of the GNU
 General Public License.
 

-\centerline{Please contribute to development of this card by annotating it.}
+Please contribute to development of this card by
+annotating it.  Improvements can be sent to bug-gdb@gnu.org.
+
+GDB itself is free software; you are welcome to distribute copies of
+it under the terms of the GNU General Public License.  There is
+absolutely no warranty for GDB.

 }
 \end
 }
 \end