(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
WARNING: (1) this has not yet been proofread as a printout---just eliminated
problems that TeX complained about.
(2) extraneous line breaks introduced in some examples, sometimes
in ridiculously long strings; this may falsify examples. Places
where I did this are marked by FIXME comments.
1) use makeinfo node defaulting
2) correct bad xref
3) use @display, @exdent, etc. as first approximation to Julia's
clever typewriter markup; **THIS WILL NEED STUDY AND REVISION**
4) introduce many nodes rather than ---- in "detailed reference" appendix
* 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)
checked in earlier. These are Makefiles relevant to the progressive
release currently in progress.
* added exec_prefix
* default bindir now exec_prefix/bin
* default libdir now exec_prefix/lib
* default mandir now prefix/man
* default infodir now prefix/info
* added oldincludedir, default NULL
* remove all traces of the old -subdirs and -namesubdir support,
including code, for loops, and all subdir/unsubdir stuff.
* remove old style staging targets {de-}stage[1234], comparison,
bootstrapN, from all but the bootstrappable tools.
* added check targets.
* removed any "Last Mod" lines.
* forced copyrights to '92 and shifted some from Cygnus to FSF.
* added tooldir and program_prefix where needed.
* updated texinfo and man pages, removed all references to multiple
hosts or targets.
FSF preferences (format definitions, nee threecol.tex, and
default font defs, nee rc-cm.tex, now both directly in this file).
lpsrc.sed, psrc.sed: alternate font defs, now sed scripts to modify refcard.tex
Makefile.in: use sed -f psrc.sed to produce refcard.ps target; new
target lrefcard.ps for sites using long PS font names
Removed old auxiliary TeX files, no longer necessary with this scheme.
- remove inappropriate use of unsubdir (worked only accidentally)
- make gdbVN.m4 generation work from remote objdir too;
- fix bug in handling of readline appendices for roff translations
- let GDB internals have the right val of TEXINPUTS for remote format, too
* Makefile.in: remove spaces following hyphens, bsd make can't
cope. install using INSTALL_DATA. added clean-info. added
standards.text support.
Thu Dec 5 22:46:12 1991 K. Richard Pixley (rich at rtl.cygnus.com)
* Makefile.in: idestdir and ddestdir go away. Added copyrights
and shift gpl to v2. Added ChangeLog if it didn't exist. docdir
and mandir now keyed off datadir by default.
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.
for either generic manual (material near back, in "targets"), or for special
cross-debugging manuals (material near front, in "invocation").
2) Allowed $Id: tag to appear as texinfo comment.
2) allowed $Id: tag to appear in post-M4 file by turning it into texinfo
rather than m4 comment;
3) Disabled @group where no longer supported by texinfo
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.
* pretex.m4: modify explanatory text slightly (and redefine
"regexp") to keep GNU m4 from complaining. (It still crashes
later, but one step at a time...)
(2) Reorganized, bringing more common commands forward, merging
"print" and "x" into one section;
(3) New sections: "Essential Commands", "GDB Scripts";
(4) Material on convenience vars and value history added to "Expressions";
(5) Uses PostScript fonts by default, also includes (commented out) alternative
Computer Modern font definitions that format similarly.
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.
