On Sun, 22 Jul 2012 23:50:47 +0530 Faheem Mitha <fah...@faheem.info> wrote: [...]
I can't see any reason why this is not allowed. Regardless, what is the best thing to do in this situation? Register one version and not the other? Suppose that some package contained two completely different html documents. What would one do then?
See example below. [...]
################################################################## ccl.doc-base ################################################################## Document: ccl-manual Title: Debian CCL Manual Author: CCL Developers Abstract: The CCL manual, describing what how to install and use CCL Section: Programming/Common Lisp Format: HTML Index: /usr/share/doc/ccl/ccl-documentation.html Format: HTML Index: /usr/share/doc/ccl/manual/index.html
One can at least define two doc-base files with two distinct document IDs, arguably with some duplication.
Say:
################################################################## ccl.doc-base ################################################################## Document: ccl-manual Title: Debian CCL Manual [the rest of the metadata must be duplicated in both files] Format: HTML Index: /usr/share/doc/ccl/manual/index.html Files: /usr/share/doc/ccl/manual/*.html [other non-HTML formats can be left here] ################################################################## ccl-html-single.doc-base ################################################################## Document: ccl-manual-single-html Title: Debian CCL Manual (single HTML file) [the rest of the metadata must be duplicated in both files] Format: HTML Files: /usr/share/doc/ccl/ccl-documentation.html
> Index: /usr/share/doc/ccl/ccl-documentation.html Note than the last Index line in case of a single file documentation is completely redundant but has to be there, see https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=706927 Maybe the following syntax should be allowed for single-page HTML documents, and Index should only be allowed for multiple-page ones, fixing both problems: > Format: HTML > Files: /usr/share/doc/ccl/ccl-documentation.html As the above currently does not work anyway, using that syntax should not cause problems for unmodified existing files.
