Python docs and enumeration of sections

[Kay Schluehr]

On 29 Nov., 09:47, Robert Kern <robert.k... at gmail.com> wrote:
> Kay Schluehr wrote:
> > Is there a reason why enumeration of sections and subsections has been
> > dropped after the switch to the Sphinx documentation tool?
>
> > It doesn't really make quoting library sections easier or do you know
> > what I mean when I refer to "How It Works"?
>
> If you hover the mouse over the area just to the right of a section title, you
> will see a paragraph mark which will be a link to the section.
> You can
> copy-and-paste that URL. The URL is more convenient answer than a section number.
>
>    http://docs.python.org/library/pdb.html#how-it-works

I disagree. This might be adequate for web communication like this
which is bound to HTML but nothing else. No one who uses e.g. the
python26.chm document or a derived PDF can easily find what we are
talking about.

I also wonder about convenience? Not a single RFC, public spec,
standards document or any other important reference omits chapter
enumerations.

Kay