ID Index

Index of IDs in this document. Exported IDs indicated like this.

<sect id=intro>1 Introduction

<sect id=sgml>2 SGML Overview

<subsect id=why.sgml>2.1 Why SGML?

<subsect id=what.sgml>2.2 What is SGML?

<figure id=fig.sgml>Figure 1

<subsect id=faq>2.3 Frequently Asked Questions

<subsubsect id=faq.html>2.3.1 What's wrong with HTML?

<subsubsect id=faq.latex>2.3.2 What about LaTeX?

<sect id=markup>3 Marking up your document

<subsect id=markup.intro>3.1 Sample document, and overview

<figure id=fig.simplesun>Figure 2

<figure id=fig.simplesun2>Figure 3

<subsect id=markup.entities>3.2 Entity references

<table id=table.entities>Table 1

<subsect id=markup.dtdsubset>3.3 Defining entities

<subsubsect id=markup.files>3.3.2 Referring to files

<subsect id=markup.min>3.4 Markup minimisation

<subsect id=markup.ms>3.5 Marked sections

<subsubsect id=markup.ms.cdata>3.5.1 CDATA marked sections

<subsubsect id=markup.ms.variants>3.5.2 Paper-only and web-only variants

<subsect id=markup.try>3.6 Try it yourself - running the SGML parser

<sect id=structure>4 The structure of the document

<table id=table.elements>Table 2

<subsect id=str.structure>4.1 Overall structure

<table id=table.dtdfeatures>Table 3

<subsect id=str.sect>4.2 Sectioning

<subsect id=str.backmatter>4.3 Backmatter - notes and bibliography

<subsect id=str.code>4.4 Documenting code

<subsect id=str.history>4.5 History

<subsect id=str.xrefs>4.6 Cross-references

<subsect id=str.figures>4.7 Figures

<subsect id=str.tables>4.8 Tables

<table id=table.oasis>Table 4

<subsect id=str.text>4.9 Text markup

<subsect id=str.maths>4.10 Maths

<subsect id=str.span>4.11 Output depending on media type

<sect id=doccode>5 Documenting source code

<subsect id=doccode.general>5.1 The structure of programcode documents

<subsubsect id=doccode.example>5.1.1 Example document

<figure id=fig.normprog>Figure 4

<subsubsect id=doccode.elements>5.1.2 The programcode element structure

<figure id=figure.programcode>Figure 5

<subsect id=doccode.languages>5.2 Specific language variants

<subsubsect id=doccode.fortran>5.2.1 Fortran

<subsubsect id=doccode.dsssl>5.2.2 DSSSL

<subsect id=doccode.org>5.3 Organising files

<sect id=processing>6 Processing your document

<subsect id=proc.setup>6.1 Setting up

<subsect id=proc.sgml2docs>6.2 sgml2docs

<subsect id=proc.sgml2hlp>6.3 Generating HELP files

<subsect id=proc.sgml2xml>6.4 Converting to XML

<subsect id=editors>6.5 Editors

<sect id=upconvert>7 Converting existing text to SGML

<subsect id=upconvert.latex>7.1 Upconversion from LaTeX

<subsect id=upconvert.sourcecode>7.2 Upconversion from source code

<subsect id=upconvert.recipe>7.3 Example: SUN upconversion step by step

<sect id=final>8 Finally

<subsect id=final.development>8.1 Further developments

<subsect id=final.xml>8.2 XML

<subsect id=final.ack>8.3 Acknowledgements

<sect id=appx.sgml>A SGML - some of the details

<subsect id=sgml.std>A.1 Standard identification

<subsect id=sgml.dtd>A.2 Reading DTDs

<subsect id=sgml.dtdsubset>A.3 Document type declaration subset

<subsect id=sgml.entities>A.4 SGML entities

<subsect id=sgml.ms>A.5 Marked sections

<sect id=appx.supportprogs>B Support utilities

<sect id=appx.general.dtd>C The Starlink General DTD

<subsect id=appx.general.elementlist>C.1 Element listing

<subsubsect id=el.sun.abstract>C.1.1 Element abstract

<subsubsect id=el.sun.angle>C.1.2 Element angle

<subsubsect id=el.sun.appendices>C.1.3 Element appendices

<subsubsect id=el.sun.attribution>C.1.4 Element attribution

<subsubsect id=el.sun.author>C.1.5 Element author

<subsubsect id=el.sun.authorlist>C.1.6 Element authorlist

<subsubsect id=el.sun.backmatter>C.1.7 Element backmatter

<subsubsect id=el.sun.blockquote>C.1.8 Element blockquote

<subsubsect id=el.sun.caption>C.1.9 Element caption

<subsubsect id=el.sun.change>C.1.10 Element change

<subsubsect id=el.sun.citation>C.1.11 Element citation

<subsubsect id=el.sun.cite>C.1.12 Element cite

<subsubsect id=el.sun.code>C.1.13 Element code

<subsubsect id=el.sun.codecollection>C.1.14 Element codecollection

<subsubsect id=el.sun.coderef>C.1.15 Element coderef

<subsubsect id=el.sun.colspec>C.1.16 Element colspec

<subsubsect id=el.sun.copyright>C.1.17 Element copyright

<subsubsect id=el.sun.coverimage>C.1.18 Element coverimage

<subsubsect id=el.sun.dd>C.1.19 Element dd

<subsubsect id=el.sun.distribution>C.1.20 Element distribution

<subsubsect id=el.sun.dl>C.1.21 Element dl

<subsubsect id=el.sun.docbody>C.1.22 Element docbody

<subsubsect id=el.sun.docdate>C.1.23 Element docdate

<subsubsect id=el.sun.docinfo>C.1.24 Element docinfo

<subsubsect id=el.sun.docnumber>C.1.25 Element docnumber

<subsubsect id=el.sun.docxref>C.1.26 Element docxref

<subsubsect id=el.sun.draftnote>C.1.27 Element draftnote

<subsubsect id=el.sun.dt>C.1.28 Element dt

<subsubsect id=el.sun.editors>C.1.29 Element editors

<subsubsect id=el.sun.em>C.1.30 Element em

<subsubsect id=el.sun.entry>C.1.31 Element entry

<subsubsect id=el.sun.figure>C.1.32 Element figure

<subsubsect id=el.sun.figurecontent>C.1.33 Element figurecontent

<subsubsect id=el.sun.foreign>C.1.34 Element foreign

<subsubsect id=el.sun.history>C.1.35 Element history

<subsubsect id=el.sun.index>C.1.36 Element index

<subsubsect id=el.sun.kbd>C.1.37 Element kbd

<subsubsect id=el.sun.keyword>C.1.38 Element keyword

<subsubsect id=el.sun.li>C.1.39 Element li

<subsubsect id=el.sun.line>C.1.40 Element line

<subsubsect id=el.sun.linespecific>C.1.41 Element linespecific

<subsubsect id=el.sun.m>C.1.42 Element m

<subsubsect id=el.sun.manualtype>C.1.43 Element manualtype

<subsubsect id=el.sun.mapid>C.1.44 Element mapid

<subsubsect id=el.sun.mapidlist>C.1.45 Element mapidlist

<subsubsect id=el.sun.mdefs>C.1.46 Element mdefs

<subsubsect id=el.sun.meqnarray>C.1.47 Element meqnarray

<subsubsect id=el.sun.mequation>C.1.48 Element mequation

<subsubsect id=el.sun.mlabel>C.1.49 Element mlabel

<subsubsect id=el.sun.mline>C.1.50 Element mline

<subsubsect id=el.sun.note>C.1.51 Element note

<subsubsect id=el.sun.ol>C.1.52 Element ol

<subsubsect id=el.sun.otherauthors>C.1.53 Element otherauthors

<subsubsect id=el.sun.p>C.1.54 Element p

<subsubsect id=el.sun.px>C.1.55 Element px

<subsubsect id=el.sun.quote>C.1.56 Element quote

<subsubsect id=el.sun.ref>C.1.57 Element ref

<subsubsect id=el.sun.routinelist>C.1.58 Element routinelist

<subsubsect id=el.sun.row>C.1.59 Element row

<subsubsect id=el.sun.sect>C.1.60 Element sect

<subsubsect id=el.sun.softwareversion>C.1.61 Element softwareversion

<subsubsect id=el.sun.span>C.1.62 Element span

<subsubsect id=el.sun.strong>C.1.63 Element strong

<subsubsect id=el.sun.subhead>C.1.64 Element subhead

<subsubsect id=el.sun.subsect>C.1.65 Element subsect

<subsubsect id=el.sun.subsubsect>C.1.66 Element subsubsect

<subsubsect id=el.sun.subsubsubsect>C.1.67 Element subsubsubsect

<subsubsect id=el.sun.sun>C.1.68 Element sun

<subsubsect id=el.sun.table>C.1.69 Element table

<subsubsect id=el.sun.tabular>C.1.70 Element tabular

<subsubsect id=el.sun.tbody>C.1.71 Element tbody

<subsubsect id=el.sun.tgroup>C.1.72 Element tgroup

<subsubsect id=el.sun.thead>C.1.73 Element thead

<subsubsect id=el.sun.title>C.1.74 Element title

<subsubsect id=el.sun.ul>C.1.75 Element ul

<subsubsect id=el.sun.update>C.1.76 Element update

<subsubsect id=el.sun.url>C.1.77 Element url

<subsubsect id=el.sun.verbatim>C.1.78 Element verbatim

<subsubsect id=el.sun.version>C.1.79 Element version

<subsubsect id=el.sun.webref>C.1.80 Element webref

<sect id=appx.programcode.dtd>D The Programcode DTD

<subsect id=appx.programcode.elementlist>D.1 Element listing

<subsubsect id=el.programcode.angle>D.1.1 Element angle

<subsubsect id=el.programcode.argumentlist>D.1.2 Element argumentlist

<subsubsect id=el.programcode.attribution>D.1.3 Element attribution

<subsubsect id=el.programcode.author>D.1.4 Element author

<subsubsect id=el.programcode.authorlist>D.1.5 Element authorlist

<subsubsect id=el.programcode.authornote>D.1.6 Element authornote

<subsubsect id=el.programcode.blockquote>D.1.7 Element blockquote

<subsubsect id=el.programcode.bugs>D.1.8 Element bugs

<subsubsect id=el.programcode.change>D.1.9 Element change

<subsubsect id=el.programcode.cite>D.1.10 Element cite

<subsubsect id=el.programcode.code>D.1.11 Element code

<subsubsect id=el.programcode.codebody>D.1.12 Element codebody

<subsubsect id=el.programcode.codegroup>D.1.13 Element codegroup

<subsubsect id=el.programcode.codeopener>D.1.14 Element codeopener

<subsubsect id=el.programcode.codereference>D.1.15 Element codereference

<subsubsect id=el.programcode.colspec>D.1.16 Element colspec

<subsubsect id=el.programcode.copyright>D.1.17 Element copyright

<subsubsect id=el.programcode.dd>D.1.18 Element dd

<subsubsect id=el.programcode.description>D.1.19 Element description

<subsubsect id=el.programcode.diytopic>D.1.20 Element diytopic

<subsubsect id=el.programcode.dl>D.1.21 Element dl

<subsubsect id=el.programcode.docblock>D.1.22 Element docblock

<subsubsect id=el.programcode.docxref>D.1.23 Element docxref

<subsubsect id=el.programcode.dt>D.1.24 Element dt

<subsubsect id=el.programcode.em>D.1.25 Element em

<subsubsect id=el.programcode.entry>D.1.26 Element entry

<subsubsect id=el.programcode.example>D.1.27 Element example

<subsubsect id=el.programcode.examplelist>D.1.28 Element examplelist

<subsubsect id=el.programcode.examplenote>D.1.29 Element examplenote

<subsubsect id=el.programcode.foreign>D.1.30 Element foreign

<subsubsect id=el.programcode.funcname>D.1.31 Element funcname

<subsubsect id=el.programcode.history>D.1.32 Element history

<subsubsect id=el.programcode.implementationstatus>D.1.33 Element implementationstatus

<subsubsect id=el.programcode.invocation>D.1.34 Element invocation

<subsubsect id=el.programcode.kbd>D.1.35 Element kbd

<subsubsect id=el.programcode.li>D.1.36 Element li

<subsubsect id=el.programcode.line>D.1.37 Element line

<subsubsect id=el.programcode.linespecific>D.1.38 Element linespecific

<subsubsect id=el.programcode.m>D.1.39 Element m

<subsubsect id=el.programcode.mdefs>D.1.40 Element mdefs

<subsubsect id=el.programcode.meqnarray>D.1.41 Element meqnarray

<subsubsect id=el.programcode.mequation>D.1.42 Element mequation

<subsubsect id=el.programcode.mlabel>D.1.43 Element mlabel

<subsubsect id=el.programcode.mline>D.1.44 Element mline

<subsubsect id=el.programcode.moduletype>D.1.45 Element moduletype

<subsubsect id=el.programcode.name>D.1.46 Element name

<subsubsect id=el.programcode.ol>D.1.47 Element ol

<subsubsect id=el.programcode.otherauthors>D.1.48 Element otherauthors

<subsubsect id=el.programcode.othernames>D.1.49 Element othernames

<subsubsect id=el.programcode.p>D.1.50 Element p

<subsubsect id=el.programcode.parameter>D.1.51 Element parameter

<subsubsect id=el.programcode.parameterlist>D.1.52 Element parameterlist

<subsubsect id=el.programcode.programcode>D.1.53 Element programcode

<subsubsect id=el.programcode.purpose>D.1.54 Element purpose

<subsubsect id=el.programcode.px>D.1.55 Element px

<subsubsect id=el.programcode.quote>D.1.56 Element quote

<subsubsect id=el.programcode.ref>D.1.57 Element ref

<subsubsect id=el.programcode.returnvalue>D.1.58 Element returnvalue

<subsubsect id=el.programcode.routine>D.1.59 Element routine

<subsubsect id=el.programcode.routinename>D.1.60 Element routinename

<subsubsect id=el.programcode.routineprologue>D.1.61 Element routineprologue

<subsubsect id=el.programcode.row>D.1.62 Element row

<subsubsect id=el.programcode.softwarekeywords>D.1.63 Element softwarekeywords

<subsubsect id=el.programcode.span>D.1.64 Element span

<subsubsect id=el.programcode.strong>D.1.65 Element strong

<subsubsect id=el.programcode.tabular>D.1.66 Element tabular

<subsubsect id=el.programcode.tbody>D.1.67 Element tbody

<subsubsect id=el.programcode.tgroup>D.1.68 Element tgroup

<subsubsect id=el.programcode.thead>D.1.69 Element thead

<subsubsect id=el.programcode.title>D.1.70 Element title

<subsubsect id=el.programcode.type>D.1.71 Element type

<subsubsect id=el.programcode.ul>D.1.72 Element ul

<subsubsect id=el.programcode.url>D.1.73 Element url

<subsubsect id=el.programcode.usage>D.1.74 Element usage

<subsubsect id=el.programcode.userkeywords>D.1.75 Element userkeywords

<subsubsect id=el.programcode.verbatim>D.1.76 Element verbatim

<subsubsect id=el.programcode.webref>D.1.77 Element webref

<sect id=appx.system>E The Starlink SGML set for maintainers

<subsect id=appx.system.sgml>E.1 SGML arcana

<subsubsect id=appx.system.sgmldoc>E.1.1 The SGML status of this project

<subsubsect id=appx.system.hytime>E.1.2 HyTime, architectures and groves

<subsubsect id=appx.system.dsssl>E.1.3 DSSSL

<subsubsubsect id=appx.system.jade>E.1.3.1 Jade and OpenJade

<subsubsubsect id=appx.system.paramdsssl>E.1.3.2 Customising the DSSSL source code.

<subsect id=appx.system.summaries>E.2 Document summaries

<subsect id=appx.system.htx>E.3 Cross-references, installing documents, and the interaction with HTX

<subsect id=appx.system.dssslcode>E.4 The DSSSL source code

<subsect id=appx.system.software>E.5 Other supporting software

<subsubsect id=appx.system.software.lib>E.5.1 Library scripts

<subsect id=appx.system.online>E.6 Online resources

<subsect id=install>E.7 Installation

<sect id=appx.releasenotes>F Release Notes

<subsect id=release-0.7>F.1 Release Notes, version DR-0.7

<subsect id=release-0.6>F.2 Release Notes, version DR-0.6

<subsect id=release-0.5>F.3 Release Notes, version DR-0.5

<subsect id=release-0.4>F.4 Release Notes, version DR-0.4

<subsect id=release-0.3>F.5 Release Notes, version DR-0.3

<subsect id=release-0.2>F.6 Release Notes, version 0.2