Commit Graph

75 Commits

Author SHA1 Message Date
Roland Pesch
cf4964159d Surrounded table of renamed commands (version within @ifinfo) with
@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...
1991-08-01 00:02:27 +00:00
Roland Pesch
3d3ab54002 Last cleanups for release 3.98:
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.
1991-07-31 23:35:22 +00:00
Roland Pesch
07d06baa0f Updated list of files to keep to reflect reintegration of most fragments
into gdb.texinfo.
1991-07-29 22:38:53 +00:00
Roland Pesch
54e6b3c33a Fixed a variety of small typos that prevented info from formatting cleanly;
altered too-long heading for GPL Appendix, as discussed w/RMS;
Changed date on cover to July 91.
1991-07-29 22:20:33 +00:00
Roland Pesch
7463aadd5b (1) Applied some fixes due to comments from Larry Breed (easier ones
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.
1991-07-27 00:49:54 +00:00
Roland Pesch
70b887611a (1) Re-incorporated former M4 fragments into this file; GNU m4 >=0.84
no longer crashes on long docs.

(2) Included some improvements based on Larry Breed's comments.
1991-07-25 19:35:27 +00:00
Roland Pesch
16e58d9172 Turned $Id: from m4 comment into texinfo comment, allowing fragment
boundaries to be recognized in post-m4 texinfo source.
1991-07-24 01:51:32 +00:00
Roland Pesch
271895931a 1) turned $Id: from m4 into texinfo comment
2) disabled @group where no longer supported by texinfo.tex
1991-07-24 01:50:33 +00:00
Roland Pesch
8734fc33eb 1) moved author email addresses and manual version info back onto copyright
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.
1991-07-24 01:43:47 +00:00
Roland Pesch
5dac81188a Fix braces in example (@{ @} not {}), spotted by makeinfo.
Allow fragment's $Id: to be texinfo comment.
1991-07-24 01:40:47 +00:00
Roland Pesch
ff2e4391f7 1) Added conditionals around node structure, giving clean nodes for either
generic or cross-debugging manual.

2) Allowed $Id: to be texinfo comment.
1991-07-24 01:37:46 +00:00
Roland Pesch
54e4cbe8f0 1) Added conditional markup around node transitions, so node structure correct
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.
1991-07-24 01:36:11 +00:00
Roland Pesch
0e1b12ce0d Tried allowing $Id: to appear in final output, but it confuses makeinfo
(the texinfo comment appears inside a menu).  Revisit someday.
1991-07-24 01:34:39 +00:00
Roland Pesch
1190271968 1) "dots{}" -> "@dots{}" (spotted by makeinfo)
2) $Id: tag appears in post-m4 text
1991-07-24 01:30:45 +00:00
Roland Pesch
9d40ea3c82 1) Inserted missing @end table/@table spotted by makeinfo;
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
1991-07-24 01:28:51 +00:00
John Gilmore
eb752e4e4e Add information about the symbol-reading interface. 1991-07-21 12:16:38 +00:00
K. Richard Pixley
a3e6538284 First cut. 1991-05-23 21:57:03 +00:00
Roland Pesch
0e0fa7cea4 Move definition of \manvers back into gdb.texinfo (had been captured
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).
1991-05-23 00:35:54 +00:00
Roland Pesch
9bcc06ef16 *** empty log message *** 1991-05-23 00:14:26 +00:00
Roland Pesch
a02da681db *** empty log message *** 1991-05-20 19:17:48 +00:00
Roland Pesch
99a99fd253 * doc/gdb.texinfo: finished using all RMS comments, save those for
appendices on readline and cmd history (which are in other source
	files)
1991-05-17 21:43:01 +00:00
Roland Pesch
04ec2f3010 * doc/gdb.texinfo: (1) Updated w/ref to RMS comments through
chapter 9; (2) documented 'break' command's menu mode for
	overloaded names, in response to hgs problem report C++ p-31
1991-05-17 01:10:52 +00:00
Roland Pesch
bfda3f2ee9 Divert specialized startup
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.
1991-05-16 04:09:30 +00:00
Roland Pesch
a3bb247ef0 (1) new Appendix, Renamed Commands;
(2) new leading subsection, Contributors to GDB
1991-05-16 02:16:27 +00:00
Roland Pesch
9c3ad54799 * gdb.texinfo: (1) better introductory example; (2) more
consistent use of @code, @samp, @file, @kbd throughout; small
	cleanups to first three nodes.
1991-05-16 00:46:09 +00:00
Roland Pesch
92d3036028 Wed May 15 11:02:48 1991 Roland H. Pesch (pesch at fowanton.cygnus.com)
* 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...)
1991-05-15 18:10:40 +00:00
Roland Pesch
022cb4c5e1 *** empty log message *** 1991-05-14 22:01:19 +00:00
Roland Pesch
14719f8df6 *** empty log message *** 1991-05-14 20:55:08 +00:00
Roland Pesch
98088880f3 (1) Updated to reflect renamed commands;
(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.
1991-05-07 19:38:33 +00:00
Roland Pesch
6df47a7407 Minor adjustments for clean info-formatting. 1991-04-15 20:30:47 +00:00
Roland Pesch
b48914e1e0 Repair missing xrefs. 1991-04-06 00:46:23 +00:00
Roland Pesch
efd784ca05 Added John Gilmore's advice on subdirs to installation appendix. 1991-04-06 00:13:19 +00:00
Roland Pesch
52d9ccbbae RENAMES: "demangle" and "asm-demangle" now "set print" subcmds. 1991-04-06 00:00:46 +00:00
Roland Pesch
413130bd46 ADDED:
show copying
show warranty
1991-04-05 23:54:17 +00:00
Roland Pesch
41d786f7a5 Changes agreed w/gnu, summarized in mail of Tue Apr 2 15:52:44 1991
RENAMES:
 add-syms -> add-symbol-file
 info->show convenience
 info->show directories
 info editing->show commands
 info->help targets
 info->show values
 info->show version
 set subcommands:
  addressprint->print address
  arrayprint->print array
  prettyprint->print pretty
  screen-height->height
  screen-width->width
  unionprint->print union
  vtblprint->print vtbl
DELETED: info history (syn "show values" remains)
ADDED: help target BLAH
1991-04-05 23:35:32 +00:00
Roland Pesch
c989dc8e6f General editing pass. Highlights:
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.
1991-04-05 22:48:39 +00:00
John Gilmore
07d021a6ae Initial revision 1991-04-05 09:01:15 +00:00
Roland Pesch
8922ff76e3 (1) fix macro invocation of _GDBN__ that didn't expand due to adjacent 's';
(2) attempt better text for when register relativization makes no diff.
1991-04-04 00:33:18 +00:00
Roland Pesch
08665207c0 Corrections due to RMS.
(and improvements).
1991-04-03 23:49:07 +00:00
Roland Pesch
d008dd076c Added VxWorks subsection to chapter on getting in/out 1991-04-02 01:07:13 +00:00
Roland Pesch
01b25dab88 (1) further restructuring;
(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.
1991-04-01 23:52:17 +00:00
Roland Pesch
fe3f5fc828 Restructured manual; introduced introductory sample session. 1991-03-30 02:13:24 +00:00
Roland Pesch
1695733e8a Corrections to:
(1) back of title page---show title next to rev number;
(2) DOSish examples for 29K
1991-03-28 21:26:03 +00:00
Roland Pesch
5a131cc7f0 (1) small cleanups on intro sections
(2) introduce M4 configuration macros
1991-03-28 01:03:49 +00:00
Roland Pesch
cb9d20492a (1) bring in material on 29K from 2.8.1.2 branch;
first stab at updating it for "target amd-eb" rather than "attach".
(2) some minor massaging for @smallbook format.
1991-03-27 01:22:25 +00:00
Roland Pesch
c81e78d17f Fix typos in descriptions of asm-demangle, attach, and load;
fix index entry for detach.
1991-03-09 01:16:32 +00:00
Roland Pesch
616875fdef add @finalout to turn off DRAFT flags (this is distributable 3.94 doc) 1991-03-08 23:46:53 +00:00
Roland Pesch
9d7c0513e4 (1) document fg, revise 'attach' docn;
(2) assorted corrections and clarifications.
1991-03-08 23:04:15 +00:00
Roland Pesch
469ddd56b0 Fix screwed up xref. 1991-03-08 01:54:15 +00:00
Roland Pesch
369a6ade1c (1) Drag various bits and pieces into a "Starting GDB" chapter at the front;
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.
1991-03-08 01:39:43 +00:00