[Python-checkins] r57029 - in doctools/trunk: Doc-26/documenting/style.rst Doc-3k/documenting/style.rst

[georg.brandl]

Author: georg.brandl
Date: Tue Aug 14 20:04:22 2007
New Revision: 57029

Modified:
   doctools/trunk/Doc-26/documenting/style.rst
   doctools/trunk/Doc-3k/documenting/style.rst
Log:
Add a paragraph about sentence ending spaces.


Modified: doctools/trunk/Doc-26/documenting/style.rst
==============================================================================
--- doctools/trunk/Doc-26/documenting/style.rst	(original)
+++ doctools/trunk/Doc-26/documenting/style.rst	Tue Aug 14 20:04:22 2007
@@ -17,6 +17,10 @@
 Make generous use of blank lines where applicable; they help grouping things
 together.
 
+A sentence-ending period may be followed by one or two spaces; while reST
+ignores the second space, it is customarily put in by some users, for example
+to aid Emacs' auto-fill mode.
+
 Footnotes are generally discouraged, though they may be used when they are the
 best way to present specific information. When a footnote reference is added at
 the end of the sentence, it should follow the sentence-ending punctuation. The

Modified: doctools/trunk/Doc-3k/documenting/style.rst
==============================================================================
--- doctools/trunk/Doc-3k/documenting/style.rst	(original)
+++ doctools/trunk/Doc-3k/documenting/style.rst	Tue Aug 14 20:04:22 2007
@@ -17,6 +17,10 @@
 Make generous use of blank lines where applicable; they help grouping things
 together.
 
+A sentence-ending period may be followed by one or two spaces; while reST
+ignores the second space, it is customarily put in by some users, for example
+to aid Emacs' auto-fill mode.
+
 Footnotes are generally discouraged, though they may be used when they are the
 best way to present specific information. When a footnote reference is added at
 the end of the sentence, it should follow the sentence-ending punctuation. The