This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Section numbers in the Library Reference have a trailing period
Type: behavior Stage:
Components: Documentation Versions:
process
Status: closed Resolution: works for me
Dependencies: Superseder:
Assigned To: georg.brandl Nosy List: eric.araujo, georg.brandl, rhettinger, terry.reedy
Priority: normal Keywords:

Created on 2011-03-06 06:47 by rhettinger, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Messages (5)
msg130147 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2011-03-06 06:47
The section headings all look like this:

         4.11. Other Built-in Types
         4.11.1. Modules
             ...

http://docs.python.org/dev/library/stdtypes.html#classes-and-class-instances

It looks like there is one dot to many
msg130155 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2011-03-06 10:00
This looks fine to me -- isn't it a mere stylistic issue?
msg130199 - (view) Author: Raymond Hettinger (rhettinger) * (Python committer) Date: 2011-03-06 23:19
> This looks fine to me -- isn't it a mere stylistic issue?

It must be.  I just checked several of the books on my shelf.  Most don't have the trailing period, but Knuth does.  I raised the issue because I thought it was an unintended.
msg131387 - (view) Author: Terry J. Reedy (terry.reedy) * (Python committer) Date: 2011-03-19 05:03
My haphazard sample gave 8 without, 5 with.

I suspect trailing dot is analogy with lists:
1. something.
2. something else.
2.1. detail of else
2.2. more detail

Books without generally have extra space instead of '.'.
msg131403 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2011-03-19 09:50
WFM then.
History
Date User Action Args
2022-04-11 14:57:14adminsetgithub: 55621
2011-03-19 09:50:44georg.brandlsetstatus: open -> closed

messages: + msg131403
resolution: works for me
nosy: georg.brandl, rhettinger, terry.reedy, eric.araujo
2011-03-19 05:03:37terry.reedysetnosy: + terry.reedy
messages: + msg131387
2011-03-11 21:38:36eric.araujosetnosy: + eric.araujo
2011-03-06 23:19:24rhettingersetnosy: georg.brandl, rhettinger
messages: + msg130199
2011-03-06 10:00:48georg.brandlsetnosy: georg.brandl, rhettinger
messages: + msg130155
2011-03-06 06:47:37rhettingercreate