Commit c54e397f authored by rrt's avatar rrt
Browse files

[project @ 2000-10-09 16:53:49 by rrt]

Added a tip about using <Para> inside <ListItem>s.
parent 9cd3ca36
...@@ -31,13 +31,28 @@ The GHC documentation is written using DocBook 3.1, so the DTD line should be: ...@@ -31,13 +31,28 @@ The GHC documentation is written using DocBook 3.1, so the DTD line should be:
&lt;!DOCTYPE Article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"&gt; &lt;!DOCTYPE Article PUBLIC "-//OASIS//DTD DocBook V3.1//EN"&gt;
</Screen> </Screen>
<Para> <Para> This guide is <Emphasis>not</Emphasis> meant to teach you how to
This guide is <Emphasis>not</Emphasis> meant to teach you how to write DocBook; read the <ULink URL="http://www.docbook.org/">DocBook book</ULink> for that. It is more of a reference than a tutorial, so see the <ULink URL="http://www.oasis-open.org/docbook/">DocBook home page</ULink> for other links. write DocBook; read the <ULink URL="http://www.docbook.org/">DocBook
</Para> book</ULink> for that. It is more of a reference than a tutorial, so see the
<ULink URL="http://www.oasis-open.org/docbook/">DocBook home page</ULink>
for other links. </Para>
<Para> <Para> However, by popular demand, here are some useful points: </Para>
The rest of this section outlines the use of several tags which may not be obvious (DocBook is rather scholastic in style: it has tags for many things from C function prototypes to keyboard bindings; at the same time it has many omissions and oddities). The current scheme has many infelicities, partly because it was dreamt up in a hurry while the author was learning DocBook and converting the documentation thereto, and partly because DocBook is rather C-centric.
</Para> <ItemizedList>
<ListItem>
<Para>Remember to use <SGMLTag class="StartTag">Para</SGMLTag> inside
<SGMLTag class="StartTag">ListItem</SGMLTag>s.
</ListItem>
</ItemizedList>
<Para> The rest of this section outlines the use of several tags which may
not be obvious (DocBook is rather scholastic in style: it has tags for many
things from C function prototypes to keyboard bindings; at the same time it
has many omissions and oddities). The current scheme has many infelicities,
partly because it was dreamt up in a hurry while the author was learning
DocBook and converting the documentation thereto, and partly because DocBook
is rather C-centric. </Para>
<VariableList> <VariableList>
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment