GAPDoc

( Version 0.99 )

Frank Lübeck
e-mail: Frank.Luebeck@Math.RWTH-Aachen.De
WWW: http://www.math.rwth-aachen.de/~Frank.Luebeck

Max Neunhöffer
e-mail: Max.Neunhoeffer@Math.RWTH-Aachen.De
WWW: http://www.math.rwth-aachen.de/~Max.Neunhoeffer

Copyright

(C) 2000 by Frank Lübeck and Max Neunhöffer

We adopt the copyright regulations of GAP as detailed in the copyright notice in the GAP manual.

Contents

1. Introduction and Example
   1.1 XML
   1.2 A complete example
   1.3 Some questions
2. How To Type a GAPDoc Document
   2.1 General XML Syntax
      2.1-1 Head of XML Document
      2.1-2 Comments
      2.1-3 Processing Instructions
      2.1-4 Names in XML and Whitespace
      2.1-5 Elements
      2.1-6 Start Tags
      2.1-7 End Tags
      2.1-8 Combined Tags for Empty Elements
      2.1-9 Entities
      2.1-10 Special Characters in XML
      2.1-11 CDATA
      2.1-12 Encoding of an XML document
      2.1-13 Well Formed and Valid XML Documents
   2.2 Entering GAPDoc Documents
      2.2-1 More Special Characters
      2.2-2 Mathematical Formulae
      2.2-3 More Entities
3. The Document Type Definition
   3.1 What is a DTD?
   3.2 Overall Document Structure
      3.2-1
      3.2-2
      3.2-3 </code></a><br>       <a href="chap3.html#s2ss4">3.2-4 <code class="code"><Subtitle></code></a><br>       <a href="chap3.html#s2ss5">3.2-5 <code class="code"><Version></code></a><br>       <a href="chap3.html#s2ss6">3.2-6 <code class="code"><Author></code></a><br>       <a href="chap3.html#s2ss7">3.2-7 <code class="code"><Date></code></a><br>       <a href="chap3.html#s2ss8">3.2-8 <code class="code"><Abstract></code></a><br>       <a href="chap3.html#s2ss9">3.2-9 <code class="code"><Copyright></code></a><br>       <a href="chap3.html#s2ss10">3.2-10 <code class="code"><Acknowledgements></code></a><br>       <a href="chap3.html#s2ss11">3.2-11 <code class="code"><Colophon></code></a><br>       <a href="chap3.html#s2ss12">3.2-12 <code class="code"><TableOfContents></code></a><br>       <a href="chap3.html#s2ss13">3.2-13 <code class="code"><Bibliography></code> </a><br>       <a href="chap3.html#s2ss14">3.2-14 <code class="code"><TheIndex></code></a><br>    <a href="chap3.html#s3ss0">3.3 Sectioning Elements</a><br>       <a href="chap3.html#s3ss1">3.3-1 <code class="code"><Body></code></a><br>       <a href="chap3.html#s3ss2">3.3-2 <code class="code"><Chapter></code></a><br>       <a href="chap3.html#s3ss3">3.3-3 <code class="code"><Heading></code></a><br>       <a href="chap3.html#s3ss4">3.3-4 <code class="code"><Appendix></code></a><br>       <a href="chap3.html#s3ss5">3.3-5 <code class="code"><Section></code></a><br>       <a href="chap3.html#s3ss6">3.3-6 <code class="code"><Subsection></code></a><br>    <a href="chap3.html#s4ss0">3.4 ManSection</a><br>       <a href="chap3.html#s4ss1">3.4-1 <code class="code"><ManSection></code></a><br>       <a href="chap3.html#s4ss2">3.4-2 <code class="code"><Func></code></a><br>       <a href="chap3.html#s4ss3">3.4-3 <code class="code"><Oper></code></a><br>       <a href="chap3.html#s4ss4">3.4-4 <code class="code"><Meth></code></a><br>       <a href="chap3.html#s4ss5">3.4-5 <code class="code"><Filt></code></a><br>       <a href="chap3.html#s4ss6">3.4-6 <code class="code"><Prop></code></a><br>       <a href="chap3.html#s4ss7">3.4-7 <code class="code"><Attr></code></a><br>       <a href="chap3.html#s4ss8">3.4-8 <code class="code"><Var></code></a><br>       <a href="chap3.html#s4ss9">3.4-9 <code class="code"><Fam></code></a><br>       <a href="chap3.html#s4ss10">3.4-10 <code class="code"><InfoClass></code></a><br>    <a href="chap3.html#s5ss0">3.5 Cross Referencing and Citations</a><br>       <a href="chap3.html#s5ss1">3.5-1 <code class="code"><Ref></code></a><br>       <a href="chap3.html#s5ss2">3.5-2 <code class="code"><Label></code></a><br>       <a href="chap3.html#s5ss3">3.5-3 <code class="code"><Cite></code></a><br>       <a href="chap3.html#s5ss4">3.5-4 <code class="code"><Index></code></a><br>       <a href="chap3.html#s5ss5">3.5-5 <code class="code"><URL></code></a><br>       <a href="chap3.html#s5ss6">3.5-6 <code class="code"><Email></code></a><br>       <a href="chap3.html#s5ss7">3.5-7 <code class="code"><Homepage></code></a><br>    <a href="chap3.html#s6ss0">3.6 Structural Elements like Lists</a><br>       <a href="chap3.html#s6ss1">3.6-1 <code class="code"><List></code></a><br>       <a href="chap3.html#s6ss2">3.6-2 <code class="code"><Mark></code></a><br>       <a href="chap3.html#s6ss3">3.6-3 <code class="code"><Item></code></a><br>       <a href="chap3.html#s6ss4">3.6-4 <code class="code"><Enum></code></a><br>       <a href="chap3.html#s6ss5">3.6-5 <code class="code"><Table></code></a><br>    <a href="chap3.html#s7ss0">3.7 Types of Text</a><br>       <a href="chap3.html#s7ss1">3.7-1 <code class="code"><Emph></code> and <code class="code"><E></code></a><br>       <a href="chap3.html#s7ss2">3.7-2 <code class="code"><Quoted></code> and <code class="code"><Q></code></a><br>       <a href="chap3.html#s7ss3">3.7-3 <code class="code"><Keyword></code> and <code class="code"><K></code></a><br>       <a href="chap3.html#s7ss4">3.7-4 <code class="code"><Arg></code> and <code class="code"><A></code></a><br>       <a href="chap3.html#s7ss5">3.7-5 <code class="code"><Code></code> and <code class="code"><C></code></a><br>       <a href="chap3.html#s7ss6">3.7-6 <code class="code"><File></code> and <code class="code"><F></code></a><br>       <a href="chap3.html#s7ss7">3.7-7 <code class="code"><Button></code> and <code class="code"><B></code></a><br>       <a href="chap3.html#s7ss8">3.7-8 <code class="code"><Package></code></a><br>       <a href="chap3.html#s7ss9">3.7-9 <code class="code"><Listing></code></a><br>       <a href="chap3.html#s7ss10">3.7-10 <code class="code"><Log></code> and <code class="code"><Example></code></a><br>       <a href="chap3.html#s7ss11">3.7-11 <Verb></a><br>    <a href="chap3.html#s8ss0">3.8 Elements for Mathematical Formulae</a><br>       <a href="chap3.html#s8ss1">3.8-1 <code class="code"><Math></code> and <code class="code"><Display></code></a><br>       <a href="chap3.html#s8ss2">3.8-2 <code class="code"><M></code></a><br>    <a href="chap3.html#s9ss0">3.9 Everything else</a><br>       <a href="chap3.html#s9ss1">3.9-1 <code class="code"><Alt></code></a><br>       <a href="chap3.html#s9ss2">3.9-2 <code class="code"><Par></code> and <code class="code"><P></code></a><br> <a href="chap4.html#s0ss0">4. Distributing a Document into Several Files</a><br>    <a href="chap4.html#s1ss0">4.1 The Conventions</a><br>    <a href="chap4.html#s2ss0">4.2 A Tool for Collecting a Document</a><br>       <a href="chap4.html#s2ss1">4.2-1 ComposedXMLString</a><br> <a href="chap5.html#s0ss0">5. The Converters</a><br>    <a href="chap5.html#s1ss0">5.1 Producing Documentation from Source Files</a><br>       <a href="chap5.html#s1ss1">5.1-1 MakeGAPDocDoc</a><br>    <a href="chap5.html#s2ss0">5.2 Parsing XML Documents</a><br>       <a href="chap5.html#s2ss1">5.2-1 ParseTreeXMLString</a><br>       <a href="chap5.html#s2ss2">5.2-2 DisplayXMLStructure</a><br>       <a href="chap5.html#s2ss3">5.2-3 ApplyToNodesParseTree</a><br>       <a href="chap5.html#s2ss4">5.2-4 CheckAndCleanGapDocTree</a><br>       <a href="chap5.html#s2ss5">5.2-5 AddParagraphNumbersGapDocTree</a><br>    <a href="chap5.html#s3ss0">5.3 The Converters</a><br>       <a href="chap5.html#s3ss1">5.3-1 GAPDoc2LaTeX</a><br>       <a href="chap5.html#s3ss2">5.3-2 GAPDoc2Text</a><br>       <a href="chap5.html#s3ss3">5.3-3 GAPDoc2TextPrintTextFiles</a><br>       <a href="chap5.html#s3ss4">5.3-4 AddPageNumbersToSix</a><br>       <a href="chap5.html#s3ss5">5.3-5 PrintSixFile</a><br>       <a href="chap5.html#s3ss6">5.3-6 GAPDoc2HTML</a><br>       <a href="chap5.html#s3ss7">5.3-7 GAPDoc2HTMLPrintHTMLFiles</a><br>    <a href="chap5.html#s4ss0">5.4 Parsing BibTeX Files</a><br>       <a href="chap5.html#s4ss1">5.4-1 ParseBibFiles</a><br>       <a href="chap5.html#s4ss2">5.4-2 NormalizeNameAndKey</a><br>       <a href="chap5.html#s4ss3">5.4-3 WriteBibFile</a><br>    <a href="chap5.html#s5ss0">5.5 Text Utilities</a><br>       <a href="chap5.html#s5ss1">5.5-1 WHITESPACE</a><br>       <a href="chap5.html#s5ss2">5.5-2 TextAttr</a><br>       <a href="chap5.html#s5ss3">5.5-3 FormatParagraph</a><br>       <a href="chap5.html#s5ss4">5.5-4 SubstitutionSublist</a><br>       <a href="chap5.html#s5ss5">5.5-5 StripBeginEnd</a><br>       <a href="chap5.html#s5ss6">5.5-6 StripEscapeSequences</a><br>       <a href="chap5.html#s5ss7">5.5-7 RepeatedString</a><br>       <a href="chap5.html#s5ss8">5.5-8 NumberDigits</a><br>       <a href="chap5.html#s5ss9">5.5-9 PositionMatchingDelimiter</a><br>       <a href="chap5.html#s5ss10">5.5-10 WordsString</a><br>    <a href="chap5.html#s6ss0">5.6 Print Utilities</a><br>       <a href="chap5.html#s6ss1">5.6-1 PrintTo1</a><br>       <a href="chap5.html#s6ss2">5.6-2 StringPrint</a><br>       <a href="chap5.html#s6ss3">5.6-3 PrintFormattedString</a><br>       <a href="chap5.html#s6ss4">5.6-4 Page</a><br>       <a href="chap5.html#s6ss5">5.6-5 StringFile</a><br> <a href="chapA.html#s0ss0">A. The file <code class="file">3k+1.xml</code></a><br> <a href="chapB.html#s0ss0">B. The File <code class="file">gapdoc.dtd</code></a><br> <br> </div> <div class="pcenter"> <table class="chlink"><tr><td><a href="chap0.html">Top of Book</a></td><td><a href="chap1.html">Next Chapter</a></td></tr></table> <br> <div class="pcenter"><table class="chlink"><tr><td class="chlink1">Goto Chapter: </td><td><a href="chap0.html">Top</a></td><td><a href="chap1.html">1</a></td><td><a href="chap2.html">2</a></td><td><a href="chap3.html">3</a></td><td><a href="chap4.html">4</a></td><td><a href="chap5.html">5</a></td><td><a href="chapA.html">A</a></td><td><a href="chapB.html">B</a></td><td><a href="chapBib.html">Bib</a></td><td><a href="chapInd.html">Ind</a></td></tr></table><br></div> </div> <hr> <p class="foot">generated by GAPDoc2HTML</p> </body> </html>