Improve and test "compound" handling in LaTeX.

Test samples added to standard.txt allow inspection of the outcome of
compound handling for all output formats.

git-svn-id: http://svn.code.sf.net/p/docutils/code/trunk@8052 929543f6-e4f2-0310-98a6-ba3bd3dd1d04

1 files changed, 59 insertions, 14 deletions

diff --git a/docutils/test/functional/input/data/standard.txt b/docutils/test/functional/input/data/standard.txt
index 7e60f0dbc..7e2b1d7f3 100644
--- a/docutils/test/functional/input/data/standard.txt
+++ b/docutils/test/functional/input/data/standard.txt
@@ -731,25 +731,33 @@ I recommend you try |Python|_.
 Compound Paragraph
 ``````````````````
 
+The *compound* directive is used to create a "compound paragraph", which
+is a single logical paragraph containing multiple physical body
+elements. For example:
+
 .. compound::
-   :class: some-class
 
-   Compound 1, paragraph 1.
+   The 'rm' command is very dangerous.  If you are logged
+   in as root and enter ::
 
-   Compound 1, paragraph 2.
+       cd /
+       rm -rf *
 
-   * Compound 1, list item one.
-   * Compound 1, list item two.
+   you will erase the entire contents of your file system.
 
-Another compound statement:
+Test the handling and display of compound paragraphs:
 
 .. compound::
+   :class: some-class
 
-   Compound 2, a literal block::
+   Compound 2, paragraph 1,
 
-       Compound 2, literal.
+   compound 2, paragraph 2,
 
-   Compound 2, this is a test.
+   * list item 1,
+   * list item 2,
+
+   compound 2, paragraph 3.
 
 .. compound::
 
@@ -762,7 +770,7 @@ Another compound statement:
        Compound 4.
        This one starts with a literal block.
 
-   Compound 4, a paragraph.
+   Compound 4, paragraph following the literal block.
 
 Now something *really* perverted -- a nested compound block.  This is
 just to test that it works at all; the results don't have to be
@@ -774,7 +782,7 @@ meaningful.
 
    .. compound::
 
-      Compound 6, block 2 in compound 5.
+      Compound 6 is block 2 in compound 5.
 
       Compound 6, another paragraph.
 
@@ -782,7 +790,8 @@ meaningful.
 
 .. compound::
 
-   Compound 7, with a table inside:
+   Compound 7, tests the inclusion of various block-level
+   elements in one logical paragraph. First a table,
 
    +--------------------+--------------------+--------------------+
    | Left cell, first   | Middle cell,       | Right cell.        |
@@ -792,9 +801,45 @@ meaningful.
    | paragraph.         |                    | Paragraph 3.       |
    +--------------------+--------------------+--------------------+
 
-   Compound 7, a paragraph after the table.
+   followed by a paragraph. This physical paragraph is
+   actually a continuation of the paragraph before the table. It is followed
+   by
+
+     a quote and
+
+   #. an enumerated list,
+
+   a paragraph,
+
+   --an  option list,
+
+   a paragraph,
+
+   :a field: list,
+
+   a paragraph,
+
+   a definition
+     list,
+
+   a paragraph, an image:
+
+   .. image:: ../../../docs/user/rst/images/biohazard.png
+
+   a paragraph,
+
+   | a line
+   | block,
+
+   a paragraph followed by a comment,
+
+   .. this is a comment
+
+   a paragraph, a
+
+   .. note:: with content
 
-   Compound 7, another paragraph.
+   and the final paragraph of the compound 7.
 
 Parsed Literal Blocks
 `````````````````````