Bug#872893: debian-policy: Chapters, sections, appendices and numbering

[Guillem Jover <guillem@debian.org>]

Control: tag -1 - moreinfo

Hi!

On Tue, 2017-08-22 at 10:44:32 -0700, Sean Whitton wrote:
> On Tue, Aug 22 2017, Guillem Jover wrote:
> > At least on the PDF output, the section numbers are wrong, as there
> > are now two chapters that include the old sections.
> 
> Could you explain "two chapters that include the old sections", please?
> Or just say which sections are wrong.
> 
> We tried hard to avoid this, so it's definitely a bug.

Take section «10.9.1. The use of dpkg-statoverride», this is correct
on the HTML output and info file, on the PDF it's a section w/o a
number inside §2.10.9. I've not checked the EPUB file.

> > The appendices are also not easily distinguishable from the other
> > sections as they also use numbers intead of say letters.
> 
> This is a limitation of Sphinx.  We aren't going to fix it unless a new
> feature arrives from upstream.

Well, that's unfortunate. :( And I've just noticed on the info files
it's just worse as they do not get their section numbers reset so
they keep incrementing from the last chapter index. For example
«Binary packages (…)» used to be appendix B, now it's 2, but on the
info file it's 14.

Thanks,
Guillem