summaryrefslogtreecommitdiff
path: root/doc/mallard/C/mal_block_example.xml
diff options
context:
space:
mode:
Diffstat (limited to 'doc/mallard/C/mal_block_example.xml')
-rw-r--r--doc/mallard/C/mal_block_example.xml14
1 files changed, 9 insertions, 5 deletions
diff --git a/doc/mallard/C/mal_block_example.xml b/doc/mallard/C/mal_block_example.xml
index 0e4ab80..9f6b8be 100644
--- a/doc/mallard/C/mal_block_example.xml
+++ b/doc/mallard/C/mal_block_example.xml
@@ -36,22 +36,26 @@ may be used to group example input with its result, to show different
steps with different types of block elements, or simply to group some
paragraphs together.</p>
-<comment>
- <cite date="2008-12-11"><name>Shaun McCance</name></cite>
- <p>Add explanation, examples</p>
-</comment>
<!-- BEGIN notes -->
<section id="notes">
<title>Notes</title>
<list type="bullet">
+ <item><p>The <code>example</code> element can contain any
+ <link xref="mal_block">general block content</link>.</p></item>
+
+ <item><p>The <code>example</code> element can occur in any
+ general block context, including inside
+ <link xref="mal_page">pages</link>, <link xref="mal_section">sections</link>,
+ and certain <link xref="mal_block">block elements</link>.</p></item>
+
<item><p>The <code>style</code> attribute takes a space-separated list of
style hints. Processing tools should adjust their behavior according to
those style hints they understand.</p></item>
<item><p>The <code>example</code> element can have attributes from external
namespaces. See <link xref="mal_external"/> for more information
- on external-namespace attributes on block elements.</p></item>
+ on external-namespace attributes.</p></item>
</list>
</section>
<!-- END notes -->