Bug#363139: gtk: Please move all gtk html documentation to
/usr/share/doc/...
Josselin Mouette
joss at debian.org
Wed Aug 9 17:26:40 UTC 2006
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
More information about the Pkg-gnome-maintainers
mailing list