Moved around a couple of sections.

diff --git a/src/manual/syntax/syntax.rst b/src/manual/syntax/syntax.rst
index 43d4abcff3ba949997e520c343026cb2f7f3b82c..7acc92b4eebca78204f39ddc66d2552b3149cf09 100644 (file)
--- a/src/manual/syntax/syntax.rst
+++ b/src/manual/syntax/syntax.rst
@@ -5,29 +5,32 @@ Syntax
 .. toctree::
     :hidden:
 
-Code for ``re2c`` consists of a set of `rules`_, `definitions`_ and `configurations`_.
+A program can contain any number of re2c blocks.
+Each block consists of a sequence of `definitions`_,
+`configurations`_ and `rules`_ that contain `regular expressions`_.
+The generated lexers communicate with the outer world using the `interface code`_.
 
 Rules
 ----------
 
 .. include:: rules.rst_
 
+Regular expressions
+-------------------
+
+.. include:: regular_expressions.rst_
+
 Definitions
 -----------
 
 .. include:: named_definitions.rst_
 
-Configurations
+Interface code
 --------------
 
-.. include:: configurations.rst_
-
-Regular expressions
--------------------
-
-.. include:: regular_expressions.rst_
+.. include:: interface.rst_
 
-Interface
-----------
+Configurations
+--------------
 
-.. include:: interface.rst_
+.. include:: configurations.rst_