* Makefile.in (GDBMI_DIR): New variable.

(SET_TEXINPUTS): Add $(GDBMI_DIR).
	(SFILES_DOC): Add $(GDBMI_DIR)/gdbmi.texinfo.
	(gdbmi.texinfo): New target, for texi2roff.
	(gdb.me, gdb.ms, gdb.mm): Depend on gdbmi.texinfo.
	(gdb.info, gdb_toc.html): Add "-I ${GDBMI_DIR}".

	* gdb.texinfo (Top): Add GDB/MI to the main menu and @include
	gdbmi.texinfo.
	(Mode Options): Add xref to GDB/MI docs and remove a FIXME
	comment.

	* gdbmi.texinfo: Lots of changes, to include this document as part
	of the GDB manual.

	* TODO, NEWS: Update due to inclusion of gdbmi.texinfo in the GDB
	manual.
This commit is contained in:
Eli Zaretskii 2000-04-23 08:15:49 +00:00
parent 878798ce46
commit 7162c0cabe
8 changed files with 2741 additions and 1363 deletions

View file

@ -1,3 +1,8 @@
2000-04-23 Eli Zaretskii <eliz@is.elta.co.il>
* TODO, NEWS: Update due to inclusion of gdbmi.texinfo in the GDB
manual.
2000-04-23 Eli Zaretskii <eliz@is.elta.co.il> 2000-04-23 Eli Zaretskii <eliz@is.elta.co.il>
* config/djgpp/README: Explain how to unpack using djunpack.bat. * config/djgpp/README: Explain how to unpack using djunpack.bat.

View file

@ -124,9 +124,9 @@ try to find a command that does what you are looking for.
A new machine oriented interface (MI) has been added to GDB. This A new machine oriented interface (MI) has been added to GDB. This
interface is designed for debug environments running GDB as a separate interface is designed for debug environments running GDB as a separate
process. This is part of the long term libGDB project. See process. This is part of the long term libGDB project. See the
gdb/mi/gdbmi.texinfo for further information. It can be enabled by "GDB/MI" chapter of the GDB manual for further information. It can be
configuring with: enabled by configuring with:
.../configure --enable-gdbmi .../configure --enable-gdbmi

View file

@ -140,24 +140,6 @@ Mark
-- --
MI documentation in GDB user guide. (Andrew Cagney, Elena Zannoni,
Stan Shebs, anyone else?)
> (Are there plans to make gdbmi.texi be part of the manual as well?)
I'd like to see it go in there sooner rather than later too. Otherwise
you're introducing discrepancies between the manual and the documentation,
and everybody is confused - witness the lack of doc for the tracing
commands still, some two years after they were added...
Discussion on MI can be found on the thread: [PATCH] GDB command-line
switches and annotations docs
http://sourceware.cygnus.com/ml/gdb-patches/2000-q1/msg00639.html
MI documentation can be found in the file gdb/mi/gdbmi.texinfo
--
Revised UDP support (was: Re: [Fwd: [patch] UDP transport support]) Revised UDP support (was: Re: [Fwd: [patch] UDP transport support])
http://sourceware.cygnus.com/ml/gdb-patches/2000-04/msg00000.html http://sourceware.cygnus.com/ml/gdb-patches/2000-04/msg00000.html

View file

@ -1,3 +1,17 @@
2000-04-23 Eli Zaretskii <eliz@is.elta.co.il>
* Makefile.in (GDBMI_DIR): New variable.
(SET_TEXINPUTS): Add $(GDBMI_DIR).
(SFILES_DOC): Add $(GDBMI_DIR)/gdbmi.texinfo.
(gdbmi.texinfo): New target, for texi2roff.
(gdb.me, gdb.ms, gdb.mm): Depend on gdbmi.texinfo.
(gdb.info, gdb_toc.html): Add "-I ${GDBMI_DIR}".
* gdb.texinfo (Top): Add GDB/MI to the main menu and @include
gdbmi.texinfo.
(Mode Options): Add xref to GDB/MI docs and remove a FIXME
comment.
2000-04-17 Elena Zannoni <ezannoni@kwikemart.cygnus.com> 2000-04-17 Elena Zannoni <ezannoni@kwikemart.cygnus.com>
* gdb.texinfo (Files): Update description of add-symbol-file * gdb.texinfo (Files): Update description of add-symbol-file

View file

@ -56,7 +56,11 @@ TEXI2ROFF=texi2roff
# Traditionally readline is in .. or . # Traditionally readline is in .. or .
READLINE_DIR = ${gdbdir}/../readline/doc READLINE_DIR = ${gdbdir}/../readline/doc
SET_TEXINPUTS = TEXINPUTS=${TEXIDIR}:.:$(srcdir):$(READLINE_DIR):$$TEXINPUTS # The GDB/MI docs come from a sibling directory ../mi
GDBMI_DIR = ${gdbdir}/mi
SET_TEXINPUTS = \
TEXINPUTS=${TEXIDIR}:.:$(srcdir):$(READLINE_DIR):$(GDBMI_DIR):$$TEXINPUTS
# There may be alternate predefined collections of switches to configure # There may be alternate predefined collections of switches to configure
# the GDB manual. Normally this is not done in synch with the software # the GDB manual. Normally this is not done in synch with the software
@ -93,7 +97,7 @@ SFILES_INCLUDED = gdb-cfg.texi $(srcdir)/annotate.texi
SFILES_LOCAL = $(srcdir)/gdb.texinfo GDBvn.texi $(SFILES_INCLUDED) SFILES_LOCAL = $(srcdir)/gdb.texinfo GDBvn.texi $(SFILES_INCLUDED)
SFILES_DOC = $(SFILES_LOCAL) \ SFILES_DOC = $(SFILES_LOCAL) $(GDBMI_DIR)/gdbmi.texinfo \
$(READLINE_DIR)/rluser.texinfo $(READLINE_DIR)/inc-hist.texinfo $(READLINE_DIR)/rluser.texinfo $(READLINE_DIR)/inc-hist.texinfo
#### Host, target, and site specific Makefile fragments come in here. #### Host, target, and site specific Makefile fragments come in here.
@ -233,10 +237,10 @@ gdb.ps: gdb.dvi
$(DVIPS) -o $@ $? $(DVIPS) -o $@ $?
# GDB MANUAL: info file # GDB MANUAL: info file
# We're using texinfo2, and older makeinfo's may not be able to # We're using texinfo 3.12; older makeinfo's may not be able to
# cope with all the markup. # cope with all the markup.
gdb.info: ${SFILES_DOC} gdb.info: ${SFILES_DOC}
$(MAKEINFO) -I ${READLINE_DIR} -I $(srcdir) -o ./gdb.info gdb.texinfo $(MAKEINFO) -I ${READLINE_DIR} -I ${GDBMI_DIR} -I $(srcdir) -o ./gdb.info gdb.texinfo
# GDB MANUAL: roff translations # GDB MANUAL: roff translations
# Try to use a recent texi2roff. v2 was put on prep in jan91. # Try to use a recent texi2roff. v2 was put on prep in jan91.
@ -275,8 +279,14 @@ inc-hist.texinfo: ${READLINE_DIR}/inc-hist.texinfo
ln ${READLINE_DIR}/inc-hist.texinfo . || \ ln ${READLINE_DIR}/inc-hist.texinfo . || \
cp ${READLINE_DIR}/inc-hist.texinfo . cp ${READLINE_DIR}/inc-hist.texinfo .
gdbmi.texinfo: ${GDBMI_DIR}/gdbmi.texinfo
(test "$$LN_S" = "ln -s" && \
ln -s ${GDBMI_DIR}/gdbmi.texinfo .) || \
ln ${GDBMI_DIR}/gdbmi.texinfo . || \
cp ${GDBMI_DIR}/gdbmi.texinfo .
# gdb manual suitable for [gtn]roff -me # gdb manual suitable for [gtn]roff -me
gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdbmi.texinfo
sed -e '/\\input texinfo/d' \ sed -e '/\\input texinfo/d' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
-e '/^@ifinfo/,/^@end ifinfo/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \
@ -291,7 +301,7 @@ gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo
>gdb.me >gdb.me
# gdb manual suitable for [gtn]roff -ms # gdb manual suitable for [gtn]roff -ms
gdb.ms: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdb.ms: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdbmi.texinfo
sed -e '/\\input texinfo/d' \ sed -e '/\\input texinfo/d' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
-e '/^@ifinfo/,/^@end ifinfo/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \
@ -308,7 +318,7 @@ gdb.ms: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo
# gdb manual suitable for [tn]roff -mm # gdb manual suitable for [tn]roff -mm
# '@noindent's removed due to texi2roff-2 mm bug; if yours is newer, # '@noindent's removed due to texi2roff-2 mm bug; if yours is newer,
# try leaving them in # try leaving them in
gdb.mm: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdb.mm: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo gdbmi.texinfo
sed -e '/\\input texinfo/d' \ sed -e '/\\input texinfo/d' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
-e '/^@ifinfo/,/^@end ifinfo/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \
@ -326,7 +336,7 @@ gdb.mm: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo
# GDB MANUAL: HTML file # GDB MANUAL: HTML file
gdb_toc.html: ${SFILES_DOC} gdb_toc.html: ${SFILES_DOC}
$(MAKEHTML) $(MAKEHTMLFLAGS) -I ${READLINE_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo $(MAKEHTML) $(MAKEHTMLFLAGS) -I ${READLINE_DIR} -I ${GDBMI_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo
# GDB GUI MANUAL: TeX dvi file # GDB GUI MANUAL: TeX dvi file
gdbgui.dvi : gdbgui.texinfo ${SFILES_DOC} gdbgui.dvi : gdbgui.texinfo ${SFILES_DOC}

View file

@ -24,6 +24,9 @@
@c readline appendices use @vindex @c readline appendices use @vindex
@syncodeindex vr cp @syncodeindex vr cp
@c gdbmi uses @findex
@syncodeindex fn cp
@c !!set GDB manual's edition---not the same as GDB version! @c !!set GDB manual's edition---not the same as GDB version!
@set EDITION Eighth @set EDITION Eighth
@ -142,6 +145,7 @@ Copyright (C) 1988-2000 Free Software Foundation, Inc.
* Sequences:: Canned sequences of commands * Sequences:: Canned sequences of commands
* Emacs:: Using @value{GDBN} under @sc{gnu} Emacs * Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
* Annotations:: @value{GDBN}'s annotation interface. * Annotations:: @value{GDBN}'s annotation interface.
* GDB/MI:: @value{GDBN}'s Machine Interface.
* GDB Bugs:: Reporting bugs in @value{GDBN} * GDB Bugs:: Reporting bugs in @value{GDBN}
* Formatting Documentation:: How to format and print @value{GDBN} documentation * Formatting Documentation:: How to format and print @value{GDBN} documentation
@ -1040,9 +1044,7 @@ Use the interpreter @var{interp} for interface with the controlling
program or device. This option is meant to be set by programs which program or device. This option is meant to be set by programs which
communicate with @value{GDBN} using it as a back end. For example, communicate with @value{GDBN} using it as a back end. For example,
@samp{--interpreter=mi} causes @value{GDBN} to use the @dfn{gdbmi @samp{--interpreter=mi} causes @value{GDBN} to use the @dfn{gdbmi
interface}. interface} (@pxref{GDB/MI, , The @sc{gdb/mi} Interface}).
@c FIXME: There should be an @xref here to the GDB/MI docs, but
@c gdbmi.texi doesn't have a single node to reference!
@item -write @item -write
@cindex @code{--write} @cindex @code{--write}
@ -12204,6 +12206,7 @@ each value is printed in its own window.
@end ignore @end ignore
@include annotate.texi @include annotate.texi
@include gdbmi.texinfo
@node GDB Bugs @node GDB Bugs
@chapter Reporting Bugs in @value{GDBN} @chapter Reporting Bugs in @value{GDBN}

View file

@ -1,3 +1,8 @@
2000-04-23 Eli Zaretskii <eliz@is.elta.co.il>
* gdbmi.texinfo: Lots of changes, to include this document as part
of the GDB manual.
2000-03-13 James Ingham <jingham@leda.cygnus.com> 2000-03-13 James Ingham <jingham@leda.cygnus.com>
* mi-cmd-var.c (mi_cmd_var_create): Add special frame cookie "@" * mi-cmd-var.c (mi_cmd_var_create): Add special frame cookie "@"

File diff suppressed because it is too large Load diff