Commit graph

292 commits

Author SHA1 Message Date
John Gilmore
6066cdfc0d Rearrange "how to install" and "how to print the doc" stuff so it drops
easier into README.
1991-09-21 02:59:57 +00:00
Roland Pesch
432ae9a94b add missing index entries for set/show print sevenbit-strings. 1991-09-21 02:55:37 +00:00
Roland Pesch
376de38d61 Update configs table. 1991-09-21 02:01:41 +00:00
John Gilmore
aeb62c7b50 Roll in information from README. 1991-09-21 01:50:26 +00:00
Roland Pesch
1c484dd7cb Extract GDB version number from main GDB dir Makefile.in. 1991-09-20 22:43:47 +00:00
Roland Pesch
73c9796dac Merged in new doc on language setting, C, and Mod-2 by Andrew Beers;
cleanups to node structure.
1991-09-20 21:43:19 +00:00
John Gilmore
006774c48a Remove rcfonts.tex after building refcard. 1991-09-20 08:18:16 +00:00
Roland Pesch
97f3cb7275 Reorder contents; reorganize new-host, new-target, and new-config
chapters; fix minor typos; come closer to usual GNU markup conventions
for @file @samp @code @var.
1991-09-20 00:40:36 +00:00
John Gilmore
7f09f15fcb Doc how to add a language. 1991-09-18 22:56:28 +00:00
John Gilmore
1dbe1ef797 Add info about porting to new hosts and targets. 1991-08-23 23:13:03 +00:00
Roland Pesch
fad60036f7 generate "gdb-all.texi" rather than "gdb-all.texinfo" 1991-08-23 22:46:53 +00:00
Roland Pesch
8b5d2c4e96 * rdl-apps.texi: renamed from rdl-apps.texinfo
* Makefile, .Sanitize, gdb.texinfo: reflect above name change
1991-08-23 22:35:42 +00:00
Roland Pesch
d98259f8ac * doc/gdb.texinfo: update New Features, Installing
* doc/gdbint.texinfo: add short description of configure +template
1991-08-23 21:09:33 +00:00
John Gilmore
b32604106a Keep rdl-apps.texinfo for users who don't read the doc on how to build the doc. 1991-08-22 07:59:45 +00:00
Roland Pesch
274862ad9e Default rdl-apps.texinfo, for people who don't think to use the
Makefile; this one will work if this dir is in the default relative position
to the readline directory in the GNU libraries-and-includes distribution.
1991-08-07 02:15:57 +00:00
Roland Pesch
73dfae8d22 Makefile: GDB documentation nos has its own Makefile
.Sanitize: add Makefile; recognize renamed refcard.tex (formerly gdbrc.tex)
gdbint.texinfo: add markup in "Cleanups" chapter
1991-08-07 00:15:02 +00:00
Roland Pesch
7bfa94e296 *** empty log message *** 1991-08-01 22:39:43 +00:00
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
Roland Pesch
23e2e5e133 Document "info set"; minor cosmetic fixes;
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.
1991-03-07 00:32:12 +00:00
Roland Pesch
ca714d0352 Add texinfo wrappers 1991-03-05 00:14:55 +00:00
Roland Pesch
54e4a398e3 (1) formatting cleanup to permit @smallbook
(2) moved GPL to end
(3) @index{foo} -> @cindex{foo}
1991-02-20 01:57:12 +00:00
John Gilmore
056c1b2c3b Add copyright and contributor line. 1991-02-14 17:38:06 +00:00
John Gilmore
46bc46ebd7 * gdb-int.texinfo: Add text on how to define a new host or target
architecture, prompted by Per Bothner's questions about MIPS
        support.
1991-02-05 23:47:22 +00:00
John Gilmore
d62719de80 * gdb.texinfo: Document "complaints". Change doc of -q since
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.
1991-02-05 22:05:25 +00:00
John Gilmore
bbb5013f21 Allow gdb functions to specify where a line should wrap if it
exceeds the size of a terminal line.  Use it to make the output
        prettier.
1991-01-20 03:59:13 +00:00
John Gilmore
a58d77add9 Document "set demangle", line wrapping, and expanded addressprint. 1991-01-20 03:53:48 +00:00
Roland Pesch
bca4316904 Initial revision 1991-01-03 16:28:29 +00:00
Roland Pesch
1bc93cb7a0 Use different 1st chapter name from manual title
(manual: Using GDB; chap 1: GDB Commands and Displays)
(both were "using..."
1991-01-02 11:27:17 +00:00
Roland Pesch
880d228b30 Fixed a few spelling errors. 1990-12-31 16:45:38 +00:00
Roland Pesch
26376b06b8 Minor adjustments and corrections. 1990-12-31 16:22:45 +00:00
Roland Pesch
d2e0842135 Merge in pesch improvements, comments from tiemann and gnu. 1990-12-29 21:38:34 +00:00
John Gilmore
7f27984ee0 * gdb-int.texinfo: Add minor sections on configuring gdb for
release, and about the README file.
1990-12-28 01:12:03 +00:00
Roland Pesch
9da601bfb7 Include last new commands for current gdb release.
This version is TeX clean, and only fails info formatting in the
Appendix (Brian Fox's include docs for readline).
1990-12-19 22:37:41 +00:00
Roland Pesch
4afc600204 Fix TeX bugs introduced in last pass. 1990-12-19 15:56:47 +00:00
Roland Pesch
9c91ee3eef Incorporate changes from J. Gilmore on targets; also Pesch cosmetic
changes and corrections based on feedback from "BLEWIS" at Sun.
1990-12-19 13:30:35 +00:00
John Gilmore
cfddbd02bf gdb-int.texinfo: New file, for GDB internals documentation.
Very simple, unformatted doc of cleanups is there for now.
1990-12-19 12:51:23 +00:00
Roland Pesch
6ad6aa5225 Merge in Tiemann's October 1990 updates from Sun with this line of updates;
introduce version-number output on copyright page.
1990-12-17 18:23:17 +00:00
John Gilmore
0bed999441 Merge directory changes from 1.3 with Laura's diffs in 1.4. 1990-12-13 17:32:56 +00:00
John Gilmore
f222d23d35 Initial revision 1990-12-13 15:49:06 +00:00
John Gilmore
96a816c5b8 Laura's version 1990-11-09 18:30:56 +00:00
John Gilmore
845dbc2a16 * gdb.texinfo (directory command): Doc new dir command. 1990-10-02 19:17:55 +00:00
John Gilmore
45007746d3 Merge in 3.91.11 changes 1990-09-05 19:19:18 +00:00
John Gilmore
831c851165 Initial revision 1990-09-05 17:54:31 +00:00