[Python-checkins] r56613 - doctools/trunk/converter/newfiles/doc_rest.rst

[georg.brandl]

Author: georg.brandl
Date: Sun Jul 29 10:27:57 2007
New Revision: 56613

Modified:
   doctools/trunk/converter/newfiles/doc_rest.rst
Log:
[Carl Cerecke] Reword first section.


Modified: doctools/trunk/converter/newfiles/doc_rest.rst
==============================================================================
--- doctools/trunk/converter/newfiles/doc_rest.rst	(original)
+++ doctools/trunk/converter/newfiles/doc_rest.rst	Sun Jul 29 10:27:57 2007
@@ -4,22 +4,25 @@
 =======================
 
 This section is a brief introduction to reStructuredText (reST) concepts and
-syntax, to provide authors enough information to autor documents productively.
+syntax, intended to provide authors with enough information to author
+documents productively.
 Since reST was designed to be a simple, unobtrusive markup language, this will
 not take too long.
 
 .. seealso::
 
-   The authoritative `reStructuredText User
-   Documentation <http://docutils.sourceforge.net/rst.html>`_.
+    The authoritative `reStructuredText User
+    Documentation <http://docutils.sourceforge.net/rst.html>`_.
 
 
 Paragraphs
 ----------
 
-The most basic block a reST document is made of.  Paragraphs are chunks of text
-separated by one ore more blank lines.  As in Python, indentation is significant
-in reST, so all lines of a paragraph must be left-aligned.
+The paragraph is the most basic block in a reST document.
+Paragraphs are simply chunks of text
+separated by one or more blank lines.  As in Python, indentation is significant
+in reST, so all lines of the same paragraph must be left-aligned
+to the same level of indentation.
 
 
 Inline markup
@@ -226,4 +229,4 @@
 documents written from them will be in that encoding as well.
 
 
-XXX: Gotchas
\ No newline at end of file
+XXX: Gotchas