Bug#451665: Please include a doc-base registration file

Roberto C. Sánchez roberto at connexer.com
Sun Nov 18 03:23:16 UTC 2007


On Sun, Nov 18, 2007 at 02:38:12AM +0100, Josselin Mouette wrote:
> Hi,
> 
> Le samedi 17 novembre 2007 à 13:26 -0500, Roberto C. Sanchez a écrit :
> > This package ships HTML documentation:
> > /usr/share/doc/libgnomevfs2-common/html/index.html
> > /usr/share/doc/libgnomevfs2-common/html/*.html  It should be
> > registered with doc-base so that it is more easily found.  Regards,
> 
> All GTK+/GNOME development documentation is already indexed through
> gtk-doc and easily accessible through devhelp. Given that most people
> wanting to develop for this platform will have devhelp installed and
> that they are easily accessible online at library.gnome.org, that makes
> very few users gaining from indexing them in doc-base.
> 
> Maybe it would make sense for GLib and GTK+, but for Gnome-VFS ?
> 
The nice thing about doc-base is that I can then install dwww (or
something similar) and serve up the documentation to the entire
organization.  Personally, I don't think it is that big a deal as it is
just one file (debian/doc-base) and it is automatically handled by
dh_installdocs.  However, you as the maintainer are free to choose.

Regards,

-Roberto

-- 
Roberto C. Sánchez
http://people.connexer.com/~roberto
http://www.connexer.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/pkg-gnome-maintainers/attachments/20071117/2afea07f/attachment.pgp 


More information about the pkg-gnome-maintainers mailing list