Bugzilla Bug 134051

I get the following result when I have the doc flag set and try to emerge
net-libs/linc-1.0.3-r1 with dev-util/gtk-doc-1.5 installed. The result is very
similar for gnome-base/gnome-libs-1.4.2 (see bug #133825). gtk-doc-1.5 is
indeed marked as unstable and the problem goes away if I revert to
gtk-doc-1.4-r1 (or disabling the doc USE flag). I made a local ebuild for
gtk-doc-1.6 (as best I knew how) but the problem remained the same.

Openjade complains about conflicting definitions from different SGML files,
which indeed is the case, so my highly unqualified guess is that the problem
lies in the following (from the gtk-doc-1.5 changelog):

> 2005-07-26  Damon Chaplin  <damon@gnome.org>
> 
>    * gtk-doc.make: Pass DOC_MAIN_SGML_FILE as the main filename to
>    gtkdoc-mkdb. Avoids creating spurious foo.sgml files in an XML build.
>     Patch from Malcolm Tredinnick. (#311344)


Documentation related output for linc-1.0.3-r1:

Making all in docs
make[2]: Entering directory
`/var/tmp/portage/linc-1.0.3-r1/work/linc-1.0.3/docs'
*** Scanning header files ***
if grep -l '^..*$' ./linc.types > /dev/null ; then \
            CC="/bin/sh ../libtool --mode=compile i686-pc-linux-gnu-gcc"
LD="/bin/sh ../libtool --mode=link i686-pc-linux-gnu-gcc" CFLAGS="" LDFLAGS=""
gtkdoc-scanobj --module=linc --output-dir=. ; \
        else \
            cd . ; \
            for i in linc.args linc.hierarchy linc.signals ; do \
               test -f $i || touch $i ; \
            done \
        fi
cd . && \
          gtkdoc-scan --module=linc --source-dir=.. --ignore-headers="config.h
acconfig.h linc-private.h"
touch scan-build.stamp
*** Rebuilding template files ***
cd . && gtkdoc-mktmpl --module=linc
=============================================================================
WARNING: 23 unused declarations.
  These can be found in linc-unused.txt.
  They should be added to linc-sections.txt in the appropriate place.
=============================================================================
touch tmpl-build.stamp
*** Building SGML ***
cd . && \
        gtkdoc-mkdb --module=linc --source-dir=..
--main-sgml-file=linc-docs.sgml
54% symbol docs coverage (21 symbols documented, 0 symbols incomplete, 18 not
documented)
See linc-undocumented.txt for a list of missing docs.
The doc coverage percentage doesn't include intro sections.
touch sgml-build.stamp
*** Building HTML ***
test -d ./html || mkdir ./html
cd ./html && gtkdoc-mkhtml linc ../linc-docs.sgml
/usr/bin/openjade:../sgml/linc-connection.sgml:3:19:E: ID "TOP_OF_PAGE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:3:19: ID "TOP_OF_PAGE" first
defined here
/usr/bin/openjade:../sgml/linc-connection.sgml:14:20:E: ID "SYNOPSIS" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:14:20: ID "SYNOPSIS" first defined
here
/usr/bin/openjade:../sgml/linc-connection.sgml:15:11:E: ID "SYNOPSIS.TITLE"
already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:15:11: ID "SYNOPSIS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-connection.sgml:61:14:E: ID "DESC" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:44:14: ID "DESC" first defined
here
/usr/bin/openjade:../sgml/linc-connection.sgml:62:11:E: ID "DESC.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:45:11: ID "DESC.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-connection.sgml:68:14:E: ID "DETAILS" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:51:14: ID "DETAILS" first defined
here
/usr/bin/openjade:../sgml/linc-connection.sgml:69:11:E: ID "DETAILS.TITLE"
already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:52:11: ID "DETAILS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-server.sgml:3:19:E: ID "TOP_OF_PAGE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:3:19: ID "TOP_OF_PAGE" first
defined here
/usr/bin/openjade:../sgml/linc-server.sgml:14:20:E: ID "SYNOPSIS" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:14:20: ID "SYNOPSIS" first defined
here
/usr/bin/openjade:../sgml/linc-server.sgml:15:11:E: ID "SYNOPSIS.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:15:11: ID "SYNOPSIS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-server.sgml:38:14:E: ID "DESC" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:44:14: ID "DESC" first defined
here
/usr/bin/openjade:../sgml/linc-server.sgml:39:11:E: ID "DESC.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:45:11: ID "DESC.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-server.sgml:45:14:E: ID "DETAILS" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:51:14: ID "DETAILS" first defined
here
/usr/bin/openjade:../sgml/linc-server.sgml:46:11:E: ID "DETAILS.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:52:11: ID "DETAILS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-types.sgml:3:19:E: ID "TOP_OF_PAGE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:3:19: ID "TOP_OF_PAGE" first
defined here
/usr/bin/openjade:../sgml/linc-types.sgml:14:20:E: ID "SYNOPSIS" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:14:20: ID "SYNOPSIS" first defined
here
/usr/bin/openjade:../sgml/linc-types.sgml:15:11:E: ID "SYNOPSIS.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:15:11: ID "SYNOPSIS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-types.sgml:37:14:E: ID "DESC" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:44:14: ID "DESC" first defined
here
/usr/bin/openjade:../sgml/linc-types.sgml:38:11:E: ID "DESC.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:45:11: ID "DESC.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc-types.sgml:44:14:E: ID "DETAILS" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:51:14: ID "DETAILS" first defined
here
/usr/bin/openjade:../sgml/linc-types.sgml:45:11:E: ID "DETAILS.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:52:11: ID "DETAILS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc.sgml:3:19:E: ID "TOP_OF_PAGE" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:3:19: ID "TOP_OF_PAGE" first
defined here
/usr/bin/openjade:../sgml/linc.sgml:14:20:E: ID "SYNOPSIS" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:14:20: ID "SYNOPSIS" first defined
here
/usr/bin/openjade:../sgml/linc.sgml:15:11:E: ID "SYNOPSIS.TITLE" already
defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:15:11: ID "SYNOPSIS.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc.sgml:43:14:E: ID "DESC" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:44:14: ID "DESC" first defined
here
/usr/bin/openjade:../sgml/linc.sgml:44:11:E: ID "DESC.TITLE" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:45:11: ID "DESC.TITLE" first
defined here
/usr/bin/openjade:../sgml/linc.sgml:50:14:E: ID "DETAILS" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:51:14: ID "DETAILS" first defined
here
/usr/bin/openjade:../sgml/linc.sgml:51:11:E: ID "DETAILS.TITLE" already defined
/usr/bin/openjade:../sgml/linc-protocol.sgml:52:11: ID "DETAILS.TITLE" first
defined here
make[2]: *** [html-build.stamp] Error 1
make[2]: Leaving directory
`/var/tmp/portage/linc-1.0.3-r1/work/linc-1.0.3/docs'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/var/tmp/portage/linc-1.0.3-r1/work/linc-1.0.3'
make: *** [all-recursive-am] Error 2



>> emerge --info

Portage 2.1_rc1-r4 (default-linux/x86/2005.1, gcc-3.4.6, glibc-2.4-r3,
2.6.16-gentoo-r7 i686)
=================================================================
System uname: 2.6.16-gentoo-r7 i686 AMD Athlon(TM) XP 2500+
Gentoo Base System version 1.12.0_pre19
ccache version 2.4 [enabled]
dev-lang/python:     2.4.3-r1
dev-python/pycrypto: 2.0.1-r5
dev-util/ccache:     2.4-r1
dev-util/confcache:  [Not Present]
sys-apps/sandbox:    1.2.18.1
sys-devel/autoconf:  2.13, 2.59-r7
sys-devel/automake:  1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.6-r2
sys-devel/binutils:  2.16.1-r2
sys-devel/libtool:   1.5.22
virtual/os-headers:  2.6.11-r5
ACCEPT_KEYWORDS="x86 ~x86"
AUTOCLEAN="yes"
CBUILD="i686-pc-linux-gnu"
CFLAGS="-O2 -march=athlon-xp"
CHOST="i686-pc-linux-gnu"
CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3.5/env
/usr/kde/3.5/share/config /usr/kde/3.5/shutdown /usr/kde/3/share/config
/usr/lib/mozilla/defaults/pref /usr/share/X11/xkb /usr/share/config
/var/qmail/control"
CONFIG_PROTECT_MASK="/etc/eselect/compiler /etc/gconf /etc/revdep-rebuild
/etc/terminfo /etc/texmf/web2c /etc/env.d"
CXXFLAGS="-O2 -march=athlon-xp"
DISTDIR="/usr/portage/distfiles"
FEATURES="autoconfig ccache distlocks metadata-transfer sandbox sfperms strict"
GENTOO_MIRRORS="http://ds.thn.htu.se/linux/gentoo/"
MAKEOPTS="-j2"
PKGDIR="/usr/portage/packages"
PORTAGE_RSYNC_OPTS="--recursive --links --safe-links --perms --times --compress
--force --whole-file --delete --delete-after --stats --timeout=180
--exclude='/distfiles' --exclude='/local' --exclude='/packages'"
PORTAGE_TMPDIR="/var/tmp"
PORTDIR="/usr/portage"
PORTDIR_OVERLAY="/usr/local/portage"
SYNC="rsync://rsync.europe.gentoo.org/gentoo-portage"
USE="x86 3dnow 3dnowext X alsa apache2 apm asf avi bash-completion berkdb
bitmap-fonts cdparanoia cli crypt doc dri dvd dvdr eds emacs emboss encode
examples flac foomaticdb fortran gdbm gif gmp gnome gnutls gpm gstreamer gtk
gtk2 imlib ipv6 isdnlog jabber java jpeg kde libg++ libwww mad mikmod mmx
mmxext motif mozilla mp3 mpeg ncurses nls nptl nptlonly odbc ogg oggvorbis
opengl pam pcre pdflib perl png pppd python qt quicktime readline reflection
sdl server session spell spl sse ssl svg tcpd tetex truetype truetype-fonts
type1-fonts unicode userlocales vorbis win32codecs xml2 xmms xorg xv xvid zlib
elibc_glibc kernel_linux userland_GNU"
Unset:  ASFLAGS, CTARGET, EMERGE_DEFAULT_OPTS, INSTALL_MASK, LANG, LC_ALL,
LDFLAGS, LINGUAS, PORTAGE_RSYNC_EXTRA_OPTS

The problem remains with the official gtk-1.6 ebuild just released.

(In reply to comment #1)
> The problem remains with the official gtk-1.6 ebuild just released.
>

Of course I mean gtk-doc, not gtk.

I think this is the same as bug 133825.

*** This bug has been marked as a duplicate of 133825 ***