Bug 64036 – gtk-doc-1.2 breaks compile of libgnomeprint-2.6.2

• Status: RESOLVED INVALID
• Product: Gentoo Linux

[Description Thomas Andersson 2004-09-14 12:25:24 UTC]

I get a error when I compile libgnomeprint-2.6.2 and have gtk-doc-1.2 emerged. If I downgrade to gtk-doc-1.1 it works.

Thus, workaround:
Downgrade gtk-doc-1.1
emerge libgnomeprint
emerge gtk-doc-1.2

Reproducible: Always
Steps to Reproduce:
1. echo "gtk-util/gtk-doc ~x86" >> /etc/portage/package.keywords
2. emerge =gtk-util/gtk-doc-1.2
3. USE="doc" emerge libgnomeprint

Actual Results:  
Compile error:
*** Rebuilding template files ***
cd . && gtkdoc-mktmpl --module=libgnomeprint
=============================================================================
WARNING: 297 unused declarations.
  These can be found in libgnomeprint-unused.txt.
  They should be added to libgnomeprint-sections.txt in the appropriate place.
=============================================================================
touch tmpl-build.stamp
*** Building XML ***
cd . && \
gtkdoc-mkdb --module=libgnomeprint --source-dir=../../libgnomeprint
--output-format=xml --sgml-mode
ERROR parsing comment block file : parameter expected -
 ../../libgnomeprint/gnome-print-paper.c:243
WARNING: Parameter description missing in source code comment block -
         Func: gnome_print_paper_free_list Param: papers.
57% symbol docs coverage (132 symbols documented, 101 not documented)
See libgnomeprint-undocumented.txt for a list of missing docs.
The doc coverage percentage doesn't include intro sections.
touch sgml-build.stamp
*** Building HTML ***
rm -rf ./html
mkdir ./html
cd ./html && gtkdoc-mkhtml libgnomeprint ../libgnomeprint-docs.sgml
/usr/bin/openjade:../libgnomeprint-docs.sgml:1:59:W: cannot generate system
identifier for public text "-//Davenport//DTD DocBook V3.0//EN"
/usr/bin/openjade:../libgnomeprint-docs.sgml:18:0:E: reference to entity "BOOK"
for which no system identifier could be generated
/usr/bin/openjade:../libgnomeprint-docs.sgml:1:0: entity was defined here
/usr/bin/openjade:../libgnomeprint-docs.sgml:18:0:E: DTD did not contain element
declaration for document type name
/usr/bin/openjade:../libgnomeprint-docs.sgml:19:9:E: there is no attribute "ID"
/usr/bin/openjade:../libgnomeprint-docs.sgml:19:16:E: element "BOOK" undefined
/usr/bin/openjade:../libgnomeprint-docs.sgml:20:11:E: element "BOOKINFO" undefined
/usr/bin/openjade:../libgnomeprint-docs.sgml:21:10:E: element "TITLE" undefined
/usr/bin/openjade:../libgnomeprint-docs.sgml:24:11:E: there is no attribute "ID"
/usr/bin/openjade:../libgnomeprint-docs.sgml:24:26:E: element "PART" undefined

<snip>

/usr/bin/openjade:I: maximum number of errors (200) reached; change with -E option

<snip>

make[3]: *** [html-build.stamp] Error 1
make[3]: Leaving directory `/var/tmp/portage/libgnomeprint-2.6.2/work/libgnomep\
rint-2.6.2/doc/reference'
make[2]: *** [all-recursive] Error 1
make[2]: Leaving directory `/var/tmp/portage/libgnomeprint-2.6.2/work/libgnomep\
rint-2.6.2/doc'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/var/tmp/portage/libgnomeprint-2.6.2/work/libgnomep\
rint-2.6.2'
make: *** [all] Error 2

!!! ERROR: gnome-base/libgnomeprint-2.6.2 failed.
!!! Function gnome2_src_compile, Line 38, Exitcode 2
!!! compile failure


Gentoo Base System version 1.4.16
Portage 2.0.50-r11 (default-x86-2004.2, gcc-3.3.4, glibc-2.3.3.20040420-r1, 2.4.20)
=================================================================
System uname: 2.4.20 i686 AMD Athlon(tm) Processor
distcc 2.13 i686-pc-linux-gnu (protocols 1 and 2) (default port 3632) [disabled]
Autoconf: sys-devel/autoconf-2.59-r4
Automake: sys-devel/automake-1.8.5-r1
ACCEPT_KEYWORDS="x86"
AUTOCLEAN="yes"
CFLAGS="-march=athlon-tbird -O3 -pipe -fomit-frame-pointer"
CHOST="i686-pc-linux-gnu"
COMPILER=""
CONFIG_PROTECT="/etc /usr/X11R6/lib/X11/xkb /usr/kde/2/share/config
/usr/kde/3.2/share/config /usr/kde/3/share/config /usr/lib/mozilla/defaults/pref
/usr/share/config /var/qmail/control"
CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d"
CXXFLAGS="-march=athlon-tbird -O3 -pipe -fomit-frame-pointer"
DISTDIR="/usr/portage/distfiles"
FEATURES="autoaddcvs ccache sandbox"
GENTOO_MIRRORS="http://ds.thn.htu.se/linux/gentoo http://mirror.pudas.net/gentoo
http://gentoo.oregonstate.edu http://www.ibiblio.org/pub/Linux/distributions/gentoo"
MAKEOPTS="-j2"
PKGDIR="/usr/portage/packages"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/root/ebuilds"
SYNC="rsync://rsync.europe.gentoo.org/gentoo-portage"
USE="3dnow X aalib alsa apm arts avi berkdb bitmap-fonts bonobo cdr crypt cups
dga doc docgpm dvd emacs encode esd evo foomaticdb gd gdbm gif gnome gpm
gstreamer gtk gtk2 guile imlib java jpeg kde libg++ libwww mad mikmod mmx motif
mozilla mpeg mule ncurses nls oggvorbis opengl oss pam pdflib perl png python qt
qtmt quicktime readline ruby samba sdl slang socks5 spell ssl svga tcltk tcpd
threads tiff truetype video_cards_radeon x86 xml xml2 xmms xprint xv zlib"

[Comment 1 Leonardo Boshell (RETIRED) 2004-09-15 02:56:45 UTC]

Please make sure you have Docbook 3.0's DTD installed in your system. In case it's missing, you can emerge it this way:

  emerge =docbook-sgml-dtd-3.0*

After that, try emerging libgnomeprint-2.6.2 again, and tell us what happens. Thanks.

[Comment 2 Thomas Andersson 2004-09-15 03:18:06 UTC]

Yep that worked. After I emerged app-text/docbook-sgml-dtd-3.0-r1 libgnomeprint emerges just fine with gtk-doc-1.2 installed.
Thanks.

[Comment 3 Leonardo Boshell (RETIRED) 2004-09-15 04:15:52 UTC]

Ok. Assigning this to myself to keep track of it. The fix is simple but I can't commit it right now as I'm migrating my dev box.

[Comment 4 Leonardo Boshell (RETIRED) 2004-09-17 08:57:34 UTC]

Mmm, funny, the dependency was already there, so portage should've emerged the DTD when you tried ``emerge libgnomeprint''. My guess is that you had a problem with your SGML catalogs, which is a different matter. Anyway, this particular bug has been a non-issue all along.