]> git.ipfire.org Git - thirdparty/binutils-gdb.git/commitdiff
gdb/doc: don't try to copy GDBvn.texi from the source tree
authorAndrew Burgess <aburgess@redhat.com>
Fri, 10 May 2024 13:41:03 +0000 (14:41 +0100)
committerAndrew Burgess <aburgess@redhat.com>
Mon, 24 Jun 2024 11:13:20 +0000 (12:13 +0100)
The build recipe for gdb.dvi and gdb.pdf contains instructions for
copying the GDBvn.texi file from the source tree into the build
directory if the GDBvn.texi file doesn't already exist in the build
directory.

The gdb.dvi and gdb.pdf targets also have a dependency on GDBvn.texi,
and we have a recipe for building GDBvn.texi.

What's happening here is this:

  - In a git checkout of the source tree there is no GDBvn.texi in the
    source tree, the GDBvn.texi dependency will trigger a rebuild of
    GDBvn.texi, which is then used to build gdb.dvi and/or gdb.pdf.

  - In a release tar file we do include a copy of GDBvn.texi.  This
    file will appear to be up to date, and so no copy of GDBvn.texi is
    created within the build directory.  Now when building gdb.dvi
    and/or gdb.pdf we copy (or symlink) the version of GDBvn.texi from
    the source tree into the build directory.

However, copying GDBvn.texi from the source directory is completely
unnecessary.  The gdb.dvi/gdb.pdf recipes both invoke texi2dvi and
pass '-I $(srcdir)' as an argument, this means that texi2dvi will look
in the $(srcdir) to find included files, including GDBvn.texi.

As such I believe we can remove the code that copies GDBvn.texi from
the source tree into the build tree.

I've tested with a release build; creating a release with:

  ./src-release gdb

Then in an empty directory, unpacking the resulting .tar file,
creating a parallel build directory and doing the usual configure,
make, and 'make install'.

Having done this I can then 'touch gdb/doc/*.texinfo' in the unpacked
source tree, and do 'make -C gdb/doc pdf dvi' to rebuild all the pdf
and dvi files, this works fine without having to either build or copy
GDBvn.texi into the build directory.

Approved-By: Tom Tromey <tom@tromey.com>
gdb/doc/Makefile.in

index d9c13873a60d42f847c7051036de8861dfe7c0bb..1a0791d518fa26e6c851a4772a9eafda2bd62bae 100644 (file)
@@ -477,15 +477,6 @@ gdb-cfg.texi: ${srcdir}/${DOC_CONFIG}-cfg.texi
        ln ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi || \
        cp ${srcdir}/${DOC_CONFIG}-cfg.texi gdb-cfg.texi
 
-# GDB MANUAL: texinfo source, using @set/@clear/@value/@ifset/@ifclear
-# If your texinfo or makeinfo don't support these, get a new texinfo release
-#
-# The nonsense with GDBvn.texi gets this to run with both Sun and GNU make.
-#   Note that we can *generate* GDBvn.texi, but since we distribute one in the
-#   source directory for the benefit of people who *don't* use this makefile,
-#   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.
@@ -494,10 +485,6 @@ GDB_TEX_TMPS = gdb.aux gdb.cp* gdb.fn* gdb.ky* gdb.log gdb.pg* gdb.toc \
 
 # GDB MANUAL: TeX dvi file
 gdb.dvi: ${GDB_DOC_FILES}
-       $(SILENCE) 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
        $(SILENCE) rm -f $(GDB_TEX_TMPS)
        $(ECHO_TEXI2DVI) $(TEXI2DVI) $(SILENT_Q_FLAG) $(READLINE_TEXI_INCFLAG) \
                -I ${GDBMI_DIR} -I $(srcdir) $(srcdir)/gdb.texinfo
@@ -506,10 +493,6 @@ gdb.ps: gdb.dvi
        $(ECHO_DVIPS) $(DVIPS) $(SILENT_Q_FLAG) -o $@ $?
 
 gdb.pdf: ${GDB_DOC_FILES}
-       $(SILENCE) 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
        $(SILENCE) rm -f $(GDB_TEX_TMPS)
        $(ECHO_TEXI2DVI) $(TEXI2DVI) $(SILENT_Q_FLAG) --pdf \
                $(READLINE_TEXI_INCFLAG) -I ${GDBMI_DIR} -I $(srcdir) \