Re: gtk-doc files and a GNOME Policy

[Christian Marillat <marillat.christian@wanadoo.fr>]

Ross Burton <ross@burtonini.com> writes:

> Hi,

Hi,

[...]

> I'm pleased to see more and more GNOME libraries having their API
> documentation packaged, but in the case of linc its in a totally
> unexpected directory...

And these files should be installed in a -doc package. User don't need
to install a library package and header files to read documentation. Of
course a doc-base file should be provided.

[...]

> A suggested list of items to cover:
> * package naming (i.e nautilus or nautilus2)
> * package naming for Nautilus view, panel applets, etc
> * location of panel applet binaries
> * naming of themes and engines
> * location of docs, and that libraries should use gtk-doc if possible
> * use of scrollkeeper (replace external URL with path until fixed)

You can also add how to register a schemas file in the postinst, and how
to build a package who contains schemas files.

Christian