Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 197899 - x11-libs/gtk+-2.12.1 fails to generate docs with dev-util/gtk-doc-1.6-r1
Summary: x11-libs/gtk+-2.12.1 fails to generate docs with dev-util/gtk-doc-1.6-r1
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: x86 Linux
: High minor (vote)
Assignee: Gentoo Linux Gnome Desktop Team
URL:
Whiteboard:
Keywords:
: 210196 (view as bug list)
Depends on:
Blocks: gnome2.22-tracker
  Show dependency tree
 
Reported: 2007-11-02 20:19 UTC by Slava Gorbunov
Modified: 2008-04-28 21:44 UTC (History)
3 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Slava Gorbunov 2007-11-02 20:19:04 UTC
Upgrade of gtk-doc to gtk-doc-1.8-r2 solves the problem. Please add it to the dependencies of gtk+.

Reproducible: Always
Comment 1 Thomas Raschbacher gentoo-dev 2007-11-11 20:00:24 UTC
also happens with gtk-doc 1.7 here error output:

gtk-doc: Rebuilding template files
cd . && gtkdoc-mktmpl --module=gdk 
=============================================================================
WARNING: 2 unused declarations.
  These can be found in gdk-unused.txt.
  They should be added to gdk-sections.txt in the appropriate place.
=============================================================================
touch tmpl-build.stamp
gtk-doc: Building XML
cd . && \
        gtkdoc-mkdb --module=gdk --source-dir=../../../gdk --output-format=xml --expand-content-files="" --main-sgml-file=gdk-docs.sgml --sgml-mode --output-format=xml
WARNING: Documentation in template file for gdk_keymap_get_direction being overridden by inline comments
100% symbol docs coverage (854 symbols documented, 0 symbols incomplete, 1 not documented)
See gdk-undocumented.txt for a list of missing docs.
The doc coverage percentage doesn't include intro sections.
touch sgml-build.stamp
gtk-doc: Building HTML
rm -rf ./html 
mkdir ./html
cd ./html && gtkdoc-mkhtml gdk ../gdk-docs.sgml
../xml/threads.xml:444: parser error : Opening and ending tag mismatch: programlisting line 439 and para
</para>
       ^
../xml/threads.xml:474: parser error : Opening and ending tag mismatch: para line 465 and programlisting
</programlisting></informalexample></para>
                 ^
../xml/threads.xml:611: parser error : chunk is not well balanced

^
../gdk-docs.sgml:78: parser error : Failure to process entity gdk-Threads
    &gdk-Threads;
                 ^
../gdk-docs.sgml:78: parser error : Entity 'gdk-Threads' not defined
    &gdk-Threads;
                 ^
unable to parse ../gdk-docs.sgml
make[4]: *** [html-build.stamp] Error 6
make[4]: Leaving directory `/mnt/space/Portage/tmp/portage/x11-libs/gtk+-2.12.1-r1/work/gtk+-2.12.1/docs/reference/gdk'
make[3]: *** [all-recursive] Error 1
make[3]: Leaving directory `/mnt/space/Portage/tmp/portage/x11-libs/gtk+-2.12.1-r1/work/gtk+-2.12.1/docs/reference'
make[2]: *** [all-recursive] Error 1
make[2]: Leaving directory `/mnt/space/Portage/tmp/portage/x11-libs/gtk+-2.12.1-r1/work/gtk+-2.12.1/docs'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/mnt/space/Portage/tmp/portage/x11-libs/gtk+-2.12.1-r1/work/gtk+-2.12.1'
make: *** [all] Error 2
Comment 2 Jakub Moc (RETIRED) gentoo-dev 2008-02-15 02:34:17 UTC
*** Bug 210196 has been marked as a duplicate of this bug. ***
Comment 3 jens.poenninghaus 2008-02-15 07:57:53 UTC
Confirm: Upgrading gtk-doc solved the problem. Dependency should indeed be adjusted to reflect this.
Thanks!
Comment 4 Marcello Magaldi 2008-04-28 10:05:14 UTC
(In reply to comment #3)
> Confirm: Upgrading gtk-doc solved the problem. Dependency should indeed be
> adjusted to reflect this.
> Thanks!
> 

since upgrading to newer stable gtk-doc and gtk+ solve this issue is it time to mark this bug as resolved fixed ?

Comment 5 Slava Gorbunov 2008-04-28 10:51:06 UTC
(In reply to comment #4)
> since upgrading to newer stable gtk-doc and gtk+ solve this issue is it time to
> mark this bug as resolved fixed ?
I suppose no, because the dependency record should be updated. If you do 'emerge gtk+', and already have an older version of gtk-doc installed, it won't be upgraded automatically unless the requirement of the newer version is stated by DEPEND record in the ebuild. 
Comment 6 Marcello Magaldi 2008-04-28 13:28:46 UTC
(In reply to comment #5)
> (In reply to comment #4)
> > since upgrading to newer stable gtk-doc and gtk+ solve this issue is it time to
> > mark this bug as resolved fixed ?
> I suppose no, because the dependency record should be updated. If you do
> 'emerge gtk+', and already have an older version of gtk-doc installed, it won't
> be upgraded automatically unless the requirement of the newer version is stated
> by DEPEND record in the ebuild. 

You are right , I didn't think about it since I always do an emerge -uDN world  , but as you said gtk+ should depend on a more recent version of gtk-doc , only doing this will pull gtk-doc to a newer version with an "emerge world" .  

Comment 7 Gilles Dartiguelongue (RETIRED) gentoo-dev 2008-04-28 14:25:49 UTC
I just checked the svn and it appears upstream raised their dep as well so it's safe to do it in our ebuild as well. Will proceed tonight.
Comment 8 Gilles Dartiguelongue (RETIRED) gentoo-dev 2008-04-28 21:44:20 UTC
updated the dep. Thanks for reporting and sorry for taking so long to fix that simple issue.