summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStuart Rackham <srackham@methods.co.nz>2012-06-24 12:00:11 +1200
committerStuart Rackham <srackham@methods.co.nz>2012-06-24 12:00:11 +1200
commitc82d992e08330cd68db537a65b15930716db6973 (patch)
tree170c02f8b54a9cbff496618a69ee50a06cd7722f
parentde4d39f56f95c00907d90286954de2eb569f7e84 (diff)
downloadasciidoc-c82d992e08330cd68db537a65b15930716db6973.tar.gz
User Guide: Polished 'Open Block' documentation.
-rw-r--r--doc/asciidoc.txt19
1 files changed, 11 insertions, 8 deletions
diff --git a/doc/asciidoc.txt b/doc/asciidoc.txt
index d5b9f2a..af64866 100644
--- a/doc/asciidoc.txt
+++ b/doc/asciidoc.txt
@@ -1813,20 +1813,23 @@ Open blocks are special:
- They can be used to group block elements for <<X15,List item
continuation>>.
-- Appropriately styled they can be used in place of any other
- delimited block. The following built-in styles can be applied to
- open blocks: 'literal', 'verse', 'quote', 'listing', 'TIP', 'NOTE',
+- Open blocks can be styled to behave like any other type of delimited
+ block. The following built-in styles can be applied to open
+ blocks: 'literal', 'verse', 'quote', 'listing', 'TIP', 'NOTE',
'IMPORTANT', 'WARNING', 'CAUTION', 'abstract', 'partintro',
'comment', 'example', 'sidebar', 'source', 'music', 'latex',
- 'graphviz'. For example:
+ 'graphviz'. For example, the following open block and listing block
+ are functionally identical:
- [NOTE]
+ [listing]
--
- First paragraph ...
-
- Second paragraph ...
+ Lorum ipsum ...
--
+ ---------------
+ Lorum ipsum ...
+ ---------------
+
- An unstyled open block groups section elements but otherwise does
nothing.