[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

question on doc



Hi,
I have a few questions regarding documentation.

With clustal omega, there is HTML documentation for the API ( for
libclustalo-dev).

Should I create a sub package for API documentation, as it is a little
big and keep it arch independant (and in this case, which section should
I set for the package) ?
Should I gzip the HTML files ? Debian policy suggests to do so, but in
case of HTML, it is not a single file but a bunch of files....
And, if gzipped, what should I put in xx.doc-base (it is not really HTML
anymore....)


At least, I have some errors with lintian on doc-base. Though I follow
tutorial at [1]:

E: libclustalo-dev: doc-base-file-unknown-field libclustalo-dev:6 format
E: libclustalo-dev: doc-base-file-unknown-field libclustalo-dev:7 index
E: libclustalo-dev: doc-base-file-unknown-field libclustalo-dev:8 files

For the file:
Document: libclustalo-dev
Title: Clustal Omega API
Author: Generated from Doxygen
Abstract: API for development with clustal omega
Section: Programming/C++
Format: HTML
Index: /usr/share/doc/libclustalo-dev/api/html/index.html
Files: /usr/share/doc/libclustalo-dev/api/html/*

[1] http://www.debian.org/doc/manuals/maint-guide/dother.en.html#doc-base

Thanks

Olivier

-- 

gpg key id: 4096R/326D8438  (pgp.mit.edu)
Key fingerprint = 5FB4 6F83 D3B9 5204 6335  D26D 78DC 68DB 326D 8438



Reply to: