Re: [Python-Dev] [Python-checkins] peps: Restore whitespace characters lost via email transmission.
Hi,
changeset: 3903:728660b53208 user: pje date: Wed Jul 20 09:56:48 2011 -0400 summary: Restore whitespace characters lost via email transmission. [...] diff --git a/pep-0402.txt b/pep-0402.txt --- a/pep-0402.txt +++ b/pep-0402.txt @@ -38,13 +38,13 @@
.. epigraph::
- "Most packages are like modules. Their contents are highly [snip] + "Most packages are like modules. Their contents are highly
FYI, reST uses three-space indents, not four (so that blocks align nicely under the leading two dots + one space), so I think the change was intentional. The “Documenting Python” guide tells this (in the standard docs), and I think it applies to PEPs too. Regards
Éric Araujo <merwok@netwok.org> writes:
FYI, reST uses three-space indents, not four (so that blocks align nicely under the leading two dots + one space), so I think the change was intentional.
No, reST doesn't specify any particular level of indentation. Like most Python programmers I prefer four-space indentation, so I do the same in my reST documents:: .. epigraph:: “Foo bar baz” —Fnorble I strongly recommend the same for Python documentation. -- \ “I was in the first submarine. Instead of a periscope, they had | `\ a kaleidoscope. ‘We're surrounded.’” —Steven Wright | _o__) | Ben Finney
On Wed, Jul 20, 2011 at 20:31, Ben Finney <ben+python@benfinney.id.au>wrote:
Éric Araujo <merwok@netwok.org> writes:
FYI, reST uses three-space indents, not four (so that blocks align nicely under the leading two dots + one space), so I think the change was intentional.
No, reST doesn't specify any particular level of indentation. Like most Python programmers I prefer four-space indentation, so I do the same in my reST documents::
.. epigraph:: “Foo bar baz” —Fnorble
I strongly recommend the same for Python documentation.
We already use three and it seems to look and function properly. -1 to a mass re-spacing.
Le 21/07/2011 03:31, Ben Finney a écrit :
Éric Araujo <merwok@netwok.org> writes:
FYI, reST uses three-space indents, not four (so that blocks align nicely under the leading two dots + one space), so I think the change was intentional.
No, reST doesn't specify any particular level of indentation.
My phrasing was a shortcut for “the reST files in our documentation”, as was made clear by followups. Regards
participants (3)
-
Ben Finney -
Brian Curtin -
Éric Araujo