Added a glossary with an alphabethical list of elements

[xmldoc.git] / doc / overall.xml

diff --git a/doc/overall.xml b/doc/overall.xml
index d662a76..22ac06c 100644 (file)
--- a/doc/overall.xml
+++ b/doc/overall.xml
@@ -5,12 +5,12 @@
 <!--
       XML documentation system
       Original author :  Arjen Baart - arjen@andromeda.nl
-      Version         : $Revision: 1.1 $
+      Version         : $Revision: 1.2 $
 -->
 
 
 <chapter>
-<heading>Overall document structure</heading>
+<heading><label name='overall'/>Overall document structure</heading>
 
 <para>
 All XML-doc documents are set up in a similar way.
@@ -60,7 +60,7 @@ The example shows a minimal XML-doc document:
 </verbatim>
 
 <section>
-<heading>Preamble</heading>
+<heading><label name='preamble'/>Preamble</heading>
 <para>
 The document preamble is everything that comes before the real page of text.
 Typical elements of the preamble are the title page and the table of contents.
@@ -104,12 +104,15 @@ All it takes is an empty <strong>toc</strong> element:
 <para>
 The table of contents is optional, but if you use it, it must come
 between the title page and the first chapter.
+<remark>Note for LaTeX: to actually make the table of contents, you
+need to run <strong>latex</strong> twice. LaTeX does not do this in
+a single pass.</remark>
 </para>
 
 </section>
 
 <section>
-<heading>Sectioning and Paragraphs</heading>
+<heading><label name='section'/>Sectioning and Paragraphs</heading>
 
 <para>
 After the opening tag of the first chapter, the document really begins.
@@ -131,6 +134,12 @@ Note that the names are equivalent to their counterparts in LaTeX.
 </para>
 
 <para>
+Just as in LaTeX, the <code>article</code> document type does not have
+a <code>chapter</code> element.
+The top-level sectioning element for an <code>article</code> is a
+<code>section</code>.
+</para>
+<para>
 After the open tag of a sectioning element (<code>chapter</code>,
 <code>section</code>, <code>subsection</code> or <code>subsubsection</code>, etc.)
 comes the <strong>heading</strong> element, followed by the block level content