[gnome-doc-utils/mallard] [mallard] Finishing block_p

[Shaun McCance <shaunm src gnome org>]

commit da8856983fc2d574d9d20e1bd31d11c4ee7c876d
Author: Shaun McCance <shaunm gnome org>
Date:   Thu May 28 15:42:54 2009 -0500

    [mallard] Finishing block_p
---
 doc/mallard/C/mal_block_p.xml |   49 ++++++++++++++++++++++++++--------------
 1 files changed, 32 insertions(+), 17 deletions(-)

diff --git a/doc/mallard/C/mal_block_p.xml b/doc/mallard/C/mal_block_p.xml
index 742f29b..19d35e1 100644
--- a/doc/mallard/C/mal_block_p.xml
+++ b/doc/mallard/C/mal_block_p.xml
@@ -3,7 +3,20 @@
       id="mal_block_p">
 
 <info>
-  <version number="0.1" date="2007-02-21" status="stub"/>
+  <version number="0.1" date="2009-05-28" status="review"/>
+
+  <credit type="author">
+    <name>Shaun McCance</name>
+    <email>shaunm gnome org</email>
+  </credit>
+  <copyright>
+    <year>2008-2009</year>
+    <name>Shaun McCance</name>
+  </copyright>
+
+  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
+
+  <desc>Create a simple paragraph of text.</desc>
 </info>
 
 <title>Paragraphs</title>
@@ -19,12 +32,7 @@ mal_block_p = element p {
 
 <p>The most basic block-level element in Mallard is the <code>p</code>
 element.  The <code>p</code> element creates a paragraph in the formatted
-outout.</p>
-
-<comment>
-  <cite date="2007-01-25"><name>Shaun McCance</name></cite>
-  <p>Add some more description.</p>
-</comment>
+output.</p>
 
 
 <!-- BEGIN notes -->
@@ -54,10 +62,18 @@ outout.</p>
 <!-- BEGIN examples -->
 <section id="examples">
   <title>Examples</title>
-  <comment>
-    <cite date="2007-01-25"><name>Shaun McCance</name></cite>
-    <p>Add examples.</p>
-  </comment>
+
+  <p>Create a simple paragraph:</p>
+
+  <example>
+    <code><![CDATA[
+<p>The most basic block-level element in Mallard is the <code>p</code>
+element.  The <code>p</code> element creates a paragraph in the formatted
+output.</p>]]></code>
+    <p>The most basic block-level element in Mallard is the <code>p</code>
+    element.  The <code>p</code> element creates a paragraph in the formatted
+    output.</p>
+  </example>
 </section>
 <!-- END examples -->
 
@@ -65,12 +81,11 @@ outout.</p>
 <!-- BEGIN processing -->
 <section id="processing">
   <title>Processing Expectations</title>
-  <comment>
-    <cite date="2007-01-25"><name>Shaun McCance</name></cite>
-    <p>Add processing expectations.  Very basic.  Mention margins and
-    indentation as means of demarkating paragraphs.  Explicitly mention
-    the no-block-nesting thing.</p>
-  </comment>
+  <p>Paragraphs are displayed as block elements, with their child elements
+  interpreted as inline elements.  In on-screen media, paragraphs generally
+  have padding above and below them to separate them from the surrounding
+  block content.  In print media, the first line of each paragraph has
+  traditionally been indented.</p>
 </section>
 <!-- END processing -->