3 * gdbint.texinfo (Using Different Register and Memory Data
4 Representations): New section.
5 (REGISTER_CONVERTIBLE, REGISTER_RAW_SIZE, REGISTER_VIRTUAL_SIZE,
6 REGISTER_VIRTUAL_TYPE, REGISTER_CONVERT_TO_VIRTUAL,
7 REGISTER_CONVERT_TO_RAW): Document.
11 * gdb.texinfo (Protocol): Deprecate the sequence-id. Add cindex
16 * gdb.texinfo (Protocol): Replace ``qfThreadExtraInfo'' with
21 * gdb.texinfo: Clarify which remote debug protocol commands are
22 required and which are optional.
26 * gdb.texinfo: Revert remainder of Fri Mar 24 18:06:34 2000 Andrew
28 back to annotate.texi, rluser.texinfo and inc-hist.texinfo.
29 * annotate.texi: Update.
33 * gdb.texinfo: Update dates, bump to Eighth Edition (note
34 expectation of additional changes before release), update
35 ISBN, add copy of top-level menu for @ifhtml, remove explicit
36 node links, rephrase and/or shorten lines to fix formatting
37 problem in both regular and @smallbook formats.
38 * annotate.texi: Shorten lines in example, use smallexample
39 consistently everywhere.
40 * Makefile.in: Add comment about texinfo 4.0 html generation.
41 (SFILES_INCLUDED): Add annotate.texi.
45 * gdb.texinfo (Debugging Output): Added new section, documenting
46 the "set/show debug" commands.
50 * annotate.texi (Annotations): When GDBN omit @chapter and @node
53 * gdb.texinfo: Check for @ifinfo instead of @ifnottex.
54 (rluser.texinfo, inc-hist.texinfo, annotate.texi): Add local
55 @chapter and @node entries.
57 * gdb.texinfo: Link all top-level nodes.
61 * Makefile.in (install-info): Create $(infodir) before installing
67 * gdbint.texinfo : Added paragraphs about command deprecation.
71 * gdb.texinfo: Add documentation for the apropos command.
75 * gdb.texinfo: Add new queries ThreadInfo and ThreadExtraInfo.
79 * gdb.texinfo: Add white space to prevent overprinting in
84 * gdb.texinfo: Many minor changes from Dmitry Sivachenko
90 * gdb.texinfo (main menu): Add Annotations.
91 (File Options): Add @cindex entries for each command-line option.
92 Document --epoch, --annotate, --async, --interpreter, --write,
93 --statistics, and --version.
95 * annotate.texi: Convert to a chapter. Use @value{GDBN} instead
100 * gdbint.texinfo (FUNCTION_START_OFFSET): Document.
104 * gdbint.texinfo: Document COERCE_FLOAT_TO_DOUBLE --- the new form.
108 * Makefile.in (diststuff): New target.
112 * agentexpr.texi: Fix wording regarding Intel's IA-64
113 architecture. [From Jim Wilson.]
117 * gdb.texinfo (Breakpoints): Mention breakpoint ranges.
118 (Delete Breaks): Mention range arguments.
119 (Disabling): Likewise.
123 * gdb.texinfo: Wrap "ASCII" in @sc{}; clarify a few sentences.
127 * gdbint.texinfo (FRAME_CHAIN_VALID): Add the generic frame-chain
132 * gdb.texinfo: Clarify regular expressions used in rbreak.
136 * gdbint.texinfo (MEMORY_INSERT_BREAKPOINT,
137 MEMORY_REMOVE_BREAKPOINT): Document.
141 * gdb.texinfo (remote): Document how GDB ignores the qOffsets BSS
142 offset re-using the DATA offset instead.
146 * gdbint.texinfo (Target Architecture Definition): Add PARM_BOUNDARY.
151 * gdb.texinfo: Use GDBP and GDBN everywhere, fix a couple other
154 * gdb.texinfo: Various minor wording and formatting improvements,
155 mentions of additional command-line options.
159 * gdb.texinfo: Document additional forms of specifying section
160 names and addresses for the add-symbol-file command.
164 * gdbint.texinfo: Fix typo, add the word "have".
168 * gdbint.texinfo (Target Architecture Definition): Document the
169 SKIP_PERMANENT_BREAKPOINT macro.
173 * gdb.texinfo: Fiks speling errers.
175 * gdb.texinfo: Fix uses of @multitable.
178 * gdb.texinfo: Include details specific to DOS host, clarify
179 some confusing language, fix @ref/@xref/@pxref usages, add
180 comments about using with optimization, add more indexing,
181 fix info about disassembly-flavor.
185 * gdbint.texinfo (IN_SOLIB_DYNSYM_RESOLVE_CODE,
186 SKIP_SOLIB_RESOLVER): Define.
190 * gdb.texinfo (Protocol): Review. Add tables describing ``q'' and
195 * gdb.texinfo: Create a new "Configurations" chapter with
196 platform-specific info, inline remote.texi and move sections of it
197 into the new chapter, move bits about info proc, heuristic search,
198 and register stack into the new chapter.
199 * remote.texi: Remove, now part of gdb.texinfo.
200 * Makefile.in (SFILES_INCLUDED): Remove ref to remote.texi.
204 * gdbint.texinfo (GDB_TARGET_IS_SUN3, GDB_TARGET_IS_SUN386,
205 GDB_TARGET_IS_MACH386): These kludges have gone away.
209 * gdbint.texinfo (Target Architecture Definition): Mention
214 * gdb.texinfo: Remove remaining "HPPA" conditionals, rewrite
215 surrounding text to fit HP-UX bits into general info.
216 (HPPA-cfg.texi): Remove, no longer useful.
218 * gdb.texinfo: Remove explicit links from @node lines, remove
219 HP-added "Detailed Node Listing" from main menu which confuses
223 * gdb.texinfo: Use @value{GDBN} instead of plain GDB, fix grouping
224 in description of `set environment'.
228 * gdbint.texinfo: Update coding standard to allow pure ANSI/ISO C.
232 * gdbint.texinfo (Breakpoint Handling): Add missing words.
236 * gdb.texinfo (Set Watchpoints): Explain some subtleties about
237 watch, awatch, and rwatch. Explain why the latter two cannot be
238 set as software watchpoints. Document that watchpoints for local
239 variables are deleted when the debuggee terminates.
243 * remote.texi (Protocol): Further clarification of the "qRcmd"
244 packet. Allow E.. response packet. "qRcmd" packet is no longer
249 * Makefile.in: Rename inc-hist.texi to inc-hist.texinfo.
250 * gdb.texinfo: Ditto.
254 * gdb.texinfo (KOD): New node.
258 * remote.texi (Rcmd): Fix minor formatting typos.
262 * remote.texi (protocol qRcmd): Allow ``OK'' and ``O...'' response
267 * gdbint.texinfo (PREPARE_TO_PROCEED, ADDR_BITS_REMOVE): Doc
272 * gdbint.texinfo (SAVE_DUMMY_FRAME_TOS): Define.
276 * remote.texi (Communication Protocol): ``v'' is in use. Fix
277 numerous formatting errors. Clarify ``i''. Mark ``i'', ``Z'',
278 ``z'' and ``qRcmd'' as draft instead of reserved. Identify
279 packets that are not supported on all hosts. Expand examples.
284 * Makefile.in: Recognize html, install-html. Add targets
285 to build HTML versions of documentation via texi2html.
289 * gdbint.texinfo (Testsuite): New chapter, information about the
294 * remote.texi (Communication Protocol): Rewrite.
298 * stabs.texinfo: Fix uses of xref.
302 * gdbint.texinfo: Add an anti-printf exhortation, and update the
303 info about patch submission.
308 * gdb.texinfo: Document Chill support.
312 * gdbint.texinfo (SP_REGNUM, FP_REGNUM, PC_REGNUM): Add reference
313 to corresponding TARGET_READ_reg TARGET_WRITE_reg macros.
314 Document that the value should be greater-than or equal-to zero.
315 (NO_STD_REGS): Document. Deprecate.
319 * gdbint.texinfo (TARGET_COMPLEX_BIT, TARGET_DOUBLE_COMPLEX_BIT):
320 Document that these are not used.
324 * gdbint.texinfo (EXTRACT_STRUCT_VALUE_ADDRESS_P): Document.
328 * gdbint.texinfo (FRAME_NUM_ARGS): Update definition. Parameter
333 * gdbint.texinfo (FRAMELESS_FUNCTION_INVOCATION): Update.
337 * gdbint.texinfo (SKIP_PROLOGUE, SKIP_PROLOGUE_FRAMELESS_P):
342 * gdbint.texinfo (USE_GENERIC_DUMMY_FRAMES): Document.
343 (GET_SAVED_REGISTER): Update, not just the a29k uses this.
347 * gdbint.texinfo: Fix typos: $ -> @.
351 * gdbint.texinfo (REGISTER_NAMES, BREAKPOINT, BIG_BREAKPOINT,
352 LITTLE_BREAKPOINT, LITTLE_REMOTE_BREAKPOINT,
353 BIG_REMOTE_BREAKPOINT): Deprecate in favor of REGISTER_NAME and
358 * gdbint.texinfo (CALL_DUMMY_STACK_ADJUST_P,
359 CALL_DUMMY_STACK_ADJUST): Document.
363 * gdbint.texinfo (CALL_DUMMY_P, CALL_DUMMY_WORDS,
364 SIZEOF_CALL_DUMMY_WORDS, CALL_DUMMY): Define.
368 * gdbint.texinfo (MAINTENANCE_CMDS): Remove ref, since it no
373 * gdb.texinfo, remote.texi, all-cfg.texi, HPPA-cfg.texi: Remove
374 nearly all @ifset/@ifclear conditionals; nobody uses them, and
375 they make the manual source incomprehensible.
376 * h8-cfg.texi: Remove, hasn't been used in years.
380 * gdb.texinfo: Update the credits.
384 * gdb.texinfo: Fix mistakes noticed in printout of last
385 draft, add Alpha to discussion of heuristic fence post.
389 * gdb.texinfo, remote.texi: Many changes; update to Seventh
390 Edition, merge some HP changes into mainline, describe some
391 previously undocumented features, describe more of the target
392 commands available, eliminate obsolete section on renamed
394 * all-cfg.texi, HPPA-cfg.texi: Remove some obsolete conditionals.
398 * gdb.texinfo: Make many HPPA conditionals unconditional,
399 including catchpoint description, since now on for all configs.
400 * all-cfg.texi: @clear HPPA, since is mainly for very HP-specific
405 * Makefile.in (GDBvn.texi): Fix match expression to work with
406 current format of VERSION in gdb/Makefile.in.
407 * gdb.texinfo: Fix node ref to match new readline.
411 * gdb.texinfo: Changes made as part of a project to merge in
412 changes made by HP. Documentation makes extensive use of
413 @ifclear HPPA and @ifset HPPA. The HP manual omits doumentation
414 on remote debugging. There are differences in documentation
415 (HP vs. non-HP) on C++ support (aCC vs. gnu gcc++). Also,
416 the HP manual discusses catchpoints, hardware watchpoints, and
417 some HPUX specific limitations for shared library support.
419 There are also a number of @node changes.
423 * gdbint.texinfo (Formatting): Disambiguate a sentence.
428 The following changes were made by Edith Epstein
432 * HPPA-cfg.texi: new file.
434 * all-cfg.texi: set HPPA for HP PA-RISC targets.
436 * refcard.tex: change documentation about catch.
441 * gdbint.texinfo: Expand on GDB's coding standards,
442 specify the use of arg names with prototypes.
446 * gdb.texinfo: Fix tipo.
450 * gdbint.texinfo: Document TARGET_BYTE_ORDER_DEFAULT and
451 TARGET_BYTE_ORDER_SELECTABLE_P.
455 * gdbint.texinfo (FRAME_FIND_SAVED_REGS): Document.
459 * agentexpr.texi: New file.
461 Wed Dec 9 21:13:57 1998 Andrew Cagney <cagney@chook>
463 * gdbint.texinfo (REGISTER_NAME): Replace REGISTER_NAMES.
467 * remote.texi: Changed wording that implied that the GDB remote
468 protocol caches register values instead of GDB itself.
472 * gdbint.texinfo: Add some info about symbol readers.
473 (CHILL_PRODUCER, etc): Comment out descriptions, not useful.
474 (IN_SOLIB_CALL_TRAMPOLINE): Rename info from IN_SOLIB_TRAMPOLINE.
475 (IN_SOLIB_RETURN_TRAMPOLINE): Describe.
476 (KERNEL_DEBUGGING, MIPSEL): No info about these, remove.
478 Mon Nov 30 11:32:21 1998 Andrew Cagney <cagney@chook>
480 * gdbint.texinfo (FRAME_CHAIN_VALID_ALTERNATE):
484 * gdbint.texinfo (INNER_THAN): Update, now takes parameters.
486 Fri Nov 27 12:39:45 1998 Andrew Cagney <cagney@chook>
488 * gdbint.texinfo (NO_SINGLE_STEP): Replace with
489 SOFTWARE_SINGLE_STEP_P and SOFTWARE_SINGLE_STEP.
493 * gdbint.texinfo: Fix minor typos.
497 * gdbint.texinfo: Complete overhaul. Group descriptions more
498 logically, add more info on generic algorithms, remove much
499 obsolete and/or wrong material.
503 * stabs.texinfo (Method Type Descriptor): Expand and correct.
507 * refcard.tex: Copyright, address updates.
511 * gdb.texinfo (EDITION, DATE): Update and change to use ordinals
512 for the edition instead of confusing GDB-version-like numbers.
516 * gdb.texinfo (hbreak, watch): Fix typo, "date" -> "data".
520 * LRS: Reformat a bit to keep text under 80 columns.
524 * gdb.texinfo: Add some credits, mention bug monitor.
525 * remote.texi: Mention mips monitor targets.
526 * gdbint.texinfo: Describe SP_REGNUM, STEP_SKIPS_DELAY.
530 * gdbint.texinfo: Remove obsolete mentions of pinsn.c and opcode.h
531 files, finish sorting of host vs target vs native macros, describe
536 * gdbint.texinfo (Host Conditionals): Document change from
537 using NO_MMALLOC to it's inverse, USE_MMALLOC.
541 * gdbint.texinfo (Host Conditionals): Document
542 PRINTF_HAS_LONG_DOUBLE, SCANF_HAS_LONG_DOUBLE, HAVE_LONG_DOUBLE.
546 * gdbint.texinfo (Host Conditionals): Add CRLF_SOURCE_LINES.
547 Document LSEEK_NOT_LINEAR.
551 * stabs.texinfo (Stab Section Basics): Make it clear that only
552 some versions of the GNU linker remove the leading N_UNDF symbol.
556 * stabs.texinfo (String Field): Document type number pairs here,
557 instead of in the Sun specific section.
558 (Include Files): The GNU linker supports the N_BINCL
559 optimization. Clarify the N_BINCL value, and what it is used
561 (Procedures): Document N_FUN with an empty string to mark the end
563 (Typedefs): Mention that Sun compilers may use N_GSYM for a type.
564 (Sun Differences): Remove this node, as the information is now
565 elsewhere in the main document.
566 (Stab Section Basics): Mention that the GNU linker may optimize
567 stabs and remove the leading N_UNDF symbol.
571 * gdb.texinfo, refcard.tex: Restore author credit
575 * gdbint.texinfo (SIGTRAMP_START, SIGTRAMP_END): Update
576 documentation to account for START and END macros taking
582 * gdb.texinfo (Frames): Fix typo.
586 * gdbint.texinfo (NO_SINGLE_STEP): Document that single_step takes
587 a target_signal as arg type, not a pid.
591 * gdb.texinfo: Document `set assembly-language'.
595 * remote.texi: Update list of stubs in the GDB distribution.
599 * gdbint.texinfo (NO_MMCHECK): Renamed from NO_MMALLOC_CHECK.
600 Also document that some systems can use mmalloc but must define
601 this if their C runtime allocates memory that is later freed.
602 (MMCHECK_FORCE): Document new macro.
606 * remote.texi: Add documentation for target Sparclet.
610 * Makefile.in (srcdir, VPATH, prefix, infodir, INSTALL,
611 INSTALL_PROGRAM, INSTALL_DATA): Use autoconf set values.
612 * configure.in: Rewritten for autoconf.
617 * Makefile.in (DVIPS): New define, set to dvips.
618 (dvi): Add stabs.dvi.
620 (all-doc): Depend on info, dvi, and ps targets.
621 (STAGESTUFF): Add *.ps and *.dvi files.
622 (clean-info, clean-dvi): Remove.
623 (mostlyclean): Does not depend upon clean-info or clean-dvi,
624 rules completely rewritten.
625 (maintainer-clean): Remove clean-info and clean-dvi
626 dependencies and put their actions in the rules.
628 (gdb.dvi, gdbgui.dvi, gdbint.dvi, stabs.dvi): Remove
629 intermediate TeX files, whether they have 2 or 3 character
631 (gdbint.ps): Add target and rules.
632 (gdb-internals): Delete unused target.
633 (Makefile): Depends upon config.status also.
637 * gdbint.texinfo (CC_HAS_LONG_LONG): Clarify when/how this is
643 * gdb.texinfo (Expressions): Fix erroneous array constant example.
647 * gdb.texinfo: Add missing "@bullet" to some "@itemize" commands.
651 * gdb.texinfo (Print settings): Document
652 `set/show print static-members' commands.
656 * gdbint.texinfo (Native): Document name change, coredep.c to
661 * stabs.texinfo (Include Files): Document the values the SunOS4
662 linker creates for N_BINCL/N_EINCL/N_EXCL stabs.
666 * gdbint.texinfo (Releases): Change gdb.tar.Z to gdb.tar.gz.
671 * gdbint.texinfo (Releases): Make "gdb.tar.gz" rather than
676 * Makefile.in (maintainer-clean): New target, synonym for
681 * Update all FSF addresses except those in COPYING* files.
686 * gdb.texinfo (convenience variables): Document $_exitcode.
687 (quit): Document optional expression to use as exit code.
691 * gdb.texinfo, remote.texi: Brought up to date with various
696 * gdb.texinfo: Update dates and versions, fix comments about
697 hardware watchpoints in future releases and about the
698 sharedlibrary command.
702 * stabs.texinfo: Remove node `XCOFF differences'. Describe value of
703 C_FUN stab. Other cleanups.
707 * remote.texi (Bootstrapping): Clarify that flush_i_cache is only
712 * annotate.texi: Clarify which addresses have differing formats
713 depending on the language and which do not.
717 * remote.texi (NetWare): Changed example to use BOARD= instead of
718 NODE= argument to reflect correspoding change to gdbserve.nlm.
722 * stabs.texinfo (Negative Type Numbers): Mention the fact that
723 GDB, as well as AIX dbx, supports the size type attribute.
727 * stabs.texinfo (Negative Type Numbers): Document types -31 to -34.
731 * gdb.texinfo (Define): Document $arg0... arguments to commands,
732 and new 'if' and 'while' commands.
736 * gdb.texinfo (Artificial arrays): Note use of coerce-to-array-type.
740 * all-cfg.texi: New flag, GDBSERVE, for NetWare's gdbserve.nlm.
741 * remote.texi (NetWare): New node, how to use gdbserve.nlm on
742 NetWare targets. Mostly stolen from the Server node.
746 * gdb.texinfo (Setting): Talk about the language of a source file
747 versus the working language. The old documentation did not match
752 * stabs.texinfo (Source Files): Document N_SO used to mark the end
757 * gdb.texinfo (Processes): New node.
761 * remote.texi: Update documentation of set/show mipsfpu.
765 * gdbgui.texinfo: New file, manual for GUI (gdbtk) users.
766 * Makefile.in (gdbgui.dvi, gdbgui.info): New actions.
770 * gdbint.texinfo: Removed mentions of some incorrectly placed and
771 obsolete conditionals, described some others.
775 * gdbint.texinfo: Remove references to BROKEN_LARGE_ALLOCA and
776 SET_STACK_LIMIT_HUGE; they were removed from GDB 14 May 1994.
780 * gdbint.texinfo: Put regex conditionals in their own table.
784 * gdbint.texinfo: Removed mentions of many obsolete conditionals,
785 described or fixed the descriptions of many others.
789 * gdb.texinfo: Add some more credits.
790 * gdbint.texinfo: Capitalize GDB consistently, describe some
791 macros and remove some.
795 * gdbint.texinfo: Removed mentions of many incorrectly placed and
796 obsolete conditionals, described some others.
800 * gdb.texinfo (help targets): Changed to `help target', which
801 is the correct gdb command.
805 * annotate.texi (TODO): New node, for keeping track of annotations
806 suggested but not yet implemented.
810 * stabs.texinfo (Statics): Value of xcoff C_BSTAT points to
811 another symbol, it is not the address itself.
815 * stabs.texinfo (Stab Section Basics): Add comment about alignment
816 of stabs-in-coff sections.
820 * annotate.texi: Change edition to 0.5 and date to May 1994.
822 (Frames): New node, for frame annotation.
823 (Displays): New node, for display annotation.
825 * remote.texi (MIPS Remote): Say that set timeout doesn't apply
826 when waiting for your program to stop.
830 * annotate.texi (Breakpoint Info): Document annotation of header
831 fields and record annotation.
835 * annotate.texi: New file, to document annotations.
839 * Makefile.in (clean): Don't remove GDBvn.texi (apparently on Jan
840 16 I meant to make this change but did not). Do remove gdb-cfg.texi.
844 * stabs.texinfo (Stab Section Basics): Say what is in .stab
845 section, and say n_strx field is compilation unit relative.
846 * stabs.texinfo: Don't use @code for a.out when it is the name of
847 an object file format.
851 * gdb.texinfo: Refer to file names, not path names, per rms
853 (Arguments): Fix typo.
857 * stabs.texinfo (Global Variables): Talk about stabs in files
858 where variables are referenced, but not defined.
862 * stabs.texinfo: Move stuff on @ and # type descriptors from node
863 Cplusplus to new nodes Member Type Descriptor and Method Type
864 Descriptor. Re-write stuff for #.
868 * gdb.texinfo (Print Settings): Don't document "set print
869 fast-symbolic-addr off". The bug which it worked around was fixed
870 on 25 Feb 94 in coffread.c, so I'm nuking the command.
872 * stabs.texinfo (Alternate Entry Points): New node, rewritten from
875 * stabs.texinfo (Type Descriptors): Add 'Y' type descriptor.
879 * gdbint.texinfo (Host Conditionals, Target Conditionals): Remove
880 references to ieee-float.c.
884 * gdb.texinfo (Set Breaks): Update documentation for tbreak to
885 match what the code actually does.
889 * stabs.texinfo (Symbol Descriptors): Add OS9000 symbol descriptor s.
893 * stabs.texinfo (Type Descriptors): Add OS9000 type descriptors c,
898 * stabs.texinfo: Document N_RBRAC as function relative for COFF as
899 well as for ELF and SOM. Unify the descriptions of ELF and SOM
900 as "stabs in sections" rather than just saying "ELF and SOM".
901 Also make that stuff apply to COFF.
905 * gdb.texinfo (Formatting Documentation): Change GhostScript to
910 * gdb.texinfo (Continuing and Stepping): When talking about "step"
911 versus functions without line numbers, also mention stepping into
912 them as well as "step" when you are in them. Tell the user how to
913 deal with the situation. Add comment about "debugging information".
917 * stabs.texinfo (Enumerations): Document restriction on where
918 enumeration types can appear and still win with GDB.
922 * stabs.texinfo (Negative Type Numbers): Document format for type
927 * gdb.texinfo (Selection, Frame Info): Update information about
928 arbitrary frame specficiations.
932 * gdb.texinfo, remote.texi: general editing pass prior to Net release
936 * stabs.texinfo (String Field): Discuss continuing stabs with ?.
940 * stabs.texinfo (Non-Stab Symbol Types): Mention N_SET* | N_EXT.
944 * stabs.texinfo: Re-do stuff about C_BSTAT and move from XCOFF
945 Differences node to Statics node.
946 (Statics): Discuss XCOFF use of V symbol descriptor.
948 * Makefile.in: Remove refcard.dvi and GDBvn.texi in realclean,
953 * gdb.texinfo (Print Settings): Document `set print
954 fast-symbolic-addr' and improve the doc for some other
959 * stabs.texinfo (String Field): Talk about defining several type
961 Fix lint regarding changing node ELF Transformations to
962 ELF and SOM Transformations.
966 * stabs.texinfo: Insert Peter Kessler's name as inventor (I think).
970 * stabs.texinfo (Cross-References): `::' is for nested types only
972 (Structures): Document static members.
976 * stabs.texinfo: Document S type attribute.
980 * stabs.texinfo: Add notes about stabs-in-som where appropriate.
984 * gdbint.texinfo: Fix a few typos.
988 * gdb.texinfo, remote.texi: formatting improvements
990 * gdb.texinfo (New Features): mention threads.
991 (Summary, C): fix xrefs in newly contributed text.
992 (Threads): index entries, clarifications, example
993 (passim): minor typos fixed, phrasing improvements
995 * remote.texi (Bootstrapping): rephrase text on ^C and add index
996 entries; (Server): explain use of gdbserver w/real-time systems,
997 add example of conflicting TCP port; (MIPS Remote) break up
998 running text into table, highlighting commands, and add example.
1002 * refcard.tex: avoid bad linebreaks even when REFEDITS=psrc.sed
1006 * stabs.texinfo (Nested Symbols): New node.
1007 (String Field, Symbol Descriptors, Cross-References): Refer to it.
1011 * stabs.texinfo (Stabs in ELF): Clarify how Bbss.bss work with respect
1012 to picking which Bbss.bss symbol to use, and (because there seems to
1013 be no good way of doing it) re-write some of the text to make it
1014 sound like Bbss.bss isn't such a great idea after all (as currently
1017 * gdb.texinfo (C): In addition to saying people have to use g++ for
1018 good results, say they have to use stabs. Specifically say cfront
1020 (Summary): Merge in information on Modula-2, Pascal, and Chill from
1021 the gdb README. Add xrefs to places where the support for the various
1022 languages is described in detail.
1026 * stabs.texinfo: Clean up stuff about visibility and virtual
1029 * stabs.texinfo (N_M2C): Cite Sun doc.
1033 * gdb.texinfo: updates re threads.
1034 * remote.texinfo: avoid index entries starting with digits.
1038 * stabs.texinfo (Enumerations): Talk about large, negative and
1039 octal values. Clean up cross reference to type attributes.
1040 (String Field): Say that GDB 4.11 supports size attribute.
1044 * remote.texi (VxWorks Remote): Clarify that rebuilding VxWorks kernel
1045 is a mandatory step. Make the stuff about that more concise.
1049 * stabs.texinfo (Class Names): New node.
1051 * gdb.texinfo (Command Files): Explain order of init file reading.
1053 * remote.texi (Bootstrapping): Talk about getting the serial driver
1054 to deal with ^C sent by gdb to stop the remote system.
1058 * libgdb.texinfo (I/O): incorporated better phrasing from rich.
1060 * libgdb.texinfo (Defining Commands): made the DOC arg
1061 to gdb_define_app_command a char * instead of char **
1062 per a suggestion from kingdon.
1064 * libgdb.texinfo: total rewrite from a different starting
1069 * stabs.texinfo (Local Variable Parameters): Re-write paragraph on
1070 floats passed as doubles (to improve clarity).
1074 * gdb.texinfo (Source Path): index entries for $cwd, $pdir
1076 * a4rc.sed: update to work with Andreas Vogel papersize params
1078 * refcard.tex: use Andreas Vogel simplifications of papersize
1079 params; remove useless version info; update copyright date.
1083 * gdb.texinfo (Symbols): Add class NAME to doc for ptype.
1087 * gdb.texinfo (Files): Say what address the load command loads it at.
1089 * stabs.texinfo (Common Blocks): Minor cleanups.
1091 * stabs.texinfo: Update ld stabs in elf relocation to reflect the fact
1092 that Sun has backed away from the linker kludge and thus the relevant
1093 issue is changes to the SunPRO tools, not the Solaris linker.
1095 * stabs.texinfo (Traditional Integer Types): Clean up description
1096 of octal bounds a little bit. Document extra leading zeroes.
1100 * gdb.texinfo (Signaling): Update for symbolic symbol names
1101 and add a section explaining the difference between the GDB
1102 signal command and the shell kill utility.
1106 * libgdb.texinfo: added `@' to braces that were unescaped.
1110 * libgdb.texinfo: new file. Spec for the gdb library.
1114 * stabs.texinfo (Include Files): Fix typo (start -> end).
1118 * gdb.texinfo, remote.texi: assorted small improvements, mostly
1119 from Melissa at FSF's editing pass.
1123 * gdb.texinfo: Remove stuff about ar and 14 character filenames.
1124 I believe this was fixed by the 13 Sep 89 change to print_frame_info.
1125 Also, modern versions of ar like BSD 4.4 or SVR4 don't have this bug.
1129 * remote.texi (Bootstrapping): Discuss 386 call gates.
1133 * stabs.texinfo (Based Variables): New node.
1137 * stabs.texinfo (Negative Type Numbers): Re-write discussions of
1138 names, sizes, and formats to suggest how not to lose.
1142 * stabs.texinfo (Methods): Fix typo.
1146 * gdb.texinfo: Fix a few typos.
1150 * gdb.texinfo: Clarify how well it works with Fortran.
1152 * stabs.texinfo (Stabs In ELF, Statics, ELF Transformations):
1153 More on relocating stabs in ELF files.
1157 * stabs.texinfo (Stabs In ELF): Talk about N_FUN value.
1161 * stabs.texinfo (Local Variable Parameters): Talk about nameless
1166 * gdb.texinfo: @up/@down -> @raisesections/@lowersections
1170 * stabs.texinfo: Make info author notice match the TeX author notice.
1174 * stabs.texinfo: Initial-caps all words in node names and
1175 non-trivial words in section names.
1179 * stabs.texinfo: Many minor cleanups.
1181 * stabs.texinfo: Remove @deffn except from Expanded Reference node.
1185 * stabs.texinfo: Remove full description of big example.
1186 It's not really helpful; just use pieces of it where appropriate.
1187 Add more Texinfo formatting directives (@samp, etc.).
1188 Use @deffn to define stab types.
1189 Eliminate some wordiness. Break up some nodes.
1190 Add an (alphabetized) index of symbol types.
1191 Use consistent capitalization style in node and section names.
1195 * gdb.texinfo: Change typo "Two two" to "The two".
1199 * stabs.texinfo (XCOFF-differences): Remove references to
1200 non-existent types N_DECL and N_RPSYM.
1202 * stabs.texinfo (String Field): Say that type attributes bug is
1203 fixed in GDB 4.10, since it is.
1205 * stabs.texinfo: Clean up djm cleanups, and more cleanups of my own.
1209 * stabs.texinfo: Formatting cleanups.
1213 * stabs.texinfo: When explaining the n_type of a stab, standardize
1214 how we do it ('#' as a comment indicator, "36 is N_FUN" as text,
1216 (Global Variables): Clean up.
1220 * stabs.texinfo (Stack Variables): Re-write.
1224 * stabs.texinfo (Stabs-in-elf): Talk about getting the start
1225 addresses of a source file. Also revise formatting.
1226 Change "object module" or "object file" to "source file".
1227 Various: Miscellaneous cleanups.
1231 * stabs.texinfo: Point to mangling info in gcc's gpcompare.texi.
1235 * gdbint.texinfo: Removed many nonsensical machine-collected
1236 host and target conditionals, described some of the remainder.
1240 * gdbint.texinfo (Getting Started): Use @itemize, not @table.
1242 * gdbint.texinfo (Top): Add name to @top line, and re-write the
1243 paragraph which follows.
1245 * gdbint.texinfo (Host): Use @code not @samp for Makefile
1246 variables. Looks better and avoids overful hbox.
1250 * stabs.texinfo (Procedures): Improve stuff on nested functions.
1254 * remote.texi: (MIPS Remote) clearer doc for set/show timeout,
1259 * gdbint.texinfo: Update statement about `some ancient Unix
1260 systems, like Ultrix 4.0' to Ultrix 4.2.
1262 Wed Jul 28 15:26:53 1993 Roland H. Pesch (pesch@el_bosque.cygnus.com)
1264 * h8-cfg.texi, all-cfg.texi: new flag GDBSERVER
1266 * Makefile.in: depend on remote.texi rather than gdbinv-s.texi
1268 * remote.texi: (Server) New node on gdbserver. (Remote Serial,
1269 ST2000 Remote, MIPS Remote): mention `host:port' syntax for TCP.
1271 * remote.texi: new name for former gdbinv-s.texi
1273 * gdb.texinfo: use remote.texi rather than gdbinv-s.texi
1277 * gdbinv-s.texi: Documented timeout and retransmit-timeout
1278 variables for MIPS remote debugging protocol.
1282 * stabs.texinfo (Negative Type Numbers): FORTRAN LOGICAL fix.
1286 * Makefile.in (refcard.dvi): Use srcdir where necessary.
1290 * gdb.texinfo: repair conditional bugs in text markup
1294 * gdb.texinfo, all-cfg.texi, h8-cfg.texi: introduce MOD2 switch
1295 to select Modula-2 material.
1299 * stabs.texinfo: Cleanups regarding statics.
1301 * gdbinv-s.texi (Bootstrapping): Document exceptionHandler.
1302 (Debug Session): Mention exceptionHandler. Add xref to Bootstrapping.
1306 * stabs.texinfo: N_MAIN is sometimes used for C.
1310 * gdbint.texinfo (Host, Target Conditionals): Remove TM_FILE_OVERRIDE.
1314 * gdbint.texinfo (Target Conditionals): Remove NO_TYPEDEFS,
1315 removed from the code by Kingdon.
1319 * gdb.texinfo (Break Commands): Remove stuff about flushing terminal
1320 input when evaluating breakpoint conditions; the bug has been fixed.
1322 * gdb.texinfo (Continuing and Stepping): Argument to "continue"
1323 sets the ignore count to N-1, not to N.
1327 * refcard.tex (\hoffset): correct longstanding error to match
1328 intended offset; avoids cutting off edge on some printers
1332 * stabs.texinfo (Parameters): Say that order of stabs is significant.
1336 * stabs.texinfo (Common Blocks): Say what Sun FORTRAN does.
1340 * Makefile.in: (REFEDITS) new var to control whether PS or CM
1341 fonts and whether US or A4 paper for GDB refcard; (refcard.dvi)
1342 collect sed edits if any, apply to refcard before formatting;
1343 (refcard.ps) stop implying PS fonts if PS output requested;
1344 (lrefcard.ps) delete extra target for variant PS fonts
1346 * refcard.tex: parametrize papersize dependent info, collect
1347 in easily replaced spot
1349 * a4rc.sed: new file, edits to refcard for A4 paper
1353 * stabs.texinfo (Negative Type Numbers): Type -16 is 4 bytes.
1357 * stabs.texinfo (Negative Type Numbers): Minor character cleanups.
1361 * stabs.texinfo: Express disapproval of 'D' symbol descriptor
1362 politely rather than rudely.
1366 * stabs.texinfo: Document common blocks.
1370 * stabs.texinfo: Add some basic info about stabs-in-elf.
1374 * stabs.texinfo (Top): Minor cleanup.
1376 Mon Jun 14 16:16:51 1993 david d `zoo' zuhn (zoo at rtl.cygnus.com)
1378 * Makefile.in (install-info): remove parentdir support
1382 * gdb.texinfo (Copying): delete this node and references to it;
1383 RMS says this manual need not carry GPL. (passim): Improvements
1384 from last round at FSF, largely due to Ian Taylor review, and
1385 minor formatting improvements.
1387 * gdbinv-s.texi (passim): Improvements from last round at FSF,
1388 largely due to Ian Taylor review. (Debug Session): minor edits to
1393 * Makefile.in (realclean): Remove info and dvi files too.
1397 * {all,h8}-config.texi: Rename to *-cfg.texi for 14 char filenames.
1398 * Makefile.in: Change accordingly. gdb-config.texi -> gdb-cfg.texi.
1399 * gdb.texinfo: Change accordingly.
1401 * stabs.texinfo: Clean up N_{L,R}BRAC. Discuss what addresses of
1402 N_{L,R}BRAC,N_SLINE are relative to.
1406 * Makefile.in (GDBvn.texi): Update atomically.
1410 * gdbinv-s.texi (Debug Session): Document exceptionHook.
1414 * gdb.texinfo (Print Settings): Move all stuff relating to symbolic
1415 addresses together. Also motivate the set print symbol-filename
1416 command and suggest other solutions.
1420 * gdb.texinfo (set print elements): Note that the number of
1421 elements is set to unlimited by "set print elements 0".
1425 * stabs.texinfo (Builtin Type Descriptors): Try to clarify what
1427 (Stab Types): Include Solaris stab types.
1428 (Procedures): Document Solaris extensions.
1432 * gdb.texinfo: Add `set print symbol-filename' doc.
1436 * stabs.texinfo (Arrays): Talk about type definition vs. type
1439 * stabs.texinfo (Builtin Type Descriptors): Talk about omitting
1440 the trailing semicolon.
1444 * stabs.texinfo (Line Numbers, Source Files): Re-write these two nodes
1445 and merge in other parts of the document addressing these subjects.
1446 gdbint.texinfo (XCOFF): Remove info which is now in stabs.texinfo.
1448 * stabs.texinfo (Subranges, Arrays): Try to explain about the semicolon
1449 at the end of a range type.
1451 * stabs.texinfo (Subranges): "A offset" and "T offset" are not
1456 * stabs.texinfo (Stabs Format): Misc fixes.
1460 * stabs.texinfo (Constants): Allow an `e' constant to be non-enum.
1461 (Traditional builtin types): Document convex convention for long long.
1462 (Negative builtin types): Discuss type names, and misc fixes.
1466 * stabs.texinfo (Builtin Type Descriptors): Document the floating
1467 point types used with @samp{R} type descriptor.
1468 (Symbol Descriptors): Describe how to handle conflict between
1469 different meanings of @samp{P} symbol descriptor.
1473 * stabs.texinfo: Remove node Quick Reference and put its children
1474 directly under the main menu.
1476 * stabs.texinfo: Many more changes to bring it into line with
1477 AIX documentation and reality. I think it now has all the
1478 information from the AIX documentation, except that I burned
1479 out when I got to variant records (Pascal and Modula-2) and
1480 all the COBOL types. Oh well, we can add them later when we're
1481 worrying more about those languages.
1483 * stabs.texinfo (Automatic variables): Talk about what it means
1484 to omit the symbol descriptor.
1488 * stabs.texinfo (Parameters): Add "(sometimes)" when describing
1489 gcc2 behavior with promoted args.
1493 * gdb.texinfo: include readline appendices in info version of manual
1497 * gdbinv-s.texi (Remote Serial): describe new ^C behavior in
1500 * gdb.texinfo (Machine Code): more index entries for disassemble
1504 * Clarify the intended use of the gdb-testers and gdb-patches
1505 mailing lists, and shrink gzip comment.
1509 * gdb.texinfo (Shell Commands): do not mention SHELL env var in
1510 DOSHOST configuration of manual.
1512 * gdb.texinfo (MIPS Stack): new node.
1514 * all-config.texi (MIPS) new switch.
1516 * gdbinv-s.texi (Nindy Options) Remove two instances of future
1517 tense; (MIPS Remote) new node.
1519 * gdb.texinfo (passim) rephrases to work around makeinfo @value
1520 bug; (Environment) less passive, other small cleanups in text about
1521 .cshrc/.bashrc; (Invoking GDB) new MIPS Remote menu entry;
1522 (Remote) new MIPS Remote menu entry.
1526 * stabs.texinfo: Many changes to include information from the
1529 * gdb.texinfo (Environment): Mention pitfall with .cshrc.
1533 * gdbint.texinfo (new node Debugging GDB, elsewhere):
1534 Move a bunch of information from ../README.
1535 (Getting Started): New node.
1539 * gdbinv-s.texi, gdb.texinfo: include Hitachi SH target
1541 * gdb.texinfo: advance manual revision dates to present
1543 * gdbinv-s.texi, gdb.texinfo, all-config.texi, h8-config.texi:
1544 stop using silly Roman numerals in @set variable names
1548 * stabs.texinfo (Parameters): Keep trying to get this right.
1552 * stabs.texinfo (Parameters): More on "local parameters".
1556 * stabs.texinfo (Parameters): Re-do "local parameters" section.
1560 * stabs.texinfo (Symbol descriptors): Re-do using @table and @xref.
1561 (Parameters): Rewrite.
1562 (xcoff-differences, Sun-differences): Minor changes.
1566 * stabs.texinfo: Minor cleanup.
1570 * gdbint.texinfo: Minor xcoff stuff.
1574 * gdbint.texinfo: Update for new config directory structure.
1575 Add info about internal type data structures.
1579 * Makefile.in (SFILES_INCLUDED): gdb-config.texi is no longer in
1581 (gdb-config.texi): Depend on file in $(srcdir).
1585 * stabs.texinfo: Fixes about N_SO.
1589 * gdb.texinfo: include list of nonstandard init file names
1591 * *-config.texi: new switch GENERIC for text that applies *only*
1592 to (usual) multiple-target version of manual
1594 * gdb.texinfo, gdbinv-s.texi: Update conditional markup to correct
1597 * gdb.texinfo: depend on latest fixed makeinfo, use conditionals
1598 in menus (rather than conditionally selected multiple alternative
1601 * Makefile.in: define and use DOC_CONFIG var to select
1602 configuration for GDB user manual.
1604 * gdb-config.texi: delete from repository, generate from Makefile.
1606 * all-config.texi: normal `generic' configuration file, formerly
1607 stored as gdb-config.texi
1609 Wed Mar 24 14:03:19 1993 david d `zoo' zuhn (zoo at poseidon.cygnus.com)
1611 * Makefile.in: add dvi target to build all .dvi files
1615 * gdb.texinfo, gdvinv-s.texinfo: formatting improvements.
1619 * gdbint.texinfo: Doc NO_MMALLOC and NO_MMALLOC_CHECK as
1621 * stabs.texinfo: More array fixes inspired by Jim's.
1625 * stabs.texinfo: Fixes re arrays and continuations.
1627 * gdbint.texinfo: Add XCOFF node.
1631 * gdb.texinfo: Add `set print max-symbolic-offset' doc.
1635 * stabs.texinfo: Fix for array types to mention lower bounds.
1639 * gdbint.texinfo: Update PTRACE_ARG3_TYPE doc, pull PT_*.
1643 * gdbint.texinfo: Remove SET_STACK_LIMIT_HUGE from target defines.
1647 * gdbint.texinfo: Fix thinko (NM_FILE => NAT_FILE). Found
1652 * gdbint.texinfo: Eliminate IBM6000_HOST, document IBM6000_TARGET.
1656 * gdb.texinfo, gdbinv-s.texi: misc updates
1660 * gdbint.texinfo: Brief documentation for longjmp support,
1661 from an email msg by Stu.
1665 * stabs.texinfo: Fix description of floating point "range"
1666 types (which really define basic types). Reported by Jim Meehan,
1669 * gdbint.texinfo: Remove COFF_NO_LONG_FILE_NAMES define, now gone.
1673 * gdbint.texinfo: Slightly expand section on supporting a new
1678 * Makefile.in (refcard.ps, lrefcard.ps): Remove psref.tex
1683 * gdb.texinfo, gdbinv-s.texi: miscellaneous stylistic cleanups
1687 * gdbinv-s.texi: z8000 simulator target name is just "sim"
1689 * gdbinv-s.texi: Mention that Z8000 simulator can simulate Z8001
1694 * gdbint.texinfo: Add sections on clean design and on how to send
1699 * gdbint.texinfo: Add how to declare the result of make_cleanup.
1703 * gdb.texinfo: Fix typo, reported by Karl Berry.
1707 * gdb.texinfo: Add opcodes dir to GDB distribution description.
1709 Sat Oct 10 18:04:58 1992 david d `zoo' zuhn (zoo at cirdan.cygnus.com)
1711 * gdbint.texinfo: fixed a stray email address (needs @@),
1712 added @table @code to node "Native Conditionals"
1716 * gdbint.texinfo: Describe coding style of GDB.
1720 * stabs.texinfo: Minor wording changes.
1724 * gdbint.texinfo: Improve release doc slightly.
1728 * gdbint.texinfo: Improve doc of GDB config macros.
1732 * stabs.texinfo: Remove Bothner's changes for C++ nested types.
1733 These will be reinserted when examined.
1737 * gdbint.texinfo: Make a start at documenting all the #if macros
1738 in GDB. At least list them all, and start separating them into
1739 host-specific and target-specific.
1743 * gdbinv-s.m4.in: refrain from using @cartouche for just a few
1744 examples (not consistent w others).
1745 gdb.texinfo: issue disclaimer paragraph on cmdline options only
1746 for generic vn of doc
1750 * Makefile.in: always create installation directories.
1754 * gdb.texinfo: in h8 config, do not describe searching commands.
1758 * gdb.texinfo, none.m4, h8.m4, gdbinv-s.m4.in: improve H8/300
1759 conditionals; introduce a few generic switches that may be
1760 useful for other cross-dev or dos-hosted configs.
1762 * gdb.texinfo: fix typo in "info reg" description
1766 * stabs.texinfo: Minor updates from running TeX over it.
1767 * Makefile.in (stabs.dvi, stabs.ps): Add.
1771 * stabs.texinfo: Stabs documentation, written by Julia Menapace.
1772 First pass at converting it to texinfo.
1776 * gdb.texinfo, refcard.tex: Document mult args on `info reg'.
1777 * Makefile.in (refcard.ps, lrefcard.ps): Add missing $(srdir).
1781 * gdbint.texinfo: Add section on partial symbol tables.
1783 Sat Jun 20 16:31:10 1992 John Gilmore (gnu at cygnus.com)
1785 * gdb.texinfo: document `set remotedebug' and `set
1786 rstack_high_address'.
1790 * gdb.texinfo: slight expansion of new text on reading info files
1791 * gdbinv-s.m4.in: correct and expand info on cross-debugging
1794 Tue May 12 12:22:47 1992 John Gilmore (gnu at cygnus.com)
1796 * gdb.texinfo: `info user' => `show user'. Noticed by David Taylor.
1798 Mon May 11 19:06:27 1992 John Gilmore (gnu at cygnus.com)
1800 * gdb.texinfo: Say how to read the `info' files.
1804 * Makefile.in: gm4 -> m4.
1806 Fri Apr 10 17:50:43 1992 John Gilmore (gnu at rtl.cygnus.com)
1808 * gdb.texinfo: Update for GDB-4.5. Move `Formatting
1809 Documentation' ahead of `Installing GDB' to match README.
1810 Update shared library doc, -readnow and -mapped, and directory
1811 structure (add glob and mmalloc). Update configure doc.
1815 * Makefile.in: remove $(srcdir) from gdb.info rule.
1819 * Makefile.in: commented out gdb-all.texinfo rule. This is
1824 * Makefile.in, configure.in: removed traces of namesubdir,
1825 -subdirs, $(subdir), $(unsubdir), some rcs triggers. Forced
1826 copyrights to '92, changed some from Cygnus to FSF.
1828 Fri Dec 13 09:47:31 1991 John Gilmore (gnu at cygnus.com)
1830 * gdb.texinfo: Improve how we ask for bug reports.
1832 Tue Dec 10 04:07:21 1991 K. Richard Pixley (rich at rtl.cygnus.com)
1834 * Makefile.in: infodir belongs in datadir.
1836 Fri Dec 6 23:57:34 1991 K. Richard Pixley (rich at rtl.cygnus.com)
1838 * Makefile.in: remove spaces following hyphens, bsd make can't
1839 cope. install using INSTALL_DATA. added clean-info. added
1840 standards.text support.
1842 Thu Dec 5 22:46:12 1991 K. Richard Pixley (rich at rtl.cygnus.com)
1844 * Makefile.in: idestdir and ddestdir go away. Added copyrights
1845 and shift gpl to v2. Added ChangeLog if it didn't exist. docdir
1846 and mandir now keyed off datadir by default.
1853 version-control: never