Bug#363139: gtk: Please move all gtk html documentation to /usr/share/doc/...

[Josselin Mouette]

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        /\./\
: :' :           josselin.mouette at ens-lyon.org
`. `'                        joss at debian.org
  `-  Debian GNU/Linux -- The power of freedom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Ceci est une partie de message
	=?ISO-8859-1?Q?num=E9riquement?= =?ISO-8859-1?Q?_sign=E9e?=
Url : http://lists.alioth.debian.org/pipermail/pkg-gnome-maintainers/attachments/20060809/83d7090e/attachment.pgp