I'm building a package (mozart) where documentation is provided by upstream as sgml (about 30 documents), from which a documentation set can be produced in html, ps or pdf. Since the binary is quite big (a .deb is about 3 MB) and since the documentation package in any of these formats (compressed) is about the same size I'm trying to build a multi-binary source package which creates the binary package, and one documentation package for each of the supported formats. So, this makes
mozart mozart-doc-html mozart-doc-ps mozart-doc-pdf My questions: - does it make sense to provide ps and pdf ? Should I drop one, if yes which one ? - I could also partionate the documentation "vertically" that is by subject of the documents into "tutorial", "reference", etc., and provide the respective documents in all formats. Do you agree that "horizontal" doc packages, providing all documents in one format at a time, is a more sensible? - Should I provide a doc package in sgml, and if yes, what should go into it and which tools could be used to access the doc in sgml (I'm quite ignorant on sgml) - A doc package, say mozart-doc-ps, should it put the documents in /usr/share/doc/mozart-doc-ps/ps, or into /usr/share/doc/mozart/doc ? Ralf.
