mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-06-23 19:50:13 +08:00
Two kinds of changes:
(1) repair refs to readline includes to use new shorter filenames (2) provision for texi2roff conversion of doc via Makefile (new targets: gdb.mm, gdb.me, gdb.ms).
This commit is contained in:
@ -38,6 +38,9 @@ TEXIDIR=$(srcdir)/${gdbdir}/../texinfo/fsf
|
|||||||
# where to find makeinfo, preferably one designed for texinfo-2
|
# where to find makeinfo, preferably one designed for texinfo-2
|
||||||
MAKEINFO=makeinfo
|
MAKEINFO=makeinfo
|
||||||
|
|
||||||
|
# where to find texi2roff, ditto
|
||||||
|
TEXI2ROFF=texi2roff
|
||||||
|
|
||||||
# Where is the source dir for the READLINE library? Traditionally in .. or .
|
# Where is the source dir for the READLINE library? Traditionally in .. or .
|
||||||
# (For the binary library built from it, we use ${READLINE_DIR}${subdir}.)
|
# (For the binary library built from it, we use ${READLINE_DIR}${subdir}.)
|
||||||
READLINE_DIR = $(srcdir)/${gdbdir}/../readline
|
READLINE_DIR = $(srcdir)/${gdbdir}/../readline
|
||||||
@ -47,6 +50,9 @@ SFILES_DOCDIR = \
|
|||||||
$(srcdir)/gdb.texinfo $(srcdir)/pretex.m4 $(srcdir)/none.m4 \
|
$(srcdir)/gdb.texinfo $(srcdir)/pretex.m4 $(srcdir)/none.m4 \
|
||||||
$(srcdir)/all.m4 gdbinv-m.m4 gdbinv-s.m4 gdbVN.m4
|
$(srcdir)/all.m4 gdbinv-m.m4 gdbinv-s.m4 gdbVN.m4
|
||||||
|
|
||||||
|
# Which version of GDB manual? default includes everything
|
||||||
|
CONFIG=all
|
||||||
|
|
||||||
all install:
|
all install:
|
||||||
|
|
||||||
all-info: gdb.info gdbint.info
|
all-info: gdb.info gdbint.info
|
||||||
@ -79,11 +85,11 @@ refcard.ps : refcard.tex
|
|||||||
rm -f rcfonts.tex
|
rm -f rcfonts.tex
|
||||||
|
|
||||||
# Cover file for "Readline" appendices
|
# Cover file for "Readline" appendices
|
||||||
rdl-apps.texi: ${READLINE_DIR}/inc-readline.texinfo \
|
rdl-apps.texi: ${READLINE_DIR}/inc-read.texi \
|
||||||
${READLINE_DIR}/inc-history.texinfo
|
${READLINE_DIR}/inc-hist.texi
|
||||||
rm -f rdl-apps.texi
|
rm -f rdl-apps.texi
|
||||||
echo "@include ${READLINE_DIR}/inc-readline.texinfo" >rdl-apps.texi
|
echo "@include ${READLINE_DIR}/inc-read.texi" >rdl-apps.texi
|
||||||
echo "@include ${READLINE_DIR}/inc-history.texinfo" >>rdl-apps.texi
|
echo "@include ${READLINE_DIR}/inc-hist.texi" >>rdl-apps.texi
|
||||||
|
|
||||||
# File to record current GDB version number (copied from main dir Makefile.in)
|
# File to record current GDB version number (copied from main dir Makefile.in)
|
||||||
gdbVN.m4 : ${gdbdir}/Makefile.in
|
gdbVN.m4 : ${gdbdir}/Makefile.in
|
||||||
@ -91,6 +97,9 @@ gdbVN.m4 : ${gdbdir}/Makefile.in
|
|||||||
echo "_define__(<_GDB_VN__>,$$VER)" > gdbVN.m4 )
|
echo "_define__(<_GDB_VN__>,$$VER)" > gdbVN.m4 )
|
||||||
|
|
||||||
# GDB MANUAL: texinfo source, created by preprocessing w/m4
|
# GDB MANUAL: texinfo source, created by preprocessing w/m4
|
||||||
|
# If you want other configs in the makefile, add or modify instructions for
|
||||||
|
# building source here, then change CONFIG (that way you get info, dvi,
|
||||||
|
# roff targets automatically for your config).
|
||||||
# Be sure to not create a bad gdb-all.texi if ${M4} is missing or aborts...
|
# Be sure to not create a bad gdb-all.texi if ${M4} is missing or aborts...
|
||||||
gdb-all.texi: ${SFILES_DOCDIR}
|
gdb-all.texi: ${SFILES_DOCDIR}
|
||||||
rm -f foobus.texinfo
|
rm -f foobus.texinfo
|
||||||
@ -99,19 +108,79 @@ gdb-all.texi: ${SFILES_DOCDIR}
|
|||||||
mv foobus.texinfo gdb-all.texi
|
mv foobus.texinfo gdb-all.texi
|
||||||
|
|
||||||
# GDB MANUAL: TeX dvi file
|
# GDB MANUAL: TeX dvi file
|
||||||
gdb.dvi : gdb-all.texi rdl-apps.texi
|
gdb.dvi : gdb-${CONFIG}.texi rdl-apps.texi
|
||||||
TEXINPUTS=${TEXIDIR}:.:$$TEXINPUTS tex gdb-all.texi
|
TEXINPUTS=${TEXIDIR}:.:$$TEXINPUTS tex gdb-${CONFIG}.texi
|
||||||
texindex gdb-all.??
|
texindex gdb-${CONFIG}.??
|
||||||
TEXINPUTS=${TEXIDIR}:.:$$TEXINPUTS tex gdb-all.texi
|
TEXINPUTS=${TEXIDIR}:.:$$TEXINPUTS tex gdb-${CONFIG}.texi
|
||||||
mv gdb-all.dvi gdb.dvi
|
mv gdb-${CONFIG}.dvi gdb.dvi
|
||||||
rm -f gdb-all.?? gdb-all.???
|
rm -f gdb-${CONFIG}.?? gdb-${CONFIG}.???
|
||||||
|
|
||||||
# GDB MANUAL: info file
|
# GDB MANUAL: info file
|
||||||
# We're using texinfo2, and older makeinfo's may not be able to
|
# We're using texinfo2, and older makeinfo's may not be able to
|
||||||
# cope with all the markup. In the meantime, we distribute the info
|
# cope with all the markup. In the meantime, we distribute the info
|
||||||
# files
|
# files
|
||||||
gdb.info: gdb-all.texi
|
gdb.info: gdb-${CONFIG}.texi
|
||||||
$(MAKEINFO) -o gdb.info gdb-all.texi
|
$(MAKEINFO) -o gdb.info gdb-${CONFIG}.texi
|
||||||
|
|
||||||
|
# GDB MANUAL: roff translations
|
||||||
|
# Try to use a recent texi2roff. v2 was put on prep in jan91.
|
||||||
|
# If you want an index, see texi2roff doc for postprocessing
|
||||||
|
# and add -i to texi2roff invocations below.
|
||||||
|
# Workarounds for texi2roff-2 (probably fixed in later texi2roff's, delete
|
||||||
|
# correspondint -e lines when later texi2roff's are current)
|
||||||
|
# + @ifinfo's deleted explicitly due to texi2roff-2 bug w nested constructs.
|
||||||
|
# + @c's deleted explicitly because texi2roff sees texinfo commands in them
|
||||||
|
# + @ (that's at-BLANK) not recognized by texi2roff, turned into blank
|
||||||
|
# + @alphaenumerate is ridiculously new, turned into @enumerate
|
||||||
|
|
||||||
|
|
||||||
|
# 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: gdb-${CONFIG}.texi
|
||||||
|
sed -e '/\\input texinfo/d' \
|
||||||
|
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
|
||||||
|
-e '/^@ifinfo/,/^@end ifinfo/d' \
|
||||||
|
-e '/^@c/d' \
|
||||||
|
-e 's/{.*,,/{/' \
|
||||||
|
-e '/@noindent/d' \
|
||||||
|
-e 's/@ / /g' \
|
||||||
|
-e 's/^@alphaenumerate/@enumerate/g' \
|
||||||
|
-e 's/^@end alphaenumerate/@end enumerate/g' \
|
||||||
|
gdb-${CONFIG}.texi | \
|
||||||
|
$(TEXI2ROFF) -mm | \
|
||||||
|
sed -e 's/---/\\(em/g' \
|
||||||
|
>gdb.mm
|
||||||
|
|
||||||
|
# gdb manual suitable for [gtn]roff -me
|
||||||
|
gdb.me: gdb-${CONFIG}.texi
|
||||||
|
sed -e '/\\input texinfo/d' \
|
||||||
|
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
|
||||||
|
-e '/^@ifinfo/,/^@end ifinfo/d' \
|
||||||
|
-e '/^@c/d' \
|
||||||
|
-e 's/{.*,,/{/' \
|
||||||
|
-e 's/@ / /g' \
|
||||||
|
-e 's/^@alphaenumerate/@enumerate/g' \
|
||||||
|
-e 's/^@end alphaenumerate/@end enumerate/g' \
|
||||||
|
gdb-${CONFIG}.texi | \
|
||||||
|
$(TEXI2ROFF) -me | \
|
||||||
|
sed -e 's/---/\\(em/g' \
|
||||||
|
>gdb.me
|
||||||
|
|
||||||
|
# gdb manual suitable for [gtn]roff -ms
|
||||||
|
gdb.ms: gdb-${CONFIG}.texi
|
||||||
|
sed -e '/\\input texinfo/d' \
|
||||||
|
-e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \
|
||||||
|
-e '/^@ifinfo/,/^@end ifinfo/d' \
|
||||||
|
-e '/^@c/d' \
|
||||||
|
-e 's/{.*,,/{/' \
|
||||||
|
-e 's/@ / /g' \
|
||||||
|
-e 's/^@alphaenumerate/@enumerate/g' \
|
||||||
|
-e 's/^@end alphaenumerate/@end enumerate/g' \
|
||||||
|
gdb-${CONFIG}.texi | \
|
||||||
|
$(TEXI2ROFF) -ms | \
|
||||||
|
sed -e 's/---/\\(em/g' \
|
||||||
|
>gdb.ms
|
||||||
|
|
||||||
# GDB INTERNALS MANUAL: TeX dvi file
|
# GDB INTERNALS MANUAL: TeX dvi file
|
||||||
gdbint.dvi : gdbint.texinfo
|
gdbint.dvi : gdbint.texinfo
|
||||||
|
@ -85,16 +85,26 @@ _fi__(!_GENERIC__)
|
|||||||
@finalout
|
@finalout
|
||||||
@end iftex
|
@end iftex
|
||||||
@titlepage
|
@titlepage
|
||||||
@title{Using _GDBN__}
|
@title Using _GDBN__
|
||||||
@subtitle{A Guide to the GNU Source-Level Debugger}
|
@subtitle A Guide to the GNU Source-Level Debugger
|
||||||
_if__(!_GENERIC__)
|
_if__(!_GENERIC__)
|
||||||
@subtitle{On _HOST__ Systems}
|
@subtitle On _HOST__ Systems
|
||||||
_fi__(!_GENERIC__)
|
_fi__(!_GENERIC__)
|
||||||
@sp 1
|
@sp 1
|
||||||
@subtitle _GDBN__ version _GDB_VN__
|
@subtitle _GDBN__ version _GDB_VN__
|
||||||
@subtitle November 1991
|
@subtitle November 1991
|
||||||
@author{Richard M. Stallman@qquad @hfill Free Software Foundation}
|
@c TEXI2ROFF-KILL
|
||||||
@author{Roland H. Pesch@qquad @hfill Cygnus Support}
|
@c let's be nice to texi2roff, it can't be expected to know about hfill...
|
||||||
|
@author Richard M. Stallman@qquad @hfill Free Software Foundation
|
||||||
|
@author Roland H. Pesch@qquad @hfill Cygnus Support
|
||||||
|
@ignore
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
|
@c sneaky, eh?
|
||||||
|
@author Richard M. Stallman, Free Software Foundation
|
||||||
|
@author Roland H. Pesch, Cygnus Support
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
|
@end ignore
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
@page
|
@page
|
||||||
@tex
|
@tex
|
||||||
{\parskip=0pt
|
{\parskip=0pt
|
||||||
@ -7005,10 +7015,14 @@ command set as a whole more consistent and easier to use and remember:
|
|||||||
@kindex show history write
|
@kindex show history write
|
||||||
@kindex unset
|
@kindex unset
|
||||||
|
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
@ifinfo
|
@ifinfo
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
@example
|
@example
|
||||||
OLD COMMAND NEW COMMAND
|
OLD COMMAND NEW COMMAND
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
--------------- -------------------------------
|
--------------- -------------------------------
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
add-syms add-symbol-file
|
add-syms add-symbol-file
|
||||||
delete environment unset environment
|
delete environment unset environment
|
||||||
info convenience show convenience
|
info convenience show convenience
|
||||||
@ -7036,6 +7050,7 @@ set/show vtblprint set/show print vtbl
|
|||||||
|
|
||||||
unset [No longer an alias for delete]
|
unset [No longer an alias for delete]
|
||||||
@end example
|
@end example
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
@end ifinfo
|
@end ifinfo
|
||||||
|
|
||||||
@tex
|
@tex
|
||||||
@ -7070,6 +7085,7 @@ set{\rm / }show vtblprint &&set{\rm / }show print vtbl\cr
|
|||||||
unset &&\rm(No longer an alias for delete)\cr
|
unset &&\rm(No longer an alias for delete)\cr
|
||||||
}
|
}
|
||||||
@end tex
|
@end tex
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
|
|
||||||
@node Installing _GDBN__, Copying, Renamed Commands, Top
|
@node Installing _GDBN__, Copying, Renamed Commands, Top
|
||||||
@appendix Installing _GDBN__
|
@appendix Installing _GDBN__
|
||||||
@ -7248,11 +7264,15 @@ The following table shows all the architectures, hosts, and OS prefixes
|
|||||||
that @code{configure} recognizes in _GDBN__ _GDB_VN__. Entries in the ``OS
|
that @code{configure} recognizes in _GDBN__ _GDB_VN__. Entries in the ``OS
|
||||||
prefix'' column ending in a @samp{*} may be followed by a release number.
|
prefix'' column ending in a @samp{*} may be followed by a release number.
|
||||||
|
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
@ifinfo
|
@ifinfo
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
@example
|
@example
|
||||||
|
|
||||||
ARCHITECTURE VENDOR OS prefix
|
ARCHITECTURE VENDOR OS prefix
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
------------+--------------------------+---------------------------
|
------------+--------------------------+---------------------------
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
| |
|
| |
|
||||||
580 | altos hp | aix* msdos*
|
580 | altos hp | aix* msdos*
|
||||||
a29k | amd ibm | amigados newsos*
|
a29k | amd ibm | amigados newsos*
|
||||||
@ -7280,6 +7300,7 @@ ARCHITECTURE VENDOR OS prefix
|
|||||||
xmp | |
|
xmp | |
|
||||||
ymp | |
|
ymp | |
|
||||||
@end example
|
@end example
|
||||||
|
@c TEXI2ROFF-KILL
|
||||||
@end ifinfo
|
@end ifinfo
|
||||||
@tex
|
@tex
|
||||||
%\vskip\parskip
|
%\vskip\parskip
|
||||||
@ -7316,6 +7337,7 @@ ARCHITECTURE VENDOR OS prefix
|
|||||||
ymp && & && & \cr
|
ymp && & && & \cr
|
||||||
}\hfil}
|
}\hfil}
|
||||||
@end tex
|
@end tex
|
||||||
|
@c END TEXI2ROFF-KILL
|
||||||
@quotation
|
@quotation
|
||||||
@emph{Warning:} Many combinations of architecture, vendor, and OS are
|
@emph{Warning:} Many combinations of architecture, vendor, and OS are
|
||||||
untested.
|
untested.
|
||||||
|
@ -1,2 +1,2 @@
|
|||||||
@include ../../readline/inc-readline.texinfo
|
@include ./../../readline/inc-read.texi
|
||||||
@include ../../readline/inc-history.texinfo
|
@include ./../../readline/inc-hist.texi
|
||||||
|
Reference in New Issue
Block a user