summaryrefslogtreecommitdiff
path: root/doc/mallard/C/mal_block_p.xml
blob: 31d5d69be4b0fa292baa80f03b8b948b274d5c00 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
<page xmlns="http://www.gnome.org/~shaunm/mallard"
      type="topic"
      id="mal_block_p">

<info>
  <version number="0.1" date="2007-02-21" status="stub"/>
</info>

<title>Paragraphs</title>

<synopsis><code mime="application/relax-ng-compact-syntax">
mal_block_p = element p {
  attribute style { xsd:NMTOKENS } ?,
  attribute * - (mal:* | local:*) { text } *,

  <link xref="mal_inline">mal_inline</link>
}
</code></synopsis>

<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>


<!-- BEGIN examples -->
<section id="examples">
  <title>Examples</title>
  <comment>
    <cite date="2007-01-25"><name>Shaun McCance</name></cite>
    <p>Add examples.</p>
  </comment>
</section>
<!-- END examples -->


<!-- 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>
</section>
<!-- END processing -->


<!-- BEGIN docbook -->
<section id="docbook">
  <title>Comparison to DocBook</title>
  <p>The <code>p</code> element in Mallard appears to be equivalent to to the
  <code href="http://www.docbook.org/tdg/en/html/para.html">para</code> element
  in DocBook.  While both elements create a paragraph in the formatted output,
  the <code>p</code> element in Mallard is actually much more restrictive, as it
  does not permit nested block content.  In this regard, it is actaully similar
  to the <code href="http://www.docbook.org/tdg/en/html/simpara.html">simpara</code>
  element in DocBook.</p>
</section>
<!-- END docbook -->

</page>