versus functions without line numbers, also mention stepping into
them as well as "step" when you are in them. Tell the user how to
deal with the situation. Add comment about "debugging information".
(Summary, C): fix xrefs in newly contributed text.
(Threads): index entries, clarifications, example
(passim): minor typos fixed, phrasing improvements
* remote.texi (Bootstrapping): rephrase text on ^C and add index
entries; (Server): explain use of gdbserver w/real-time systems,
add example of conflicting TCP port; (MIPS Remote) break up
running text into table, highlighting commands, and add example.
good results, say they have to use stabs. Specifically say cfront
doesn't work well.
(Summary): Merge in information on Modula-2, Pascal, and Chill from
the gdb README. Add xrefs to places where the support for the various
languages is described in detail.
* a4rc.sed: update to work with Andreas Vogel papersize params
* refcard.tex: use Andreas Vogel simplifications of papersize
params; remove useless version info; update copyright date.
* Makefile.in: depend on remote.texi rather than gdbinv-s.texi
* remote.texi: (Server) New node on gdbserver. (Remote Serial,
ST2000 Remote, MIPS Remote): mention `host:port' syntax for TCP.
* remote.texi: new name for former gdbinv-s.texi
* gdb.texinfo: use remote.texi rather than gdbinv-s.texi
input when evaluating breakpoint conditions; the bug has been fixed.
* gdb.texinfo (Continuing and Stepping): Argument to "continue"
sets the ignore count to N-1, not to N.
RMS says this manual need not carry GPL. (passim): Improvements
from last round at FSF, largely due to Ian Taylor review, and
minor formatting improvements.
* gdbinv-s.texi (passim): Improvements from last round at FSF,
largely due to Ian Taylor review. (Debug Session): minor edits to
new text.
DOSHOST configuration of manual. (At least for the nonce, since
precisely how this works under DOS seems to depend on mysteries known
only to DJ Delorie, which are not easily fathomed from his source.)
* all-config.texi (MIPS) new switch.
* gdbinv-s.texi (Nindy Options) Remove two instances of future
tense; (MIPS Remote) new node.
* gdb.texinfo (passim) rephrases to work around makeinfo @value
bug; (Environment) less passive, other small cleanups in text about
.cshrc/.bashrc; (Invoking GDB) new MIPS Remote menu entry;
(Remote) new MIPS Remote menu entry.
* doc/gdb.texinfo: make node "Shell Commands" unconditional;
describe `set demangle-style arm' (not cfront);
mention can type `q' to discard output, when gdb pages
gdb.texinfo: advance manual revision dates to present
gdbinv-s.texi, gdb.texinfo, all-config.texi, h8-config.texi:
stop using silly Roman numerals in @set variable names
(the usual) non-specialized versions of the manual.
gdb.texinfo: list of nonstandard init file names, with brief descriptions
(permits closing PRMS gdb/2296).
(a) to make H8 configuration come out right (first attempt since
conversion to texinfo conditionals);
(b) to exploit yesterday's makeinfo bugfix, using conditionals in menus
rather than multiple alternative menus.
2. Update H8 text to refer to H8/500 as well as H8/300.
3. Define config file gdb-config.texi as a link in Makefile, based on a
DOC_CONFIG variable.
Formatting these files now depends on the recently designed
Texinfo conditionals: to format successfully, you must use very
recent versions (not yet distributed by FSF) of texinfo.tex and makeinfo.c.
The new Texinfo commands are @set, @clear, @ifset, @ifclear, and @value.
Recent texinfo-2 Beta distributions contained partial implementations.
texi2roff does not yet support these commands.
There are miscellaneous clean-ups to Makefile.in as well.
pass at doc for two new remote targets---29K using UDI, and Tandem
ST2000 using STDBUG.
* doc/all.m4, doc/none.m4: new m4 switch, _ST2000__
* doc/all.m4: turn on H8/300 stuff for generic manual
* doc/gdb.texinfo: fix shameful error of agreement reported by
jimb@occs.cs.oberlin.edu (Jim Blandy)
* doc/gdb.texinfo: remove old partial discussion of remote serial
protocol (via serial debug stubs)
* doc/gdbinv-m.m4.in, doc/gdbinv-s.m4.in: new section discussing
use of serial debug stubs
* gdbinv-s.m4.in: refrain from using @cartouche for just a few
examples (not consistent w others).
gdb.texinfo: issue disclaimer paragraph on cmdline options only
for generic vn of doc
* gdb.texinfo, none.m4, h8.m4, gdbinv-s.m4.in: improve H8/300
conditionals; introduce a few generic switches that may be
useful for other cross-dev or dos-hosted configs.
* gdb.texinfo: fix typo in "info reg" description
NOT full config doc) and xref to configure.info
(2) add brief mention of --help and --prefix=DIR configure options
(3) re-enable, with new command names, old doc for commands now
reorganized into maint. (NO new doc yet for new maint commands or for
old undoc'd dump-me; nor for "maint" itself in general.)
(2) [temporarily, until "maint" details avail] hide explanations of commands
moved to "maint" so we don't risk releasing doc with obsolete names:
printsyms, printmsyms, printpsyms, info all-breakpoints.
appendix (too hard to maintain, esp w/recent versions of config.sub).
Also corrected xref to this section accordingly.
(2) updated sample output from config.sub to match latest variation of
that script
(3) minor editing to gnu contrib text on set/show remotedebug
* gdb.texinfo: slight expansion of new text on reading info files
* gdbinv-s.m4.in: correct and expand info on cross-debugging
H8/300 from DOS.
* ChangeLog: guess...
Documentation' ahead of `Installing GDB' to match README.
Update shared library doc, -readnow and -mapped, and directory
structure (add glob and mmalloc). Update configure doc.
of *options* "-readnow" and "-mapped".
1) Change title/subtitle to come closer to text used by FSF when they
printed this thing (but still avoid silliness of having word "manual" in
the title).
2) First few minor corrections from most recent Chassell pass.
(2) Add fnf to GDB credits for SVr4 stuff. (Need to sift ChangeLog again for
more recent credits).
(3) document "mapped", "readnow" keywords (with file or symbol-file commands;
for now no mention of add-symbol-file in this context), -m and -mapped
cmd-line options, and associated explanations.
printpsyms.
(2) Fix errors found by makeinfo.
(3) Initial docn for "info proc" and its subcommands. Should probably
be expanded somewhat after implementation complete.
lucid.m4: config for Lucid/NCR (like "all.m4" but also turns on _LUCID__)
none.m4: turn _LUCID__ off by default
gdb.texinfo:
1) Use bold rather than italic for user input in intro, to avoid discord
with meta-variable convention throughout manual (jim@wrs.com suggestion).
2) Some mumbling about using GDB under Energize/Cadillac.
(conditionalized on _LUCID__, not included yet in general-doc config)
3) more remarks about debugging optimized code, incl vanishing unused vars
(rms/gnu/net suggestion).
4) @emph replaces @i in a few spots (emphasis should affect info file as
well as printed manual).
5) "memory tracing", "breakpoint on variable modification" index entries
added, pointing to watchpoints (gnu suggestion).
6) Less passive, more index entries, in breakpoint-number description
7) doc new convenience var $bpnum (due to grossman?)
8) Update "info breakpoints" to describe new Grossman format; note now
synonymous with "info watchpoints".
9) Describe negative (GDB internal) breakpoints and new "info all-breakpoints"
10) Slight change to description of colon-colon GDB expression notation,
describing function::var as well as file::var and noting var is static
(lmb question, gnu suggestion)
11) Doc Per's new &(&foo) for debugging C++
12) Rephrase paragraph in configure appendix to avoid overfull box
(in *large* format!)
13) Additional warning re VPATH feature required for --srcdir= config.
(gnu suggestion)
survive M4 filtering but still tell people the original source was
M4'd;
(2) Also for B.C., include one more emphasis font in @colophon at end;
(3) Thanks to J Gilmore, strengthen wording about unsupported
combinations of host-manufacturer-OS in config Appendix.
(1) repair refs to readline includes to use new shorter filenames
(2) provision for texi2roff conversion of doc via Makefile
(new targets: gdb.mm, gdb.me, gdb.ms).
@example/@end example. Without this it formatted fine by
texinfo-format-buffer in Emacs, but makeinfo insisted on paragraphing
it!
Also removed "gdb/" from in front of one instance of libiberty...
Minor typo and formatting fixes; incorporated most fixes remaining from
filed mail commenting on earlier drafts.
Added warnings: pipes don't work in run command;
conditions are converse of assertions;
step over fn without debug info goes to next fn;
vars may have "wrong" values near fn entrance, exit
Added example from Kingston on printing repeated nonadjacent values
Added explicit mention that in Emacs gdb mode C-c and C-z are like
shell mode for signals
Improved installation directions in appendix, added manual formatting
instructions
Renamed "Stepping and Continuing" to "Continuing and Stepping" so it
doesn't sound so much like its parent "Stopping and Continuing"; also
moved entries on continue to top of section, so they don't get lost.
through chapsec 5.2)
(2) Eliminated use of @footnote---had my doubts about it anyways, and
it's broken in latest texinfo
(3) Introduced *some* use of [] for optional arguments, where
explanation is not simpler by listing cmd w arg and cmd w/out arg
separately. Still not using @deffn.
(4) Dropped in GPL-2. NOTE: one of GPL-2 or texinfo is broken; a
couple of headings are too long. Need patches to texinfo or revision
to GPL-2.
page (had crept onto front of title page w/ other stuff migrating between
gdb.texinfo and gdb.top-m4).
2) gdb.top-m4: added Detailed Node Listing to main menu.
made $Id: for fragment into texinfo comment.
in gdb.top-m4 when files were split), for continuity in version
numbering: the version of the manual is the version of the layout file.
(By R. Pesch fiat).
instructions to "Targets" chapter for generic manuals, while
leaving them up front for manuals specific to specialized
environments; apply fixes from RMS comments through chapter 4.
Update stuff on option flags, full text, mention -help;
Better localization of target-specific stuff;
introduce 'path' command and discussion of exec path as opp src path;
document which commands don't repeat w RTN;
update and improve several examples, eg deleting (...)
Throughout: attempts to clarify etc.
(2) fix two bugs reported by Per Bothner;
(in markup for makeinfo)
(3) eliminate info structural information that can be generated
by texinfo-master-menu.
1a) Isolate Nindy-960 stuff into subsection of above, and expand it;
(2) Expand GDB-under-Emacs chapter;
(3) Minor cosmetics, including small free software blurb at front to
make RMS feel better about GPL moved to back.
document transmutation of add-file into sym-file and new meaning for
"load" (dynamic link/download, target-rel); document "info target" and
warn about similarity with "info targets"; document target strata rather
than stack; document "up-silently" and "down-silently"; add text about
when value history discarded.
gdb no longer prints the copyright and blurb if you specify a file
name to be debugged (just like Emacs). Add doc for Nindy-specific
command line flags for specifying target serial port and such.
Update copyright to 1991.
Jim Kingdon