[Gimp-print-devel] Questions about rebuilding the docs (5.2.11, 5.2.12-pre2)

[Ken M. <zar...@nt...>]

Hi, I don't usually bother trying to rebuild docs when a package
ships them, but in the distro I'm associated with (Beyond Linux From
Scratch, or BLFS [i.]) we sometimes offer a list of dependencies for
anybody who wishes to do that.  And for other reasons I'm looking at
packages which use ImageMagick.  Gutenprint apparently used for
rebuilding the docs at some point (I doubt anybody at our end has
actually tried that for some time).

This is less than important, but it applies to 5.2.12-pre2 as well as
to 5.11.  Sorry it's so wordy.

I can see that I need to use --enable-maintainer-mode to (re)build
the docs, and that configure checks for 'convert' and 'texi2html'
amongst other things.  And without texi2html it warns -

configure: WARNING: HTML documentation cannot be regenerated!

In 5.2.12-pre2 it seemed to regenerate doc/gutenprint/html using
doxygen when I hid texi2html (it's so old that I do not usually
install it).  That was NOT running 'make clean' (point 3 below).

Maybe I'm confused about how this fits together, or perhaps some
legacy dependencies have dropped out but are still referenced in
configure, but I'm puzzled by the following:

1. The Makefiles set CONVERT to /usr/bin/convert but do not seem to
use it.

2. Similarly, if I make texi2html available then TEXI2HTML is
defined in the Makefiles but not apparently used. After that, I
realised that the developer html had not been rebuilt.

3. At least when I enable maintainer mode, configure completes with:

Finished configuring.  Please review CAREFULLY the configuration summary above.
Type 'make clean' followed by 'make' to build the package
then 'make install' to install it.

But if I make clean, with both convert and texi2html present, the
build fails:

Making all in developer
make[3]: Entering directory
'/tmp/gutenprint-5.2.12-pre2/doc/developer'
if test . = '.' ; then \
  : ; \
else \
  for file in copying.xml dither.xml escp2.xml gutenprint.xml
gpl-appendix.xml introduction.xml new-printer.xml problems.xml
using.xml weave.xml ; do \
    if test -L $file ; then \
      rm -f $file ; \
    fi ; \
    ln -s -f ./$file $file ; \
  done ; \
fi
/usr/bin/db2html gutenprint.xml
Using catalogs: /usr/share/sgml/sgml-iso-entities-8879.1986/catalog,
/usr/share/sgml/docbook/sgml-dtd-3.1/catalog,
/usr/share/sgml/docbook/sgml-dtd-4.5/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/print/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/common/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/html/catalog,
/usr/share/sgml/docbook/dsssl-stylesheets-1.79/dtds/html/catalog,
/usr/share/sgml/openjade-1.3.2/catalog,
/usr/share/sgml/OpenSP-1.5.2/catalog,
/usr/share/sgml/xml-iso-entities-8879.1986/catalog
Using stylesheet:
/usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /tmp/gutenprint-5.2.12-pre2/doc/developer/gutenprint.xml
Done.
rm -rf reference-html
mv gutenprint reference-html
mv: cannot stat 'gutenprint': No such file or directory
make[3]: *** [Makefile:636: html-stamp] Error 1
make[3]: Leaving directory
'/tmp/gutenprint-5.2.12-pre2/doc/developer'
make[2]: *** [Makefile:472: all-recursive] Error 1
make[2]: Leaving directory '/tmp/gutenprint-5.2.12-pre2/doc'
make[1]: *** [Makefile:561: all-recursive] Error 1
make[1]: Leaving directory '/tmp/gutenprint-5.2.12-pre2'
make: *** [Makefile:491: all] Error 2

The programs were there:

lrwxrwxrwx 1 root root       6 Aug 12 00:12 /usr/bin/convert -> magick
-rwxr-xr-x 1 root root 1391831 Sep 29 03:15 /usr/bin/texi2html
-rwxr-xr-x 1 root root 13416 Aug 12 00:12 /usr/bin/magick

The only file with a name starting 'gutenprint' in the developer
directory after that is gutenprint.xml.

(i.) http://www.linuxfromscratch.org/blfs/view/svn/

ĸen
-- 
`I shall take my mountains', said Lu-Tze. `The climate will be good
for them.'     -- Small Gods