# HG changeset patch
# User Olivier Delalleau <delallea@iro>
# Date 1284756669 14400
# Node ID bc1b445e22fa8c7fd6fed6ca28fe426e1f173341
# Parent  14aa0a5bb66117ff143b82e580802fcc9eb529c3
API_coding_style: Added code example to explain the point about the number of spaces after a period

diff -r 14aa0a5bb661 -r bc1b445e22fa doc/v2_planning/API_coding_style.txt
--- a/doc/v2_planning/API_coding_style.txt	Fri Sep 17 16:41:51 2010 -0400
+++ b/doc/v2_planning/API_coding_style.txt	Fri Sep 17 16:51:09 2010 -0400
@@ -43,6 +43,13 @@
 
     * Use only one space (not two) after a sentence-ending period in comments.
 
+      .. code-block:: python
+
+        # Good.
+        # This is the first sentence. It is followed by a single blank space.
+        # Bad.
+        # This is the first sentence.  It is followed by two blank spaces.
+
     * You do not need to add an extra blank line before the closing quotes of
       a multi-line docstring. Also, we ask that the first line of a multi-line
       docstring should contain only the opening quotes.