X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fdoc%2FMakefile.in;h=2bb8a3051bb92f25f2721e20b5a00a7fdd3fd71d;hb=e664d728038abf414b6fb1a1c8cd3aacd0bb3b67;hp=f81e58363b965139912df2fe7b194a2acbe7fb6b;hpb=ed288bb597072176e84fc8279707a3f2f475779b;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/doc/Makefile.in b/gdb/doc/Makefile.in index f81e58363b..2bb8a3051b 100644 --- a/gdb/doc/Makefile.in +++ b/gdb/doc/Makefile.in @@ -1,21 +1,20 @@ -##Copyright (C) 1991, 1992, 1999 Free Software Foundation, Inc. +##Copyright (C) 1991-2019 Free Software Foundation, Inc. # Makefile for GDB documentation. # This file is part of GDB. # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License as published by -# the Free Software Foundation; either version 2 of the License, or +# the Free Software Foundation; either version 3 of the License, or # (at your option) any later version. -# +# # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU General Public License for more details. -# +# # You should have received a copy of the GNU General Public License -# along with this program; if not, write to the Free Software -# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +# along with this program. If not, see . srcdir = @srcdir@ VPATH = @srcdir@ @@ -23,14 +22,28 @@ VPATH = @srcdir@ prefix = @prefix@ infodir = @infodir@ -htmldir = $(prefix)/html +datarootdir = @datarootdir@ +docdir = @docdir@ +pdfdir = @pdfdir@ +htmldir = @htmldir@ +mandir = @mandir@ +man1dir = $(mandir)/man1 +man5dir = $(mandir)/man5 + +transform = @program_transform_name@ SHELL = @SHELL@ +LN_S = @LN_S@ + INSTALL = @INSTALL@ INSTALL_PROGRAM = @INSTALL_PROGRAM@ INSTALL_DATA = @INSTALL_DATA@ +SYSTEM_GDBINIT = @SYSTEM_GDBINIT@ + +mkinstalldirs = $(SHELL) $(srcdir)/../../mkinstalldirs + # main GDB source directory gdbdir = $(srcdir)/.. @@ -38,19 +51,46 @@ gdbdir = $(srcdir)/.. TEXIDIR=${gdbdir}/../texinfo # where to find makeinfo, preferably one designed for texinfo-2 -MAKEINFO=makeinfo +MAKEINFO = @MAKEINFO@ +MAKEINFOFLAGS = @MAKEINFOFLAGS@ +MAKEINFO_EXTRA_FLAGS = @MAKEINFO_EXTRA_FLAGS@ +MAKEINFO_CMD = $(MAKEINFO) $(MAKEINFOFLAGS) $(MAKEINFO_EXTRA_FLAGS) -MAKEHTML = texi2html -MAKEHTMLFLAGS = -glossary -menu -split_chapter +MAKEHTML = $(MAKEINFO_CMD) --html +MAKEHTMLFLAGS = # where to find texi2roff, ditto TEXI2ROFF=texi2roff +# where to find texi2dvi, ditto +TEXI2DVI=texi2dvi + +# Package to install the docs under +PACKAGE = @PACKAGE@ + +# Package version and bug-reporting URL. +PKGVERSION = @PKGVERSION@ +BUGURL_TEXI = @REPORT_BUGS_TEXI@ + # Where is the source dir for the READLINE library doc? # Traditionally readline is in .. or . READLINE_DIR = ${gdbdir}/../readline/doc +READLINE_TEXI_INCFLAG = @READLINE_TEXI_INCFLAG@ + +# The GDB/MI docs come from a sibling directory ../mi +GDBMI_DIR = ${gdbdir}/mi + +SET_TEXINPUTS = \ + TEXINPUTS=${TEXIDIR}:.:$(srcdir):$(READLINE_DIR):$(GDBMI_DIR):$$TEXINPUTS -SET_TEXINPUTS = TEXINPUTS=${TEXIDIR}:.:$(srcdir):$(READLINE_DIR):$$TEXINPUTS +# Files which should be generated via 'info' and installed by 'install-info' +INFO_DEPS = gdb.info stabs.info annotate.info + +# Files which should be generated via 'pdf' and installed by 'install-pdf' +PDFFILES = gdb.pdf stabs.pdf refcard.pdf annotate.pdf +# Files which should be generated via 'html' and installed by 'install-html' +HTMLFILES = gdb/index.html stabs/index.html annotate/index.html +HTMLFILES_INSTALL = gdb stabs annotate # There may be alternate predefined collections of switches to configure # the GDB manual. Normally this is not done in synch with the software @@ -75,43 +115,243 @@ REFEDITS = # Don Knuth's TeX formatter TEX = tex - -# auxiliary program for sorting Texinfo indices -TEXINDEX = texindex +PDFTEX = pdftex # Program to generate Postscript files from DVI files. DVIPS = dvips -# Main GDB manual's source files -SFILES_INCLUDED = gdb-cfg.texi $(srcdir)/remote.texi +# Main GDB manual +# Note that this unconditionally includes the readline texi files, +# even when --with-system-readline is used. This is harmless because +# these are only used as dependencies. +GDB_DOC_SOURCE_INCLUDES = \ + $(srcdir)/fdl.texi \ + $(srcdir)/gpl.texi \ + $(srcdir)/agentexpr.texi \ + $(READLINE_DIR)/rluser.texi \ + $(READLINE_DIR)/hsuser.texi +GDB_DOC_BUILD_INCLUDES = \ + gdb-cfg.texi \ + GDBvn.texi +GDB_DOC_FILES = \ + $(srcdir)/gdb.texinfo \ + $(srcdir)/guile.texi \ + $(srcdir)/python.texi \ + $(GDB_DOC_SOURCE_INCLUDES) \ + $(GDB_DOC_BUILD_INCLUDES) + +# Stabs manual: All files +STABS_DOC_SOURCE_INCLUDES = \ + $(srcdir)/fdl.texi +STABS_DOC_BUILD_INCLUDES = \ + gdb-cfg.texi \ + GDBvn.texi +STABS_DOC_FILES = \ + $(srcdir)/stabs.texinfo \ + $(STABS_DOC_SOURCE_INCLUDES) \ + $(STABS_DOC_BUILD_INCLUDES) + +# Annotate migration document +ANNOTATE_DOC_SOURCE_INCLUDES = \ + $(srcdir)/fdl.texi +ANNOTATE_DOC_BUILD_INCLUDES = \ + gdb-cfg.texi \ + GDBvn.texi +ANNOTATE_DOC_FILES = \ + $(srcdir)/annotate.texinfo \ + $(ANNOTATE_DOC_SOURCE_INCLUDES) \ + $(ANNOTATE_DOC_BUILD_INCLUDES) + +# Options to extract the man page from gdb.texinfo +MANCONF = -Dman + +TEXI2POD = perl $(srcdir)/../../etc/texi2pod.pl \ + $(MAKEINFOFLAGS) $(MAKEINFO_EXTRA_FLAGS) + +POD2MAN1 = pod2man --center="GNU Development Tools" \ + --release="gdb-`sed q version.subst`" --section=1 +POD2MAN5 = pod2man --center="GNU Development Tools" \ + --release="gdb-`sed q version.subst`" --section=5 + +# List of man pages generated from gdb.texi +MAN1S = gdb.1 gdbserver.1 gcore.1 gdb-add-index.1 +MAN5S = gdbinit.5 +MANS = $(MAN1S) $(MAN5S) + +HAVE_NATIVE_GCORE_TARGET = @HAVE_NATIVE_GCORE_TARGET@ -SFILES_LOCAL = $(srcdir)/gdb.texinfo GDBvn.texi $(SFILES_INCLUDED) +### -SFILES_DOC = $(SFILES_LOCAL) \ - $(READLINE_DIR)/rluser.texinfo $(READLINE_DIR)/inc-hist.texi +all: info + +info: $(INFO_DEPS) +dvi: gdb.dvi stabs.dvi refcard.dvi annotate.dvi +ps: gdb.ps stabs.ps refcard.ps annotate.ps +html: $(HTMLFILES) +pdf: $(PDFFILES) +man: $(MANS) + +DOXYGEN = doxygen +doxyedit = sed -e 's,@srcdir\@,$(srcdir),g' + +doxy: doxy/index.html \ + doxy/gdb-api/index.html \ + doxy/gdb-xref/index.html \ + doxy/gdbserver/index.html + +doxy/index.html: $(srcdir)/doxy-index.in + -mkdir -p doxy + cp $(srcdir)/doxy-index.in doxy/index.html + +doxy/gdb-api/index.html: Doxyfile-gdb-api Doxyfile-base + -mkdir -p doxy + $(DOXYGEN) Doxyfile-gdb-api + +doxy/gdb-xref/index.html: Doxyfile-gdb-xref Doxyfile-base + -mkdir -p doxy + $(DOXYGEN) Doxyfile-gdb-xref + +doxy/gdbserver/index.html: Doxyfile-gdbserver Doxyfile-base + -mkdir -p doxy + $(DOXYGEN) Doxyfile-gdbserver + +Doxyfile-base: $(srcdir)/Doxyfile-base.in + $(doxyedit) $(srcdir)/Doxyfile-base.in >Doxyfile-base + +Doxyfile-gdb-api: $(srcdir)/Doxyfile-gdb-api.in + $(doxyedit) $(srcdir)/Doxyfile-gdb-api.in >Doxyfile-gdb-api + +Doxyfile-gdb-xref: $(srcdir)/Doxyfile-gdb-xref.in + $(doxyedit) $(srcdir)/Doxyfile-gdb-xref.in >Doxyfile-gdb-xref + +Doxyfile-gdbserver: $(srcdir)/Doxyfile-gdbserver.in + $(doxyedit) $(srcdir)/Doxyfile-gdbserver.in >Doxyfile-gdbserver + +all-doc: info dvi ps # pdf +diststuff: info man + rm -f gdb-cfg.texi GDBvn.texi + +install-info: $(INFO_DEPS) + $(SHELL) $(srcdir)/../../mkinstalldirs $(DESTDIR)$(infodir) + @list='$(INFO_DEPS)'; \ + for file in $$list; do \ + if test -f $$file; then d=.; else d=$(srcdir); fi; \ + for ifile in `cd $$d && echo $$file $$file-[0-9] $$file-[0-9][0-9]`; do \ + if test -f $$d/$$ifile; then \ + echo " $(INSTALL_DATA) $$d/$$ifile $(DESTDIR)$(infodir)/$$ifile"; \ + $(INSTALL_DATA) $$d/$$ifile $(DESTDIR)$(infodir)/$$ifile; \ + else : ; fi; \ + done; \ + done + $(POST_INSTALL) + @if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \ + list='$(INFO_DEPS)'; \ + for file in $$list; do \ + echo " install-info --info-dir=$(DESTDIR)$(infodir) $(DESTDIR)$(infodir)/$$file";\ + install-info --info-dir=$(DESTDIR)$(infodir) $(DESTDIR)$(infodir)/$$file || :;\ + done; \ + else : ; fi + +uninstall-info: + $(PRE_UNINSTALL) + @if $(SHELL) -c 'install-info --version | sed 1q | fgrep -s -v -i debian' >/dev/null 2>&1; then \ + ii=yes; \ + else ii=; fi; \ + list='$(INFO_DEPS)'; \ + for file in $$list; do \ + test -z "$$ii" \ + || install-info --info-dir=$(DESTDIR)$(infodir) --remove $$file; \ + done + $(NORMAL_UNINSTALL) + list='$(INFO_DEPS)'; \ + for file in $$list; do \ + (cd $(DESTDIR)$(infodir) && rm -f $$file $$file-[0-9] $$file-[0-9][0-9]); \ + done -#### Host, target, and site specific Makefile fragments come in here. -### +html__strip_dir = `echo $$p | sed -e 's|^.*/||'`; + +install-html: $(HTMLFILES) + @$(NORMAL_INSTALL) + test -z "$(htmldir)" || $(mkinstalldirs) "$(DESTDIR)$(htmldir)" + @list='$(HTMLFILES_INSTALL)'; for p in $$list; do \ + if test -f "$$p" || test -d "$$p"; then d=""; else d="$(srcdir)/"; fi; \ + f=$(html__strip_dir) \ + if test -d "$$d$$p"; then \ + echo " $(mkinstalldirs) '$(DESTDIR)$(htmldir)/$$f'"; \ + $(mkinstalldirs) "$(DESTDIR)$(htmldir)/$$f" || exit 1; \ + echo " $(INSTALL_DATA) '$$d$$p'/* '$(DESTDIR)$(htmldir)/$$f'"; \ + $(INSTALL_DATA) "$$d$$p"/* "$(DESTDIR)$(htmldir)/$$f"; \ + else \ + echo " $(INSTALL_DATA) '$$d$$p' '$(DESTDIR)$(htmldir)/$$f'"; \ + $(INSTALL_DATA) "$$d$$p" "$(DESTDIR)$(htmldir)/$$f"; \ + fi; \ + done -all install: +pdf__strip_dir = `echo $$p | sed -e 's|^.*/||'`; -info: gdb.info gdbint.info stabs.info -dvi: gdb.dvi gdbint.dvi stabs.dvi refcard.dvi -ps: gdb.ps gdbint.ps stabs.ps refcard.ps -html: gdb_toc.html gdbint_toc.html stabs_toc.html -all-doc: info dvi ps +install-pdf: $(PDFFILES) + @$(NORMAL_INSTALL) + test -z "$(pdfdir)" || $(mkinstalldirs) "$(DESTDIR)$(pdfdir)" + @list='$(PDFFILES)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=$(pdf__strip_dir) \ + echo " $(INSTALL_DATA) '$$d$$p' '$(DESTDIR)$(pdfdir)/$$f'"; \ + $(INSTALL_DATA) "$$d$$p" "$(DESTDIR)$(pdfdir)/$$f"; \ + done -install-info: info - for i in *.info* ; do \ - $(INSTALL_DATA) $$i $(infodir)/$$i ; \ +install-man: install-man1 install-man5 + +install-man1: $(MAN1S) + test -z "$(man1dir)" || $(mkinstalldirs) "$(DESTDIR)$(man1dir)" + @list='$(MAN1S)'; for p in $$list; do \ + if test "x$(HAVE_NATIVE_GCORE_TARGET)$(HAVE_NATIVE_GCORE_HOST)" = x \ + -a "$$p" = gcore.1; then \ + continue; \ + fi; \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=`echo $$p | sed -e 's|^.*/||' -e '$(transform)'`; \ + echo " $(INSTALL_DATA) '$$d$$p' '$(DESTDIR)$(man1dir)/$$f'"; \ + $(INSTALL_DATA) "$$d$$p" "$(DESTDIR)$(man1dir)/$$f"; \ done -install-html: html - for i in *.html ; do \ - $(INSTALL_DATA) $$i $(htmldir)/$$i ; \ +install-man5: $(MAN5S) + test -z "$(man5dir)" || $(mkinstalldirs) "$(DESTDIR)$(man5dir)" + @list='$(MAN5S)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=`echo $$p | sed -e 's|^.*/||' -e '$(transform)'`; \ + echo " $(INSTALL_DATA) '$$d$$p' '$(DESTDIR)$(man5dir)/$$f'"; \ + $(INSTALL_DATA) "$$d$$p" "$(DESTDIR)$(man5dir)/$$f"; \ done -STAGESTUFF = *.info* gdb-all.texi GDBvn.texi *.ps *.dvi +uninstall-man: uninstall-man1 uninstall-man5 + +uninstall-man1: + @test -n "$(man1dir)" || exit 0; \ + files=`{ l2='$(MAN1S)'; for i in $$l2; do \ + if test "x$(HAVE_NATIVE_GCORE_TARGET)$(HAVE_NATIVE_GCORE_HOST)" = x \ + -a "$$i" = gcore.1; then \ + continue; \ + fi; \ + echo "$$i"; \ + done | \ + sed -n '/\.1[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } + +uninstall-man5: + @test -n "$(man5dir)" || exit 0; \ + files=`{ l2='$(MAN5S)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.5[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } + +STAGESTUFF = *.info* gdb-all.texi GDBvn.texi *.ps *.dvi *.pdf *.1 *.5 # Copy the object files from a particular stage into a subdirectory. stage1: force @@ -143,37 +383,14 @@ de-stage3: force -(cd stage3 ; mv -f * ..) -rmdir stage3 -# The "least clean" level of cleaning. Get rid of files which are -# automatically generated files that are just intermediate files, -# -mostlyclean: - rm -f gdb.mm gdb.ms gdb.me links2roff - rm -f *.aux *.cp* *.fn* *.ky* *.log *.pg* *.toc *.tp* *.vr* - rm -f sedref.dvi sedref.tex tmp.sed - -clean: mostlyclean - rm -f rluser.texinfo inc-hist.texi gdb-cfg.texi - -distclean: clean - rm -f Makefile config.status - -# GDBvn.texi, the dvi files, the info files, and the postscript files, -# are all part of the distribution, so it should not be removed by -# "clean" or "distclean". Use maintainer-clean to remove them. - -maintainer-clean realclean: distclean - rm -f GDBvn.texi *.info* *.dvi *.ps *.html - # GDB QUICK REFERENCE (dvi output) refcard.dvi : refcard.tex $(REFEDITS) - if [ -z "$(REFEDITS)" ]; then \ - cp $(srcdir)/refcard.tex sedref.tex ; \ - else \ - echo > tmp.sed ; \ - for f in "$(REFEDITS)" ; do \ - cat $(srcdir)/$$f >>tmp.sed ; done ; \ - sed -f tmp.sed $(srcdir)/refcard.tex >sedref.tex ; \ - fi + echo > tmp.sed + for f in x $(REFEDITS) ; do \ + test x$$f = xx && continue ; \ + cat $(srcdir)/$$f >>tmp.sed ; \ + done + sed -f tmp.sed $(srcdir)/refcard.tex >sedref.tex $(SET_TEXINPUTS) $(TEX) sedref.tex mv sedref.dvi refcard.dvi rm -f sedref.log sedref.tex tmp.sed @@ -181,11 +398,39 @@ refcard.dvi : refcard.tex $(REFEDITS) refcard.ps : refcard.dvi $(DVIPS) -t landscape -o $@ $? -# File to record current GDB version number (copied from main dir Makefile.in) -GDBvn.texi : ${gdbdir}/Makefile.in - echo "@set GDBVN `sed <$(srcdir)/../Makefile.in -n 's/^VERSION *= *//p'`" > ./GDBvn.new +refcard.pdf : refcard.tex $(REFEDITS) + echo > tmp.sed + for f in x $(REFEDITS) ; do \ + test x$$f = xx && continue ; \ + cat $(srcdir)/$$f >>tmp.sed ; \ + done + sed -f tmp.sed $(srcdir)/refcard.tex >sedref.tex + $(SET_TEXINPUTS) $(PDFTEX) sedref.tex + mv sedref.pdf refcard.pdf + rm -f sedref.log sedref.tex tmp.sed + +# File to record current GDB version number. +GDBvn.texi : version.subst + echo "@set GDBVN `sed q version.subst`" > ./GDBvn.new + if [ -n "$(PKGVERSION)" ]; then \ + echo "@set VERSION_PACKAGE $(PKGVERSION)" >> ./GDBvn.new; \ + fi + echo "@set BUGURL $(BUGURL_TEXI)" >> ./GDBvn.new + if [ "$(BUGURL_TEXI)" = "@uref{http://www.gnu.org/software/gdb/bugs/}" ]; then \ + echo "@set BUGURL_DEFAULT" >> ./GDBvn.new; \ + fi + if test -z "$(READLINE_TEXI_INCFLAG)"; then \ + echo "@set SYSTEM_READLINE" >> ./GDBvn.new; \ + fi + if [ -n "$(SYSTEM_GDBINIT)" ]; then \ + echo "@set SYSTEM_GDBINIT $(SYSTEM_GDBINIT)" >> ./GDBvn.new; \ + fi mv GDBvn.new GDBvn.texi +version.subst: $(gdbdir)/version.in $(gdbdir)/../bfd/version.h + date=`sed -n -e 's/^.* BFD_VERSION_DATE \(.*\)$$/\1/p' $(gdbdir)/../bfd/version.h`; \ + sed -e "s/DATE/$$date/" < $(gdbdir)/version.in > version.subst + # Updated atomically .PRECIOUS: GDBvn.texi @@ -194,7 +439,8 @@ GDBvn.texi : ${gdbdir}/Makefile.in # not one for their binary config---which may not be specifically # defined anyways). gdb-cfg.texi: ${srcdir}/${DOC_CONFIG}-cfg.texi - ln -s ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi || \ + (test "$(LN_S)" = "ln -s" && \ + ln -s ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi) || \ ln ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi || \ cp ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi @@ -207,27 +453,38 @@ gdb-cfg.texi: ${srcdir}/${DOC_CONFIG}-cfg.texi # VPATH will often tell make not to bother building it, because the one # in the srcdir is up to date. (if not, then make should build one here). +# Clean these up before each run. Avoids a catch 22 with not being +# able to re-generate these files (to fix a corruption) because these +# files contain a corruption. +GDB_TEX_TMPS = gdb.aux gdb.cp* gdb.fn* gdb.ky* gdb.log gdb.pg* gdb.toc \ + gdb.tp* gdb.vr* + # GDB MANUAL: TeX dvi file -gdb.dvi: ${SFILES_DOC} +gdb.dvi: ${GDB_DOC_FILES} if [ ! -f ./GDBvn.texi ]; then \ - ln -s $(srcdir)/GDBvn.texi . || \ + (test "$(LN_S)" = "ln -s" && ln -s $(srcdir)/GDBvn.texi .) || \ ln $(srcdir)/GDBvn.texi . || \ cp $(srcdir)/GDBvn.texi . ; else true; fi - $(SET_TEXINPUTS) $(TEX) gdb.texinfo - $(SET_TEXINPUTS) $(TEX) gdb.texinfo - $(TEXINDEX) gdb.?? - $(SET_TEXINPUTS) $(TEX) gdb.texinfo - rm -f gdb.aux gdb.cp* gdb.fn* gdb.ky* gdb.log gdb.pg* gdb.toc \ - gdb.tp* gdb.vr* + rm -f $(GDB_TEX_TMPS) + $(TEXI2DVI) $(READLINE_TEXI_INCFLAG) -I ${GDBMI_DIR} -I $(srcdir) \ + $(srcdir)/gdb.texinfo gdb.ps: gdb.dvi $(DVIPS) -o $@ $? +gdb.pdf: ${GDB_DOC_FILES} + if [ ! -f ./GDBvn.texi ]; then \ + (test "$(LN_S)" = "ln -s" && ln -s $(srcdir)/GDBvn.texi .) || \ + ln $(srcdir)/GDBvn.texi . || \ + cp $(srcdir)/GDBvn.texi . ; else true; fi + rm -f $(GDB_TEX_TMPS) + $(TEXI2DVI) --pdf $(READLINE_TEXI_INCFLAG) -I ${GDBMI_DIR} -I $(srcdir) \ + $(srcdir)/gdb.texinfo + # GDB MANUAL: info file -# We're using texinfo2, and 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 +gdb.info: ${GDB_DOC_FILES} + $(MAKEINFO_CMD) $(READLINE_TEXI_INCFLAG) -I ${GDBMI_DIR} -I $(srcdir) \ + -o gdb.info $(srcdir)/gdb.texinfo # GDB MANUAL: roff translations # Try to use a recent texi2roff. v2 was put on prep in jan91. @@ -243,30 +500,16 @@ gdb.info: ${SFILES_DOC} # texi2roff doesn't have a notion of include dirs, so we have to fake # it out for gdb manual's include files---but only if not configured # in main sourcedir. -links2roff: $(SFILES_INCLUDED) +links2roff: $(GDB_DOC_SOURCE_INCLUDES) if [ ! -f gdb.texinfo ]; then \ - ln -s $(SFILES_INCLUDED) . || \ - ln $(SFILES_INCLUDED) . || \ - cp $(SFILES_INCLUDED) . ; \ + (test "$(LN_S)" = "ln -s" && ln -s $(GDB_DOC_SOURCE_INCLUDES) .) || \ + ln $(GDB_DOC_SOURCE_INCLUDES) . || \ + cp $(GDB_DOC_SOURCE_INCLUDES) . ; \ fi touch links2roff -# "Readline" appendices. Get them also due to lack of includes, -# regardless of whether or not configuring in main sourcedir. -# @ftable removed due to bug in texi2roff-2; if your texi2roff -# is newer, try just ln or cp -rluser.texinfo: ${READLINE_DIR}/rluser.texinfo - sed -e 's/^@ftable/@table/g' \ - -e 's/^@end ftable/@end table/g' \ - ${READLINE_DIR}/rluser.texinfo > ./rluser.texinfo - -inc-hist.texi: ${READLINE_DIR}/inc-hist.texi - ln -s ${READLINE_DIR}/inc-hist.texi . || \ - ln ${READLINE_DIR}/inc-hist.texi . || \ - cp ${READLINE_DIR}/inc-hist.texi . - # gdb manual suitable for [gtn]roff -me -gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texi +gdb.me: $(GDB_DOC_FILES) links2roff sed -e '/\\input texinfo/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \ @@ -281,7 +524,7 @@ gdb.me: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texi >gdb.me # gdb manual suitable for [gtn]roff -ms -gdb.ms: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texi +gdb.ms: $(GDB_DOC_FILES) links2roff sed -e '/\\input texinfo/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \ @@ -298,7 +541,7 @@ gdb.ms: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texi # 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.texi +gdb.mm: $(GDB_DOC_FILES) links2roff sed -e '/\\input texinfo/d' \ -e '/@c TEXI2ROFF-KILL/,/@c END TEXI2ROFF-KILL/d' \ -e '/^@ifinfo/,/^@end ifinfo/d' \ @@ -315,51 +558,128 @@ gdb.mm: $(SFILES_LOCAL) links2roff rluser.texinfo inc-hist.texi # GDB MANUAL: HTML file -gdb_toc.html: ${SFILES_DOC} - $(MAKEHTML) $(MAKEHTMLFLAGS) -I ${READLINE_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo +gdb/index.html: ${GDB_DOC_FILES} + $(MAKEHTML) $(MAKEHTMLFLAGS) $(READLINE_TEXI_INCFLAG) -I ${GDBMI_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo +stabs.info: $(STABS_DOC_FILES) + $(MAKEINFO_CMD) -I $(srcdir) -o stabs.info $(srcdir)/stabs.texinfo -# GDB INTERNALS MANUAL: TeX dvi file -gdbint.dvi : gdbint.texinfo - $(SET_TEXINPUTS) $(TEX) gdbint.texinfo - $(TEXINDEX) gdbint.?? - $(SET_TEXINPUTS) $(TEX) gdbint.texinfo - rm -f gdbint.aux gdbint.cp* gdbint.fn* gdbint.ky* \ - gdbint.log gdbint.pg* gdbint.toc gdbint.tp* gdbint.vr* +# STABS DOCUMENTATION: HTML file + +stabs/index.html: $(STABS_DOC_FILES) + $(MAKEHTML) $(MAKEHTMLFLAGS) -I $(srcdir) $(srcdir)/stabs.texinfo + +# Clean these up before each run. Avoids a catch 22 with not being +# able to re-generate these files (to fix a corruption) because these +# files contain a corruption. +STABS_TEX_TMPS = stabs.aux stabs.cp* stabs.fn* stabs.ky* \ + stabs.log stabs.pg* stabs.toc stabs.tp* stabs.vr* + +# STABS DOCUMENTATION: TeX dvi file +stabs.dvi : $(STABS_DOC_FILES) + rm -f $(STABS_TEX_TMPS) + $(TEXI2DVI) -I $(srcdir) $(srcdir)/stabs.texinfo -gdbint.ps : gdbint.dvi +stabs.ps: stabs.dvi $(DVIPS) -o $@ $? -# GDB INTERNALS MANUAL: info file +stabs.pdf: $(STABS_DOC_FILES) + rm -f $(STABS_TEX_TMPS) + $(TEXI2DVI) --pdf -I $(srcdir) $(srcdir)/stabs.texinfo -gdbint.info: gdbint.texinfo - $(MAKEINFO) -o gdbint.info $(srcdir)/gdbint.texinfo +# Clean these up before each run. Avoids a catch 22 with not being +# able to re-generate these files (to fix a corruption) because these +# files contain a corruption. +ANNOTATE_TEX_TMPS = annotate.aux annotate.cp* annotate.fn* annotate.ky* \ + annotate.log annotate.pg* annotate.toc annotate.tp* annotate.vr* -# GDB INTERNALS MANUAL: HTML file +# ANNOTATE DOCUMENTATION: TeX dvi file +annotate.dvi : $(ANNOTATE_DOC_FILES) + rm -f $(ANNOTATE_TEX_TMPS) + $(TEXI2DVI) -I $(srcdir) $(srcdir)/annotate.texinfo -gdbint_toc.html: gdbint.texinfo - $(MAKEHTML) $(MAKEHTMLFLAGS) $(srcdir)/gdbint.texinfo +annotate.ps: annotate.dvi + $(DVIPS) -o $@ $? -stabs.info: stabs.texinfo - $(MAKEINFO) -o stabs.info $(srcdir)/stabs.texinfo +annotate.pdf: $(ANNOTATE_DOC_FILES) + rm -f $(ANNOTATE_TEX_TMPS) + $(TEXI2DVI) --pdf -I $(srcdir) $(srcdir)/annotate.texinfo + +annotate.info: $(ANNOTATE_DOC_FILES) + $(MAKEINFO_CMD) -I $(srcdir) -o annotate.info $(srcdir)/annotate.texinfo + +annotate/index.html: $(ANNOTATE_DOC_FILES) + $(MAKEHTML) $(MAKEHTMLFLAGS) -I $(srcdir) $(srcdir)/annotate.texinfo + +# Man pages +gdb.1: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgdb < $(srcdir)/gdb.texinfo > gdb.pod + -($(POD2MAN1) gdb.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gdb.pod + +gdbserver.1: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgdbserver < $(srcdir)/gdb.texinfo > gdbserver.pod + -($(POD2MAN1) gdbserver.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gdbserver.pod + +gcore.1: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgcore < $(srcdir)/gdb.texinfo > gcore.pod + -($(POD2MAN1) gcore.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gcore.pod + +gdb-add-index.1: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgdb-add-index < $(srcdir)/gdb.texinfo > gdb-add-index.pod + -($(POD2MAN1) gdb-add-index.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gdb-add-index.pod + +gdbinit.5: $(GDB_DOC_FILES) + touch $@ + -$(TEXI2POD) $(MANCONF) -Dgdbinit < $(srcdir)/gdb.texinfo > gdbinit.pod + -($(POD2MAN5) gdbinit.pod | sed -e '/^.if n .na/d' > $@.T$$$$ && \ + mv -f $@.T$$$$ $@) || (rm -f $@.T$$$$ && exit 1) + rm -f gdbinit.pod -# STABS DOCUMENTATION: HTML file +force: -stabs_toc.html: stabs.texinfo - $(MAKEHTML) $(MAKEHTMLFLAGS) $(srcdir)/stabs.texinfo +Makefile: Makefile.in $(host_makefile_frag) ../config.status + cd .. && $(SHELL) ./config.status doc/Makefile -# STABS DOCUMENTATION: TeX dvi file -stabs.dvi : stabs.texinfo - $(SET_TEXINPUTS) $(TEX) stabs.texinfo - $(TEXINDEX) stabs.?? - $(SET_TEXINPUTS) $(TEX) stabs.texinfo - rm -f stabs.aux stabs.cp* stabs.fn* stabs.ky* \ - stabs.log stabs.pg* stabs.toc stabs.tp* stabs.vr* -stabs.ps: stabs.dvi - $(DVIPS) -o $@ $? +# The "least clean" level of cleaning. Get rid of files which are +# automatically generated files that are just intermediate files, -force: +mostlyclean: + rm -f gdb.mm gdb.ms gdb.me links2roff + rm -f $(GDB_TEX_TMPS) + rm -f $(STABS_TEX_TMPS) + rm -f $(ANNOTATE_TEX_TMPS) + rm -f sedref.dvi sedref.tex tmp.sed + rm -f version.subst + +clean: mostlyclean + rm -f gdb-cfg.texi GDBvn.texi + +distclean: clean + rm -f Makefile + +# GDBvn.texi, the dvi files, the info files, and the postscript files, +# are all part of the distribution, so it should not be removed by +# "clean" or "distclean". Use maintainer-clean to remove them. + +maintainer-clean realclean: distclean + rm -f GDBvn.texi *.info* *.dvi *.ps *.html *.pdf $(MANS) + +install: install-info install-man + +uninstall: uninstall-info uninstall-man -Makefile: Makefile.in $(host_makefile_frag) $(target_makefile_frag) config.status - $(SHELL) ./config.status +# Disable implicit make rules. +include $(srcdir)/../disable-implicit-rules.mk