Le mercredi 09 août 2006 à 17:49 +0200, Loïc Minier a écrit :
>  1) We do want to see all documentations relevant to a package below
>  /usr/share/doc/$package, but this can easily be achieved via symlinks
>  to the actual location of the documentation.

I think this is just a better because this is where all documentation is
put for Debian packages.

>  4) What if the documentation is relevant to multiple packages?  It's
>  easy to have multiple links to /usr/share/gtk-doc/html from the
>  /usr/share/doc/$package dirs.

And it's easy to have links to /usr/share/doc/$package
from /usr/share/gtk-doc/html.

>  5) This breaks expectations across distributions that you can find the
>  gtk-doc of foobar below /usr/share/gtk-doc/html/foobar unless we manage
>  symlinks there.

Of course we should manage symlinks there, and this is what's done for
packages which had their documentation moved.

>  Summing this up, I propose the following:
>  - continue shipping doc to /usr/share/gtk-doc/html as the default place
>    for all gtk-doc HTML documentations (imagine someone writes
>    gtk-doc-genindex)
>  - symlink from all relevant /usr/share/doc/$package dirs to these docs.

I think we should do it the other way round, with a symlink
in /usr/share/gtk-doc/html. Of course, the real solution is to integrate
this in dh_installdocs.
-- 
 .''`.           Josselin Mouette        /\./\
: :' :           [EMAIL PROTECTED]
`. `'                        [EMAIL PROTECTED]
  `-  Debian GNU/Linux -- The power of freedom

Attachment: signature.asc
Description: Ceci est une partie de message numériquement signée

Reply via email to