OpenE2K
/
binutils-gdb
12
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

* 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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gdb/ChangeLog
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>
* config/djgpp/README: Explain how to unpack using djunpack.bat.

6
gdb/NEWS
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
interface is designed for debug environments running GDB as a separate
process. This is part of the long term libGDB project. See
gdb/mi/gdbmi.texinfo for further information. It can be enabled by
configuring with:
process. This is part of the long term libGDB project. See the
"GDB/MI" chapter of the GDB manual for further information. It can be
enabled by configuring with:
.../configure --enable-gdbmi

18
gdb/TODO
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])
http://sourceware.cygnus.com/ml/gdb-patches/2000-04/msg00000.html

14
gdb/doc/ChangeLog
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>
* gdb.texinfo (Files): Update description of add-symbol-file

26
gdb/doc/Makefile.in
View File

@ -56,7 +56,11 @@ TEXI2ROFF=texi2roff
# Traditionally readline is in .. or .
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
# 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_DOC = $(SFILES_LOCAL) \
SFILES_DOC = $(SFILES_LOCAL) $(GDBMI_DIR)/gdbmi.texinfo \
$(READLINE_DIR)/rluser.texinfo $(READLINE_DIR)/inc-hist.texinfo
#### Host, target, and site specific Makefile fragments come in here.
@ -233,10 +237,10 @@ gdb.ps: gdb.dvi
$(DVIPS) -o $@ $?
# 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.
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
# 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 . || \
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.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' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
-e '/^@ifinfo/,/^@end ifinfo/d' \
@ -291,7 +301,7 @@ gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texinfo
>gdb.me
# 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' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/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
# '@noindent's removed due to texi2roff-2 mm bug; if yours is newer,
# 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' \
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/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_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
gdbgui.dvi : gdbgui.texinfo ${SFILES_DOC}

9
gdb/doc/gdb.texinfo
View File

@ -24,6 +24,9 @@
@c readline appendices use @vindex
@syncodeindex vr cp
@c gdbmi uses @findex
@syncodeindex fn cp
@c !!set GDB manual's edition---not the same as GDB version!
@set EDITION Eighth
@ -142,6 +145,7 @@ Copyright (C) 1988-2000 Free Software Foundation, Inc.
* Sequences:: Canned sequences of commands
* Emacs:: Using @value{GDBN} under @sc{gnu} Emacs
* Annotations:: @value{GDBN}'s annotation interface.
* GDB/MI:: @value{GDBN}'s Machine Interface.
* GDB Bugs:: Reporting bugs in @value{GDBN}
* 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
communicate with @value{GDBN} using it as a back end. For example,
@samp{--interpreter=mi} causes @value{GDBN} to use the @dfn{gdbmi
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!
interface} (@pxref{GDB/MI, , The @sc{gdb/mi} Interface}).
@item -write
@cindex @code{--write}
@ -12204,6 +12206,7 @@ each value is printed in its own window.
@end ignore
@include annotate.texi
@include gdbmi.texinfo
@node GDB Bugs
@chapter Reporting Bugs in @value{GDBN}

5
gdb/mi/ChangeLog-mi
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>
* mi-cmd-var.c (mi_cmd_var_create): Add special frame cookie "@"

4021
gdb/mi/gdbmi.texinfo
View File

File diff suppressed because it is too large Load Diff