Bug#872893: debian-policy: Chapters, sections, appendices and numbering
Guillem Jover <guillem@debian.org> writes:
> At least on the PDF output, the section numbers are wrong, as there are
> now two chapters that include the old sections.
I think I've fixed this. For reference, the first problem was the
headings in the top-level document for the abstract and the license. When
I fixed that, Sphinx got a bit more confused, but adding the document
title with the highest-level heading (as documented in the Sphinx docs)
seems to have cleaned that up.
The license got appended to the end of the upgrading checklist if it was
just at the end of the top-level index, so I made it a separate appendix.
The alternative was to put it in front of the main text, and that seemed
awkward.
> The appendices are also not easily distinguishable from the other
> sections as they also use numbers intead of say letters.
This unfortunately really doesn't seem to be fixable in Sphinx right now,
which is frustrating. :( But it's more incentive to get rid of the
packaging manual appendices, which are basically long-standing technical
debt, and incorporate that material directly into Policy. That leaves the
process and the upgrading checklist, which I think could be just left as a
final section of the document.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: