Bug#872868: debian-policy: section numbers missing

[Sean Whitton]

control: reassign -1 python3-sphinx
control: affects -1 debian-policy
control: tags -1 +upstream +fixed-upstream
control: forwarded -1 https://github.com/sphinx-doc/sphinx/issues/3998

Hello,

On Mon, Nov 06 2017, Matthew Woodcraft wrote:

> For what it's worth, I've submitted a Sphinx patch which implements
> section numbering in plain text:
>
> https://github.com/sphinx-doc/sphinx/pull/4218
>
> I haven't interacted with Sphinx upstream before so I don't know
> whether they're likely to respond quickly.

It's been merged!  Thank you for helping out with this!

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#872868: debian-policy: section numbers missing

[Matthew Woodcraft]

For what it's worth, I've submitted a Sphinx patch which implements section
numbering in plain text:

https://github.com/sphinx-doc/sphinx/pull/4218

I haven't interacted with Sphinx upstream before so I don't know whether
they're likely to respond quickly.

-M-

Bug#872868: debian-policy: section numbers missing

[Russ Allbery]

Sean Whitton  writes:

> The PDF, HTML, info and ePub output formats have section numbering.

> The plain text format doesn't yet, mainly because it's put together with
> a local hack -- Sphinx generates one plain text file for each chapter,
> but we want a single policy.txt.  We are waiting on better upstream
> support.

Well, it's not just that, but also that Sphinx in general doesn't add
section numbers to the text output.  But yes, it's unfortunately a
casualty of the reStructuredText conversion.

If we have to, we'll hack together something that will add section
numbers at some point, but I'm still hoping that Sphinx upstream will add
support for this.

-- 
Russ Allbery (r...@debian.org)   

Bug#872868: debian-policy: section numbers missing

[Sean Whitton]

control: retitle -1 Plain text output format lacks section numbering

Hello Adam,

On Tue, Aug 22 2017, Adam Borowski wrote:

> I'm afraid that the new upload of the policy doesn't include section numbers
> in the text -- neither in the TOC nor in the body.  As that's how we usually
> refer to parts of the Policy, that makes any such references impossible.

The PDF, HTML, info and ePub output formats have section numbering.

The plain text format doesn't yet, mainly because it's put together with
a local hack -- Sphinx generates one plain text file for each chapter,
but we want a single policy.txt.  We are waiting on better upstream
support.

In the meantime, you might consider using the info output format.

-- 
Sean Whitton


signature.asc
Description: PGP signature

Bug#872868: debian-policy: section numbers missing

[Adam Borowski]

Package: debian-policy
Version: 4.1.0.0
Severity: normal

Hi!
I'm afraid that the new upload of the policy doesn't include section numbers
in the text -- neither in the TOC nor in the body.  As that's how we usually
refer to parts of the Policy, that makes any such references impossible.


Meow!
-- System Information:
Debian Release: buster/sid
  APT prefers unstable-debug
  APT policy: (500, 'unstable-debug'), (500, 'unstable'), (500, 'testing'), 
(150, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: i386

Kernel: Linux 4.13.0-rc6-debug-ubsan-00198-gafd58c2be315 (SMP w/6 CPU cores)
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE=C.UTF-8 
(charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: sysvinit (via /sbin/init)

Versions of packages debian-policy depends on:
ii  libjs-sphinxdoc  1.5.6-2

debian-policy recommends no packages.

Versions of packages debian-policy suggests:
pn  doc-base  

-- no debconf information