<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "http://bugs.gentoo.org/bugzilla.dtd">

<bugzilla version="2.22.7"
          urlbase="http://bugs.gentoo.org/"
          maintainer="bugzilla@gentoo.org"
>

    <bug>
          <bug_id>33843</bug_id>
          
          <creation_ts>2003-11-19 10:27 0000</creation_ts>
          <short_desc>gtk-doc &lt;-&gt; xhtml1 confusion</short_desc>
          <delta_ts>2005-06-21 02:55:49 0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>Gentoo Linux</product>
          <component>Ebuilds</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>Linux</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          
          <everconfirmed>1</everconfirmed>
          <reporter>carlo@gentoo.org</reporter>
          <assigned_to>gnome@gentoo.org</assigned_to>
          <cc>simons@cryp.to</cc>

      

      
          <long_desc isprivate="0">
            <who>carlo@gentoo.org</who>
            <bug_when>2003-11-19 10:27:35 0000</bug_when>
            <thetext>1. gtk-doc includes !app-text/xhtml1 as dependency, but xhtml1 doesn&apos;t block gtk-doc

2. as far as I can see, xhtml1 &amp; gtk-doc doesn&apos;t conflict with each other, so
why these blocking dependency?

Reproducible: Always
Steps to Reproduce:
1.
2.
3.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>obz@gentoo.org</who>
            <bug_when>2003-11-19 23:11:55 0000</bug_when>
            <thetext>1.) The blocks are mutual, portage sorts that out.

2.) Satai added these in, for good reason it seems, but I can&apos;t find the bugs/reports with the information. Here&apos;s the relevant comments from him.

ChangeLog:
09 Apr 2003; Matthew J. Turk &lt;satai@gentoo.org&gt; gtk-doc-1.0.ebuild, gtk-doc-0.9-r2.ebuild :
Updated to block xhtml1. Problems with that conflicting with anything generated by gtk-doc.

CVS comment:
Blocking xhtml1.  Fixes tons of problems.

Briefly mentioned in bug 17628
I&apos;ve looked even further, and someone has reported that xhtml1 breaks things. So it&apos;s now a blocked package by gtk-doc, which has all the problems. 

I suspect it&apos;s to do with the recurring SGML problems. Either way, this isn&apos;t a bug.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>carlo@gentoo.org</who>
            <bug_when>2003-11-20 01:21:48 0000</bug_when>
            <thetext>&gt;1. gtk-doc includes !app-text/xhtml1 as dependency, but xhtml1 doesn&apos;t block gtk-doc
No. xhtml1 dosn&apos;t block gtk-doc, so portage allows me to emerge xhtml1 after gtk-doc and shows me the blocking problem, when I do something like emerge -puD world and not when I emerge xhtml1. If xhtml1 breaks gtk-doc stuff, it should definitely have a !dev-util/gtk-doc dependency.

Another point is that I faced the gtk-doc problem mentioned in Bug 17628 a lot, without having xhtml1 installed at all. I don&apos;t think these bug is really fixed.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>obz@gentoo.org</who>
            <bug_when>2003-11-20 02:12:20 0000</bug_when>
            <thetext>Okay, yep you&apos;re right here. Adding the double block, no problem.

I only referenced that bug in passing in my effort to find out why there was the initial block, but now I&apos;ve found out why. xhtml1 causes all sorts of problems with gtk-doc and it really should be blocked.

Your two initial questions were
1.) why arent the blocks doubled ? (fixed now)
2.) why are they blocked in the first place. Check out a bug like 32542 for more information on that.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>sf-gentoo@stephan-feder.de</who>
            <bug_when>2003-12-02 05:06:18 0000</bug_when>
            <thetext>xhtml1 does not need to block gtk-doc because it &quot;works&quot; even if gtk-doc is installed. After all, xhtml1 is just a bunch of files. 

If the xhtml1 ebuild is broken, fix it. If the xhtml1 source is broken, please file a bug upstream (w3 consortium at www.w3.org).

Otherwise, fix gtk-doc if it is broken. Right now, my system and other people&apos;s likely as well are partly unusable, so please reopen this bug and adjust severity to major.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>simons@cryp.to</who>
            <bug_when>2005-01-22 10:32:34 0000</bug_when>
            <thetext>This bug is as an alias for #69728, which reports the same thing. IMHO this bug should be re-opened, the problem _does_ still exist.</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>leonardop@gentoo.org</who>
            <bug_when>2005-05-27 02:41:31 0000</bug_when>
            <thetext>*** Bug 69728 has been marked as a duplicate of this bug. ***</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>leonardop@gentoo.org</who>
            <bug_when>2005-05-27 02:49:52 0000</bug_when>
            <thetext>Okay, I&apos;m re-opening this bug since it seems like the reason why gtk-doc and
xhtml block each other was never clear, and apparently there is no valid reason
why those packages can&apos;t be installed together. If one of them is broken, we
should fix that instead of going around the problem with the block.

Obz,
Could you help us out with this? Can you remember why you mentioned xhtml should
really be blocked? I read the discussion at bug #32542 but it looks like in that
case the catalogs weren&apos;t being updated, and it&apos;s still unclear why xhtml was
being blamed.
</thetext>
          </long_desc>
          <long_desc isprivate="0">
            <who>leonardop@gentoo.org</who>
            <bug_when>2005-06-21 02:55:49 0000</bug_when>
            <thetext>I&apos;ve removed the mutual block between xhtml1 and gtk-doc. Some remarks:

a) The only problems I&apos;ve seen used as evidence to implement the block (bugs
#17628 and #32542) are actually unrelated to xhtml1.

b) xhtml1 had some issues of its own, which caused problems with openjade and
SGML documents, but they have been fixed by now.

c) In any case, if packages like xhtml1 bring more problems, creating blocks is
not a good solution. Those bugs should be treated individually and fixed in the
related packages.

Thank you all for your help on these issues.</thetext>
          </long_desc>
      
    </bug>

</bugzilla>