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

Re: documentation types



Hendrik Sattler <ubq7@stud.uni-karlsruhe.de> writes:

> Am Freitag, 10. Februar 2006 12:36 schrieb Daniel Leidert:
>> Am Freitag, den 10.02.2006, 12:09 +0100 schrieb Hendrik Sattler:
>> > I about packaging a library that ships an API reference in docbook SGML
>> > and provides manual build targets for PDF, PS and HTML.
>> >
>> > Is there any preference on which type should be included in the -dev
>> > package?
>>
>> Why don't you move it into -doc packages, which is IMHO more common
>> practice? You could make a -doc-html, -doc-ps and -doc-pdf, which all
>> provide -doc and then let the -dev package recommend or suggest the -doc
>> package. So the user can choose the format he prefers.
>
> For one file?
> Another alternative, maybe: include only the .sgml file and
> Suggests: docbook-utils

If would be nice if doc-base could handle registration of SGML/XML
documentation, and then generate the docs in the formats of your
choice.

Is the docbook toolchain is yet robust enough to be able to do that?


Regards,
Roger

-- 
Roger Leigh
                Printing on GNU/Linux?  http://gutenprint.sourceforge.net/
                Debian GNU/Linux        http://www.debian.org/
                GPG Public Key: 0x25BFB848.  Please sign and encrypt your mail.

Attachment: pgpLaHoD3q4C9.pgp
Description: PGP signature


Reply to: