]> git.ipfire.org Git - thirdparty/bird.git/commitdiff
Critical files from linuxdoc1 distribution checked in.
authorPavel Machek <pavel@ucw.cz>
Thu, 11 May 2000 12:00:35 +0000 (12:00 +0000)
committerPavel Machek <pavel@ucw.cz>
Thu, 11 May 2000 12:00:35 +0000 (12:00 +0000)
doc/sbase/dist/birddoc/html/mapping [new file with mode: 0644]
doc/sbase/dist/birddoc/latex2e/mapping [new file with mode: 0644]
doc/sbase/dtd/linuxdoc.dtd [new file with mode: 0644]
doc/sgml2html [new file with mode: 0755]
doc/sgml2latex [new file with mode: 0755]

diff --git a/doc/sbase/dist/birddoc/html/mapping b/doc/sbase/dist/birddoc/html/mapping
new file mode 100644 (file)
index 0000000..834fe0f
--- /dev/null
@@ -0,0 +1,422 @@
+
+% Converts qwertz files to html files ready for fixref and html2html.
+%
+% This file is R-Rated because of uglyness.
+%
+% -Magnus <magnus@ii.uib.no>
+
+<qwertz>
+</qwertz>      +       "<@@enddoc>"            +
+
+<article>
+</article>     +       "<@@enddoc>"            +
+
+<report>
+</report>      +       "<@@enddoc>"            +
+
+<book>
+</book>                +       "<@@enddoc>"            +
+
+<notes>
+</notes>       +       "<@@enddoc>"            +
+
+% Manual Pages are expected to be formatted using nroff (or groff), unless
+% they are included  as sections of other qwertz documents.  
+
+<manpage>
+</manpage>
+
+<titlepag>
+</titlepag>
+
+<title>                +       "<@@title>"
+</title>
+
+<subtitle>     +       "<H2>"  
+</subtitle>            "</H2>"                 +
+
+<author>
+</author>
+
+<name>         +       "<H2>"
+</name>                        "</H2>"
+
+<and>                  " and "
+</and>
+
+<thanks>       +       "Thanks "
+</thanks>              
+
+<inst>         +       "<H3>"
+</inst>                        "</H3>"                 +
+
+<newline>              "<BR>"
+       
+<label>                +       "<@@label>[ID]"         +
+       
+<header>       
+</header>      
+
+<lhead>                +       "<!-- "
+</lhead>               " -->"                  +                       
+
+<rhead>                +       "<!-- "
+</rhead>               " -->"                  +
+
+<comment>      +       "<H4>Comment</H4>"      +
+</comment>             
+
+<abstract>     +       "<P><HR>\n<EM>"
+</abstract>            "</EM>\n<HR>"           +
+
+<appendix>     +       "<H2>Appendix</H2>"     +
+</appendix>
+
+<toc>
+</toc>
+
+<lof>
+</lof>
+
+<lot>
+</lot>
+
+<chapt>                +       "<@@chapt>"
+</chapt>       +       "<@@endchapt>"          +
+
+<sect>         +       "<@@sect>"
+</sect>                +       "<@@endsect>"           +
+
+<sect1>                +       "<@@ssect>"
+</sect1>       +       "<@@endssect>"          +
+
+<sect2>                +       "<@@head>"
+</sect2>
+
+<sect3>                +       "<@@head>"
+</sect3>
+
+<sect4>                +       "<@@head>"              
+</sect4>
+
+<heading>
+</heading>     +       "<@@endhead>"           +
+
+<p>                    "<P>"
+</p>                   ""                      +
+
+<itemize>      +       "<UL>"          +
+</itemize>     +       "</UL>"         +
+
+<enum>         +       "<OL>"          +
+</enum>                +       "</OL>"         +
+
+<descrip>      +       "<DL>"          +
+</descrip>     +       "</DL>"         +
+
+<item>         +       "<LI>"
+</item>                        "</LI>"         +
+
+<tag>                  "<DT><CODE>"
+</tag>                 "</CODE><DD>"
+
+<cite>                 "[<I>[ID]</I>]"
+</cite>
+
+<ncite>                        "[<I>[NOTE] ([ID])</I>]"
+</ncite>
+
+<footnote>     +       "<BLOCKQUOTE>"
+</footnote>            "</BLOCKQUOTE>"         +
+
+<sq>                   "\""
+</sq>                  "\""
+
+<lq>           +       "<LQ>"                  +
+</lq>          +       "</LQ>"                 +
+
+<em>                   "<EM>"
+</em>                  "</EM>"
+
+<bf>                   "<B>"
+</bf>                  "</B>"
+
+<it>                   "<I>"
+</it>                  "</I>"
+
+<sf>                   "<SF>"
+</sf>                  "</SF>"
+
+<sl>                   "<I>"
+</sl>                  "</I>"
+
+<tt>                   "<CODE>"
+</tt>                  "</CODE>"
+
+<cf>                   "<CODE>"
+</cf>                  "</CODE>"
+
+<m>                    "<I>"
+</m>                   "</I>"
+
+% url support by HG
+
+<url>          +       "<@@url>[URL]\n"
+                       "[NAME]</A>\n"
+                       "<@@endurl>"            +
+</url>
+
+<htmlurl>      +       "<@@url>[URL]\n"
+                       "[NAME]</A>\n"
+                       "<@@endurl>"            +
+</htmlurl>
+
+% ref modified to have an optional name field 
+<ref>          +       "<@@ref>[ID]\n"
+                       "[NAME]</A>\n"
+                       "<@@endref>"            +
+</ref>
+
+<href>         +       "<@@ref>[ID]"           +
+</href>
+
+<pageref>      +       "<@@ref>[ID]"           +
+</pageref>
+
+<nidx>         +       "<!--" +
+</nidx>                +       "-->"  +
+
+<ncdx>         +       "<!--" +
+</ncdx>                +       "-->"  +
+
+<x>
+</x>
+
+<mc>                   "<MC>"
+</mc>                  "</MC>"
+
+<biblio>       +       "<BIBLIO STYLE=\"[STYLE]\" FILES=\"[FILES]\">" +
+</biblio>      
+
+<code>         +       "<HR>\n<PRE>"           +
+</code>                +       "</PRE>\n<HR>"          +
+
+<verb>         +       "<PRE>"         +
+</verb>                +       "</PRE>"                +
+
+<tscreen>      +       "<BLOCKQUOTE><CODE>"    +
+</tscreen>     +       "</CODE></BLOCKQUOTE>"  +
+
+<quote>         +       "<BLOCKQUOTE>"  +
+</quote>        +       "</BLOCKQUOTE>" +
+
+% theorems and such
+
+<def>          +       "<DEF>"                 
+</def>         +       "</DEF>"                +
+
+<prop>         +       "<PROP>"                
+</prop>                +       "</PROP>"               +
+
+<lemma>                +       "<LEMMA>"               
+</lemma>       +       "</LEMMA>"              +
+
+<coroll>       +       "<COROLL>"              
+</coroll>      +       "</COROLL>"             +
+
+<proof>                +       "<PROOF>"               
+</proof>       +       "</PROOF>"              +
+
+<theorem>      +       "<THEOREM>"             
+</theorem>     +       "</THEOREM>"            +
+
+<thtag>                        "<THTAG>"
+</thtag>               "</THTAG>"
+
+% mathematics 
+
+<f>
+</f>
+
+<dm>           +       "<DM>"                  +
+</dm>          +       "</DM>"  +
+
+<eq>           +       "<EQ>"                  +
+</eq>          +       "</EQ>"                 +
+
+<fr>                   "<FR>"
+</fr>                  "</FR>"
+
+<nu>                   "<NU>"
+</nu>                  "</NU>"
+
+<de>                   "<DE>"
+</de>                  "</DE>"
+
+<lim>                  "<LIM>"
+</lim>                 "</LIM>"
+
+<op>                   "<OP>"
+</op>                  "</OP>"
+
+<ll>                   "<LL>"
+</ll>                  "</LL>"
+
+<ul>                   "<UL>"
+</ul>                  "</UL>"
+
+<opd>                  "<OPD>"
+</opd>                 "</OPD>"
+
+<pr>                   "<PR>"
+</pr>                  "</PR>"
+
+<in>                   "<INT>"
+</in>                  "</INT>"
+
+<sum>                  "<SUM>"
+</sum>                 "</SUM>"
+
+<root>                 "<ROOT>"
+</root>                        "</ROOT>"
+
+<ar>                   "<AR>"
+</ar>                  "</AR>"
+
+<arr>                   "<ARR>" 
+</arr>                 
+
+<arc>                   "<ARC>"
+</arc>         
+
+<sup>                  "<SUP>"
+</sup>                 "</SUP>"
+
+<inf>                  "<SUB>"
+</inf>                 "</SUB>"
+
+<unl>                  "<UNL>"
+</unl>                 "</UNL>"
+
+<ovl>                  "<OVL>"
+</ovl>                 "</OVL>"
+
+<rf>                   "<RF>"
+</rf>                  "</RF>"
+
+<v>                    "<V>"
+</v>                   "</V>"
+
+<fi>                   "<FI>"
+</fi>                  "</FI>"
+
+<phr>                  "<PHR>"
+</phr>                 "</PHR>"
+
+<tu>                   "<TU>"
+</tu>
+
+% figures
+
+<figure>       +       "<FIGURE>"                      +
+</figure>      +       "</FIGURE>"                     +
+
+<eps>          +       "<EPS FILE=\"[FILE]\">"  +
+</eps>                 
+               
+<img>          +       "<IMG SRC=\"[SRC]\">"   +
+</img>
+
+<ph>           +       "<PH VSPACE=\"[VSPACE]\">"      +
+</ph>  
+
+<caption>      +       "<CAPTION>"
+</caption>             "</CAPTION>"    +
+
+% tables
+
+<table>                +       "<CENTER><TABLE BORDER><TR><TD>\n"      +
+</table>       +       "</TD></TR></TABLE></CENTER>\n"         +
+
+<tabular>      +       "<BR>\n"                +
+</tabular>     +       "\n"                    +
+
+<rowsep>               "</TD></TR><TR><TD>"            +
+</rowsep>
+
+<colsep>               "</TD><TD>"
+</colsep>
+
+<hline>                +       ""      +
+</hline>
+
+% slides
+
+<slides>       +       "<SLIDES>"      +
+</slides>      +       "</SLIDES>"     +
+
+<slide>                +       "<SLIDE>"       +
+</slide>       +       "</SLIDE>"      +
+
+% letters
+
+
+<letter>       +       "<LETTER OPTS=\"[OPTS]\">"      +
+</letter>      +       "</LETTER>"             +
+
+<telefax>      +       "<TELEFAX OPTS=\"[OPTS]\">"     +
+</telefax>     +       "</TELEFAX>"                    +
+
+<opening>      +       "<OPENING>"
+</opening>             "</OPENING>"            +
+
+
+<from>         +       "<FROM>"                        
+</from>                +       "</FROM>"       +
+
+
+<to>           +       "<TO>"
+
+</to>          +       "</TO>"         +
+
+% first end definition of name
+
+<address>      +       "<ADDRESS>"     +
+</address>     +       "</ADDRESS>"    +
+
+<email>                +       "<EMAIL>"
+</email>               "</EMAIL>"      +
+
+<phone>                +       "<PHONE>"       
+</phone>               "</PHONE>"      +
+
+
+<fax>          +       "<FAX>"
+</fax>                 "</FAX>"        +
+
+<subject>      +       "<SUBJECT>"
+</subject>             "</SUBJECT>"    +
+
+
+<sref>         +       "<SREF>"        
+</sref>                        "</SREF>"       +
+
+<rref>         +       "<RREF>"        
+</rref>                        "</RREF>"       +
+
+<rdate>                +       "<RDATE>"
+</rdate>               "</RDATE>"      +
+
+<closing>      +       "<CLOSING>"     
+</closing>             "</CLOSING>"    +
+
+<cc>           +       "<CC>"
+</cc>                  "</CC>"         +
+
+<encl>         +       "<ENCL>"
+</encl>                        "</ENCL>"       +
+
+<ps>           +       "<PS>"          +
+</ps>          +       "</PS>"         +
+
+% end of html replacement file
diff --git a/doc/sbase/dist/birddoc/latex2e/mapping b/doc/sbase/dist/birddoc/latex2e/mapping
new file mode 100644 (file)
index 0000000..ec533bd
--- /dev/null
@@ -0,0 +1,734 @@
+
+% linuxdoc to latex replacement file
+
+<qwertz>       +     
+</qwertz>      +
+
+<article>      + "\\documentclass\[a4paper\]{article}\n"
+                       "\\usepackage{linuxdoc-sgml}\n"
+                       "\\usepackage{qwertz}\n"
+                       "\\usepackage{url}\n"
+                       "\\usepackage\[latin1\]{inputenc}\n"
+                       "\\usepackage{t1enc}\n"
+                       "\\usepackage{babel}\n"
+                       "\\usepackage{epsfig}\n"
+                       "\\usepackage{[OPTS]}\n"
+                       "\\def\\addbibtoc{\n"
+                       "\\addcontentsline{toc}{section}{\\numberline{\\mbox{}}\\relax\\bibname}\n"
+                       "}%end-preamble\n"      +
+
+</article>     +       "\\end{document}"       +
+
+<report>       + "\\documentclass\[a4paper\]{report}\n"
+                       "\\usepackage{linuxdoc-sgml}\n"
+                       "\\usepackage{qwertz}\n"
+                       "\\usepackage{url}\n"
+                       "\\usepackage\[latin1\]{inputenc}\n"
+                       "\\usepackage{t1enc}\n"
+                       "\\usepackage{babel}\n"
+                       "\\usepackage{epsfig}\n"
+                       "\\usepackage{[OPTS]}\n"
+                       "\\def\\addbibtoc{\n"
+                       "\\addcontentsline{toc}{chapter}{\\numberline{\\mbox{}}\\relax\\bibname}\n"
+                       "}\n"
+                       "\\pagestyle{headings}%end-preamble\n"  +
+
+</report>      +       "\\end{document}"       +
+
+<book> +       "\\documentclass\[a4paper\]{book}\n"
+                       "\\usepackage{linuxdoc-sgml}\n"
+                       "\\usepackage{qwertz}\n"
+                       "\\usepackage{url}\n"
+                       "\\usepackage\[latin1\]{inputenc}\n"
+                       "\\usepackage{t1enc}\n"
+                       "\\usepackage{babel}\n"
+                       "\\usepackage{epsfig}\n"
+                       "\\usepackage{[OPTS]}\n"
+                       "\\def\\addbibtoc{\n"
+                       "\\addcontentsline{toc}{chapter}{\\numberline{\\mbox{}}\\relax\\bibname}\n"
+                       "}\n"
+                       "\\pagestyle{headings}%end-preamble\n"  +
+
+</book>                +       "\\end{document}"       +
+
+
+<notes> +      "\\documentclass\[a4paper\]{article}\n"
+                       "\\usepackage{linuxdoc-sgml}\n"
+                       "\\usepackage{qwertz}\n"
+                       "\\usepackage{url}\n"
+                       "\\usepackage\[latin1\]{inputenc}\n"
+                       "\\usepackage{t1enc}\n"
+                       "\\usepackage{babel}\n"
+                       "\\usepackage{epsfig}\n"
+                       "\\usepackage{[OPTS]}\n"
+                       "\\def\\title#1{\n"
+                       "\\begin{center}\n"     
+                       "\\bf\n"                        
+                       "#1\n"
+                       "\\end{center}\n"
+                       "\\bigskip\n"           
+                       "}\n"
+                       "\\begin{document}%end-preamble\n"      
+
+</notes>       +       "\\end{document}"       +
+
+
+<dina4>        +       ""
+</dina4>
+
+% Manual Pages are expected to be formatted using nroff (or groff), unless
+% they are included  as sections of other qwertz documents.  
+
+<manpage>
+</manpage>
+
+<titlepag>
+</titlepag>    +       "\n\n\\begin{document}\n"
+                       "\\maketitle\n"         +
+
+<title>                +       "\\title{"      
+</title>               "}"             +
+
+<subtitle>             "\\\\\n"
+                       "{\\large "
+</subtitle>            "}" +
+
+<author>       +       "\\author{"     
+</author>              "}"     +
+
+<name>         
+</name>
+
+<and>                  "\\and "        +
+</and>
+
+<thanks>               "\\thanks{"
+</thanks>              "}"
+
+<inst>                 " \\\\\n\\\\"   +
+</inst>
+
+<date>         +       "\\date{"
+</date>                        "}"               +
+
+<newline>              "\\\\ "           
+</newline>
+
+<label>                        "\\label{[ID]}"
+</label>       
+
+<header>       +       "\\markboth"
+</header>      
+
+<lhead>                        "{"
+</lhead>               "}"
+
+<rhead>                        "{"
+</rhead>               "}"     +
+
+% <comment>    +       "\n\n\\begin{verbatim}" +
+% </comment>   +       "\\end{verbatim}\n\n"   +
+
+<comment>              "{\\tt "
+</comment>             "}"
+
+% Hacked by mdw to use linuxdoc-sgml \abstract{...}
+<abstract>     +       "\\abstract{"   
+</abstract>            "}"     +
+
+<appendix>     +       "\n \\appendix \n"      +
+</appendix>
+
+<toc>          +       "\\tableofcontents"     +
+</toc>
+
+<lof>          +       "\\listoffigures"       +
+</lof>
+
+<lot>          +       "\\listoftables"        +
+</lot>
+
+<chapt>                +       "\n\\chapter"
+</chapt>
+
+<sect>         +       "\n\\section"
+</sect>
+
+<sect1>                +       "\n\\subsection"
+</sect1>
+
+<sect2>                +       "\n\\subsubsection"
+</sect2>
+
+<sect3>                +       "\n\\paragraph"
+</sect3>       
+
+<sect4>                +       "\n\\subparagraph"
+</sect4>
+
+<heading>              "{"
+</heading>             "}\n\n" 
+
+<p>            
+</p>                   "\n\n"
+
+<itemize>      +       "\\begin{itemize}"      +
+</itemize>     +       "\\end{itemize}"        +
+
+<enum>         +       "\\begin{enumerate}"    +
+</enum>                +       "\\end{enumerate}"      +
+
+<list>         +       "\\begin{list}{}{}\n"     +
+</list>                +       "\\end{list}"           +
+
+<descrip>      +       "\\begin{description}"  +
+</descrip>     +       "\\end{description}"    +
+
+<item>         +       "\\item "
+</item>
+
+<tag>          +       "\\item\["
+</tag>                 "\] \\mbox{}\n\n"
+
+<cite>                 "\\cite{[ID]"
+</cite>                        "}"
+
+<ncite>                        "\\cite\[[NOTE]\]{[ID]"
+</ncite>               "}"
+
+<idx>                  "\\idx{"
+</idx>                  "}"
+
+<cdx>                  "\\cdx{"
+</cdx>                 "}"
+
+<nidx>                 "\\nidx{"
+</nidx>                  "}"
+
+<ncdx>                 "\\ncdx{"
+</ncdx>                        "}"
+
+% The idea here is to automatically insert soft hyphens after every slash in
+% the filename, so long filenames will break naturally.  The url{} macro is
+% a kluge but it works,
+<file>                 "\\url{"
+</file>                        "}"
+
+<footnote>             "\\footnote{"
+</footnote>            "}"
+
+<sq>                   "``"
+</sq>                  "''"
+
+<lq>           +       "\\begin{quotation}\n"  +
+</lq>          +       "\n\\end{quotation}\n\n"        +
+
+<em>                   "{\\itshape "
+</em>                  "\\/}"
+
+<m>                    "{\\itshape "
+</m>                   "\\/}"
+
+<bf>                   "{\\bfseries "
+</bf>                  "}"
+
+<it>                   "{\\itshape "
+</it>                  "\\/}"
+
+<sf>                   "{\\sffamily "
+</sf>                  "}"
+
+<sl>                   "{\\slshape "
+</sl>                  "}"
+
+<rm>                    "{\\rmfamily "
+</rm>                   "}"
+
+<tt>                   "{\\ttfamily "
+</tt>                  "}"
+
+<cf>                   "{\\ttfamily "
+</cf>                  "}"
+
+% Added by mdw
+<cparam>               "\\cparam{"
+</cparam>              "}"
+
+<ref>                  "\\ref{[ID]} {([NAME])}"
+</ref>
+
+<pageref>              "\\pageref{[ID]}"
+</pageref>
+
+%url added by HG
+<url>                  "\\nameurl{[URL]}{[NAME]}"
+</url>
+
+<htmlurl>              "\\onlynameurl{[NAME]}"
+</htmlurl>
+
+<x>    
+</x>
+
+<mc>                   
+</mc>
+
+<biblio>       +       "\\bibliographystyle{[STYLE]}\n"
+                       "\\bibliography{[FILES]}\n"
+                       "\\addbibtoc{}" +
+</biblio>      
+
+% <macro>              +       "\\macro{[ID]}{\\qw[ID]}"
+% </macro>
+
+% <main>               +       "\\macro{qwmain}{\\qwmain}"
+% </main>
+
+<code>         +       "\\par\n"
+                       "\\addvspace{\\medskipamount}\n"
+                       "\\nopagebreak\\hrule\n"
+                       "\\begin{verbatim}"     +
+
+</code>                +       "\\end{verbatim} \n"
+                       "\\nopagebreak\\hrule \n"
+                       "\\addvspace{\\medskipamount}"  +
+
+<verb>         +       "\\begin{verbatim}"     +
+</verb>                +       "\\end{verbatim}"       +
+
+% tscreen added by mdw
+<tscreen>      +       "\\begin{tscreen}"      +
+</tscreen>     +       "\\end{tscreen}"        +
+
+<quote> +       "\\begin{quotation}"    +
+</quote>        +       "\\end{quotation}"      +
+
+% theorems and such
+
+<def>          +       "\\begin{definition}"
+</def>         +       "\\end{definition}\n\n"         +
+
+<prop>         +       "\\begin{proposition}"  +
+</prop>                +       "\\end{proposition}"    +
+
+<lemma>                +       "\\begin{lemma}"
+</lemma>       +       "\\end{lemma}\n\n"      +
+
+<coroll>       +       "\\begin{corollary}"
+</coroll>      +       "\\end{corollary}\n\n"  +
+
+<proof>                +       "\n{\\noindent{\\bf Proof.}  "  +
+</proof>       +       "}"
+
+<theorem>      +       "\\begin{theorem}"
+</theorem>     +       "\\end{theorem}\n\n"    +
+
+<thtag>                        "\["
+</thtag>               "\]"                    +
+
+% mathematics 
+
+<f>                    "$"
+</f>                   "$"
+
+<dm>           +       "\\\["  
+</dm>                  "\\\]"  +
+
+<eq>           +       "\\begin{equation}"     +
+</eq>          +       "\\end{equation}\n"     +
+
+<fr>                   "\\frac"
+</fr>          
+
+<nu>                   "{"
+</nu>                  "}"
+
+<de>                   "{"
+</de>                  "}"
+
+<lim>                  
+</lim>
+
+<op>
+</op>
+
+<ll>                   "_{"
+</ll>                  "}"
+
+<ul>                   "^{"
+</ul>                  "}"
+
+<opd>
+</opd>
+
+<pr>                   "\\prod"
+</pr>
+
+<in>                   "\\int"
+</in>
+
+<sum>                  "\\sum"
+</sum>         
+
+<root>                 "\\sqrt\[[n]\]{"
+</root>                        "}"
+
+<ar>           +       "\\begin{array}{[ca]}"  +
+</ar>          +       "\\end{array}"          +
+
+<arr>                   " \\\\ " +
+</arr>
+
+<arc>                   " & "
+</arc>
+
+
+<sup>                  "^{"
+</sup>                 "}"
+
+<inf>                  "_{"
+</inf>                 "}"
+
+<unl>                  "\\underline{"
+</unl>                 "}"
+
+<ovl>                  "\\overline{"
+</ovl>                 "}"
+
+<rf>                   "\\mbox{\\tt "
+</rf>                  "}"
+
+<v>                    "\\vec{"
+</v>                   "}"
+
+<fi>                   "{\\cal "
+</fi>                  "}"
+
+<phr>                  "{\\rm "
+</phr>                 "}"
+
+<tu>                   "\\\\ \n"
+</tu>
+
+% figures
+
+<figure>       +       "\\begin{figure}\[[LOC]\]"      +
+</figure>      +       "\\end{figure}\n"               +
+
+<eps>          +       "\\centerline{\\epsfig{file=[FILE],height=[HEIGHT],angle=[ANGLE]}}"  +
+</eps>                 
+               
+
+<ph>           +       "\\vspace{[VSPACE]}\n\\par"     +
+</ph>  
+
+<caption>      +       "\\caption{"
+</caption>             "}"     +
+
+% tables
+
+<table>                +       "\\begin{table}\[[LOC]\]"       +
+</table>       +       "\\end{table}"          +
+
+<tabular>      +       "\\begin{center}\n"
+                       "\\begin{tabular}{[ca]}"        +
+</tabular>     +       "\\end{tabular}\n"
+                       "\\end{center}"         +
+
+<rowsep>               "\\\\ "         +
+</rowsep>
+
+<colsep>               "& "
+</colsep>
+
+<hline>                +       "\\hline"       +
+</hline>
+
+% slides
+
+<slides>    + "\\documentclass\[qwertz,dina4,xlatin1,[OPTS]\]{article}\n"
+                       "\\input{epsf.tex}\n"   
+                       "\\def\\title#1{\n"
+                       "\\begin{center}\n"     
+                       "\\bf\\LARGE\n"                 
+                       "#1\n"
+                       "\\end{center}\n"
+                       "\\bigskip\n"           
+                       "}\n"
+                       "\\begin{document}"             +
+</slides>      +       "\\end{document}"               +
+
+<slide>        
+</slide>       +       "\\newpage"             +
+
+% letters
+
+
+<letter> +  "\\documentstyle\[qwertz,dina4,xlatin1,[OPTS]\]{letter}\n"
+                       "\\input{epsf.tex} \n"
+                       "\\newfont{\\gmd}{gmdlogo} \n"
+                       "\\font\\agb=pagk at 13truept\n"
+                       "\\font\\helv=phvr at 7.4truept\n"
+                       "\\parindent 0pt \n"
+                       "\\parskip 5pt plus 1pt minus 2pt \n"
+                       "\\addtolength{\\oddsidemargin}{-4.0mm} \n"
+                       "\\addtolength{\\evensidemargin}{-4.0mm} \n"
+                       "\\setlength{\\unitlength}{ 1.0mm } \n"
+
+                       % initial values for optional elements in the 
+                       % letter head
+
+                       "\\def\\semail{} \n"
+                       "\\def\\remail{} \n"
+                       "\\def\\sphone{} \n"
+                       "\\def\\rphone{} \n"    
+                       "\\def\\sref{} \n"
+                       "\\def\\rref{} \n"
+                       "\\def\\rdate{} \n"
+                       "\\def\\subj{} \n"
+
+                       % switch for distinguishing between context of
+                       % sender and receiver's address
+
+                       "\\newif\\ifsender \n"
+                       "\\newif\\ifsubj \n"
+                       "\\subjfalse \n"        % assume no subject
+
+                       "\\newif\\ifcc \n"      % for cc field
+                       "\\ccfalse \n"
+
+                       "\\newif\\ifsaddress\n"
+                       "\\saddressfalse\n"
+                       "\\newif\\ifraddress\n"
+                       "\\raddressfalse\n"
+
+                       "\\newif\\iffax\n"
+                       "\\faxfalse\n"
+                       
+"\\def\\letterhead{\n"
+"\\begin{picture}(178,54) \n"
+"\\put(0,50){\\agb GESELLSCHAFT F\\\"{U}R MATHEMATIK UND \n"
+"DATENVERARBEITUNG MBH } \n"
+
+"\\put(147,50){\\gmd g} \n "
+
+"\\put(0,40){\\helv GMD, Postfach 1316, Schlo{\\ss} Birlinghoven,  \n "
+"D-53757 Sankt Augustin 1} \n "
+
+"\\put(97,40){\\parbox\[b\]{10cm} \n"
+"{\\helv\\raggedright \n"
+"\\baselineskip=9pt plus 2pt \n"
+"Telefon (0 22 41) 14-0 \\\\ \n"
+"Telefax (0 22 41) 14 26 18, -28 89}}\n"
+
+"\\put(0,210){\\makebox(0,0)\[bl\]{\\today}} \n "
+
+% letter specific information
+
+% from
+
+% name and e-mail
+
+"\\put(0,44){\\sname\\ \\semail} \n"
+
+% phone
+
+"\\put(128,44){-\\sphone} \n"
+
+% To, name and address
+
+"\\put(0,30){\\parbox\[t\]{9.5cm} \n"
+"{\\rname \\\\\n"
+"\\ifraddress\\raddress\\fi}}\n"
+
+% subject
+
+"\\ifsubj{\\put(0,0){\\subj}}\\fi\n"
+
+% sref
+
+% "\\put(70,15){\\sref} \n"
+
+% rref
+
+% "\\put(0,15){\\rref} \n"
+
+% rdate
+
+% "\\put(32,15){\\rdate} \n"
+
+"\\end{picture} \n"
+"}\n"  % end of letterhead definition
+
+</letter>      +       "\\end{document}"       +
+
+<telefax> +    "\\documentstyle\[[OPTS],qwertz,dina4,xlatin1\]{article}\n"
+                       "\\def\\faxlength{[LENGTH]}\n"
+
+                       % initial values for optional elements in the 
+                       % letter head
+
+                       "\\def\\semail{} \n"
+                       "\\def\\remail{} \n"
+                       "\\def\\sphone{} \n"
+                       "\\def\\rphone{} \n"
+                       "\\def\\rfax{} \n"
+                       "\\def\\sfax{} \n"
+                       "\\def\\subj{} \n"
+
+                       % switch for distinguishing between context of
+                       % sender and receiver's address
+
+                       "\\newif\\ifsender \n"
+                       "\\newif\\ifsubj \n"
+                       "\\subjfalse \n"        % assume no subject
+
+                       "\\newif\\ifcc \n"      % for cc field
+                       "\\ccfalse \n"
+
+                       "\\newif\\ifsaddress\n"
+                       "\\saddressfalse\n"
+                       "\\newif\\ifraddress\n"
+                       "\\raddressfalse\n"
+
+                       "\\newif\\iffax\n"
+                       "\\faxtrue\n"
+                       
+"\\def\\letterhead{\n"
+"\\newfont{\\gmd}{gmdlogo}\n"
+"\\setlength{\\parindent}{0pt}\n"
+
+"\\parbox\[b\]{\\textwidth}{Gesellschaft f\\\"{u}r\n"
+"Mathematik und Datenverarbeitung mbH \\\\\n"
+"Schlo{\\ss} Birlinghoven \\\\\n"
+"D-53757 St.~Augustin \\\\\n"
+"Telefax: +49--2241--142618, "
+"+49--2241--142889}\\makebox\[0pt\]\[r\]{\\gmd e}\n"
+
+"\\begin{center}\n"
+"~ \\\\\n"
+"\\LARGE TELEFAX\n"
+"\\\\ ~\n"
+"\\end{center}\n"
+
+"\\framebox\[\\textwidth\]{\\parbox{0.9\\textwidth}\%\n"
+"{\n"
+"Von/From: \\sname\n"
+"\\\\\n"
+"Datum/Date: \\today\n"
+"}}\n"
+
+"\\framebox\[\\textwidth\]{\\parbox{0.9\\textwidth}\%\n"
+"{\n"
+"An/To: \\rname\n"
+"\\\\\n"
+"Telefax: \\rfax\n"
+"\\\\\n"
+"Firma/Company: \\raddress\n"
+"}}\n"
+
+"\\framebox\[\\textwidth\]{\\parbox{0.9\\textwidth}\%\n"
+"{\n"
+"Anzahl der gesendeten Seiten (inkl. dieses Deckblatts)/ \\\\\n"
+"Number of pages (including this cover sheet): \\faxlength\n"
+"}}\n"
+
+"\\framebox\[\\textwidth\]{\\parbox{0.9\\textwidth}\%\n"
+"{\\setlength{\\parskip}{0.5\\baselineskip}\n"
+"Bemerkungen/Comments: \\\\\n"
+"\\subj\n"
+"\\vspace{60pt}}}\n"
+"}\n"          % end of letterhead definition for fax messages
+
+</telefax>     +       "\\end{document}"       +
+
+<opening>      +       "\\begin{document}\n"
+                       "\\pagestyle{empty}\n"
+                       "\\letterhead\n"
+
+"\\iffax\\newpage\n"
+"\\else{\\ifsubj\\vspace{0.5cm}\\fi}\n"
+"\\fi\n\\par"  +
+
+</opening>     +       "\n\n\\vspace{0.6cm}\n\\par"    +
+
+
+<from>         +       "\\sendertrue\n"
+                       "\\def\\sname{"
+</from>                        "}"     +
+
+
+<to>           +       "\\senderfalse\n"
+                       "\\def\\rname{"
+</to>                  "}"     +
+
+% first end definition of name
+
+<address>              "\\def\\address{"
+</address>             "}\n"
+                       "\\ifsender{\\global\\saddresstrue\n"
+                       "\\global\\def\\saddress{\\address}}\n"
+                       "\\else{\\global\\raddresstrue\n"
+                       "\\global\\def\\raddress{\\address}}\n"
+                       "\\fi"  +
+
+<email>                +       "\\def\\email{"
+</email>               "}\n"
+                       "\\ifsender\\edef\\semail{(\\email)} \n"
+                       "       \\else\\edef\\remail{\\email} \n"
+                       "\\fi"  +
+
+<phone>                +       "\\def\\phone{"
+</phone>               "}\n"
+                       "\\ifsender\\edef\\sphone{\\phone} \n"
+                       "       \\else\\edef\\rphone{\\phone} \n"
+                       "\\fi"  +
+
+
+<fax>          +       "\\def\\fax{"
+</fax>                 "}\n"
+                       "\\ifsender\\edef\\sfax{\\fax} \n"
+                       "\\else{\\global\\edef\\rfax{\\fax}\n"
+                       "\\newwrite\\faxnum\n"
+                       "\\immediate\\openout\\faxnum=.fax=num\n"
+                       "\\immediate\\write\\faxnum{\\rfax}\n"
+                       "\\immediate\\closeout\\faxnum}\n"
+                       "\\fi"   +
+
+<subject>      +       "\\subjtrue\n"
+                       "\\def\\subj{"
+</subject>             "}"     +
+
+
+<sref>         +       "\\newcommand{\\sref}{"
+</sref>                        "}"     +
+
+<rref>         +       "\\newcommand{\\rref}{"
+</rref>                        "}"     +
+
+<rdate>                +       "\\def\\rdate}{"
+</rdate>               "}"     +
+
+<closing>      +       "\\vspace{1cm} \n\\par\n"
+                       "\\parbox\[t\]{\\textwidth} "
+                       "{"
+</closing>     +       "}\\vspace{2cm}\n\\par\n"
+                       "\\sname \n"            
+                       "\\ifcc{\\vspace{0.5cm}\n\\par\n" 
+                       "cc:\\ \\ \\parbox\[t\]{14cm}{\n"
+                       "\\cc}\\fi\n" +
+                       
+<cc>           +       "\\cctrue\n"
+                       "\\def\\cc{"
+</cc>                  "}"     +
+
+<encl>         +       "\\vspace{0.5cm}\n\\par\n" 
+                       "encl:\\ \\ \\parbox\[t\]{14cm}{"
+</encl>                        "}\n\n" +
+
+<ps>           +       "\\vspace{0.5cm}\n\\par"        +       
+</ps>
+
+
+% end of latex replacement file
+
diff --git a/doc/sbase/dtd/linuxdoc.dtd b/doc/sbase/dtd/linuxdoc.dtd
new file mode 100644 (file)
index 0000000..7a7bc73
--- /dev/null
@@ -0,0 +1,642 @@
+<!-- This is a DTD, but will be read as -*- sgml -*-   -->
+<!-- ================================================= -->
+<!-- $Id$ 
+
+This was heavilly modified for use with bird! Don't you dare to use it
+anywhere else. <pavel@ucw.cz>
+
+     This was LINUXDOC.DTD,
+     a hacked version of QWERTZ.DTD v1.3 by Matt Welsh,
+     Greg Hankins, Eric Raymond, Marc Baudoin and
+     Tristan Debeaupuis; modified from QWERTZ.DTD by
+     Tom Gordon.
+
+     $Log$
+     Revision 1.1  2000-05-11 12:00:36  pavel
+     Critical files from linuxdoc1 distribution checked in.
+
+     Revision 1.8  1998/06/26 19:41:11  cg
+     * Add (La)TeX logos. (NJ)
+
+     Revision 1.7  1998/03/22 10:39:08  cg
+     * Corrected "isoent" entity reference in DTD. (CdG)
+
+     Revision 1.6  1998/01/08 19:48:20  cg
+     * Added "invisible" index tags <nidx> and <ncdx>. (SM/CdG)
+
+     Revision 1.5  1997/11/23 21:04:37  cg
+     * Added <file> tag to all DTDs and documented it (ESR)
+
+     * Added <idx> and <cdx> to linuxdoc97 and sgmltool DTDs (ESR)
+
+     * Arrange for <htmlurl> to call \url in the LaTeX back end (ESR)
+
+     Revision 1.4  1997/11/21 22:58:13  cg
+     * Allow [ and ] to be used inside <tag></tag>. (ESR)
+
+     Revision 1.3  1997/11/12 21:47:24  cg
+     * Manually modified the Log entry in linuxdoc96.dtd. It contained SGML
+       comments, and nested comments won't go... (CdG)
+
+     Revision 1.2  1997/11/11 20:50:22  cg
+     * First pass at conditionals.  This version is implemented with magic comments
+       <!- if -> and <!- unless ->. (ESR)
+
+     * The generic options processing now includes the -D option to pass in an
+       attribute/value pair for conditionals.  This meant the -D option in
+       sgml2html had to be changed, it's now -h. (ESR)
+
+     Revision 1.1  1997/07/09 13:27:19  cg
+     * Completely new DTD setup by Bernd (BK).
+
+
+                                                       -->
+<!-- ================================================= -->
+<!-- Revision Comments                                 -->
+
+<!-- ESR/97/11/17: Added file tag.                     -->
+<!-- ESR/97/11/11: Removed the crude and undocumented
+     conditionalization features in this DTD.  They
+     weren't in the original linuxdoc 1.3 DTD, and are
+     superseded by the new if/unless facility.         -->
+<!-- BK/97/05/09: this is the original Linuxdoc DTD,
+     as of SGML Tools 0.99.0. It is not longer 
+     supported. Use only if in dire need, for backwards
+     compabitlity. Backend support for undocumented
+     QWERTZ leftovers not in the strict Linuxdoc DTD's
+     is not guaranteed.                                -->
+<!-- BK/97/06/06: finally applied changes proposed by
+     Ken MacLeod to dtd/catalog (PUBLIC). Removed
+     the duplicated linuxdoc96 element name.           -->
+<!-- BK/97/06/22: replaced entire content with DTD
+     from 0.99.12 release - I am not going to maintain
+     any changes to this, just replacing.              -->
+<!-- ================================================= -->
+
+<!entity % emph 
+       " em|it|bf|sf|sl|tt|cf|m|cparam " >
+
+<!entity % index "idx|cdx|nidx|ncdx" >
+
+<!-- url added by HG; htmlurl added by esr -->
+<!entity % xref
+       " label|ref|pageref|cite|url|htmlurl|ncite " >
+
+<!entity % inline 
+       " (#pcdata | f| x| %emph; |sq| %xref | %index | file )* " >
+
+<!entity % list 
+        " list | itemize | enum | descrip " >
+
+<!entity % par         
+       "  %list; | comment | lq | quote | tscreen " >
+
+<!entity % mathpar " dm | eq " >
+
+<!entity % thrm 
+        " def | prop | lemma | coroll | proof | theorem " >
+
+<!entity % litprog " code | verb " >
+
+<!entity % sectpar 
+        " %par; | figure | tabular | table | %mathpar; | 
+         %thrm; | %litprog; ">
+<!element linuxdoc o o 
+        (sect | chapt | article | report | 
+        book | letter | telefax | slides | notes | manpage ) >
+
+<!-- `general' entity replaced with ISO entities - kwm -->
+<!entity % isoent system "isoent">
+%isoent;
+
+<!entity urlnam sdata "urlnam" >
+<!entity refnam sdata "refnam" >
+<!entity tex   sdata "[tex   ]" >
+<!entity latex sdata "[latex ]" >
+<!entity latexe        sdata "[latexe]" >
+<!entity tm     sdata "[trade ]" >
+<!entity dquot  sdata "[quot  ]" >
+<!entity ero    sdata "[amp   ]" >
+<!entity etago '</' >
+<!entity   Ae  '&Auml;' >
+<!entity   ae  '&auml;' >
+<!entity   Oe  '&Ouml;' >
+<!entity   oe  '&ouml;' >
+<!entity   Ue  '&Uuml;' >
+<!entity   ue  '&uuml;' >
+<!entity   sz  '&szlig;' >
+<!element  p o o (( %inline | %sectpar )+) +(newline) >
+<!entity ptag '<p>' >
+<!entity psplit '</p><p>' >
+
+<!shortref pmap
+       "&#RS;B" null 
+       "&#RS;B&#RE;" psplit
+       "&#RS;&#RE;" psplit
+--     '"' qtag  --
+       "[" lsqb
+       "~" nbsp
+       "_" lowbar
+       "#" num
+       "%" percnt
+       "^" circ
+       "{" lcub
+       "}" rcub
+       "|" verbar >
+
+<!usemap pmap p>
+<!element em - - (%inline)>
+<!element bf - - (%inline)>
+<!element it - - (%inline)>
+<!element sf - - (%inline)>
+<!element sl - - (%inline)>
+<!element tt - - (%inline)>
+<!element cf - - (%inline)>
+<!element m - - (%inline)>
+<!element sq - - (%inline)>
+<!element cparam - - (%inline)>
+
+<!entity   ftag     '<f>'    -- formula begin -- >
+<!entity   qendtag  '</sq>'>
+
+<!shortref sqmap 
+      "&#RS;B" null
+--      '"' qendtag  --
+      "[" lsqb
+      "~" nbsp
+      "_" lowbar
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar >
+
+<!usemap   sqmap    sq >
+
+<!element lq - - (p*)>
+<!element quote - - ((%inline; | %sectpar;)*, p*)+ >
+<!element tscreen - - ((%inline; | %sectpar;)*, p*)+ >
+<!element itemize - - (item+)>
+<!element enum - - (item+)>
+<!element list - - (item+)>
+
+<!-- What a mess. The following is here to clean up problems with
+     paragraph breaks in a descrip. I can think of cases where this might
+     break, but it seems to work. mdw -->
+
+<!shortref desmap
+        "&#RS;B" null
+        "&#RS;B&#RE;" ptag
+        "&#RS;&#RE;" ptag
+        "~" nbsp
+        "_" lowbar
+        "#" num
+        "%" percnt
+        "^" circ
+        "[" lsqb
+        "]" rsqb
+        "{" lcub
+        "}" rcub
+        "|" verbar >
+
+<!element descrip - - (tag?, p+)+ >
+<!usemap desmap descrip>
+
+<!element item o o ((%inline; | %sectpar;)*, p*) >
+
+<!element tag - o (%inline)>
+<!usemap desmap tag>
+
+<!usemap global (list,itemize,enum)>
+<!entity space " ">
+<!entity null "">
+
+<!--
+<!shortref bodymap
+     "&#RS;B&#RE;" ptag
+     "&#RS;&#RE;" ptag
+      '"' qtag 
+      "[" lsqb
+      "~" nbsp
+      "_" lowbar
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+-->
+
+<!element figure - - ((eps | ph ), img*, caption?)>
+<!attlist figure
+       loc cdata "tbp"
+       caption cdata "Caption">
+
+<!-- eps attributes added by mb and td  -->
+<!element eps - o empty  >
+<!attlist eps
+        file cdata #required
+        height cdata "5cm"
+        angle cdata "0">
+
+<!element ph - o empty >
+<!attlist ph
+        vspace cdata #required>
+
+<!element img - o empty>
+<!attlist img
+       src cdata #required>
+
+<!element caption - o (%inline)>
+
+<!shortref oneline
+     "B&#RE;" space
+     "&#RS;&#RE;" null 
+     "&#RS;B&#RE;" null
+--      '"' qtag  --
+      "[" ftag
+      "~" nbsp
+      "_" lowbar
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+
+<!usemap oneline tag>
+<!usemap oneline caption>
+
+<!entity % tabrow "(%inline, (colsep, %inline)*)" >
+<!element tabular - - 
+       (hline?, %tabrow, (rowsep, hline?, %tabrow)*, caption?) >
+
+<!attlist tabular
+       ca cdata #required>
+
+<!element rowsep - o empty>
+<!element colsep - o empty>
+<!element hline  - o empty>
+
+<!entity rowsep "<rowsep>">
+<!entity colsep "<colsep>">
+
+<!shortref tabmap
+     "&#RE;" null
+     "&#RS;&#RE;" null
+     "&#RS;B&#RE;" null
+     "&#RS;B" null
+      "B&#RE;" null
+      "BB"  space
+      "@" rowsep
+      "|" colsep 
+      "[" ftag
+--      '"' qtag --
+      "_" thinsp
+      "~" nbsp
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub >
+
+<!usemap  tabmap tabular>
+<!element table   - - (tabular, caption?) >
+<!attlist table
+       loc cdata "tbp">
+
+<!element code - - rcdata>
+<!element verb - - rcdata>
+
+<!shortref ttmap     -- also on one-line --
+        "B&#RE;" space
+        "&#RS;&#RE;" null 
+        "&#RS;B&#RE;" null
+       "&#RS;B" null
+        '#'     num
+        '%'     percnt
+        '~'     tilde
+        '_'     lowbar
+        '^'     circ
+        '{'     lcub
+        '}'     rcub
+        '|'     verbar >
+
+<!usemap ttmap  tt>
+<!element  mc  - - cdata >
+<!entity % sppos     "tu" >
+<!entity % fcs       "%sppos;|phr" >
+<!entity % fcstxt    "#pcdata|mc|%fcs;" >
+<!entity % fscs      "rf|v|fi" >
+<!entity % limits    "pr|in|sum" >
+<!entity % fbu       "fr|lim|ar|root" >
+<!entity % fph       "unl|ovl|sup|inf" >
+<!entity % fbutxt    "(%fbu;) | (%limits;) | 
+                      (%fcstxt;)|(%fscs;)|(%fph;)" >
+<!entity % fphtxt    "p|#pcdata" >
+<!element  f        - - ((%fbutxt;)*) >
+
+<!entity   fendtag  '</f>'   -- formula end -- >
+
+<!shortref fmap 
+      "&#RS;B" null
+      "&#RS;B&#RE;" null
+      "&#RS;&#RE;" null
+      "_" thinsp
+      "~" nbsp
+      "]" rsqb
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+
+<!usemap   fmap     f >
+
+<!element  dm       - - ((%fbutxt;)*)>
+<!element  eq       - - ((%fbutxt;)*)>
+
+<!shortref dmmap
+     "&#RE;" space
+      "_" thinsp
+      "~" nbsp
+      "]" rsqb
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+
+<!usemap dmmap (dm,eq)>
+<!element  fr       - - (nu,de) >
+<!element  nu       o o ((%fbutxt;)*) >
+<!element  de       o o ((%fbutxt;)*) >
+<!element  ll       o o ((%fbutxt;)*) >
+<!element  ul       o o ((%fbutxt;)*) >
+<!element  opd      - o ((%fbutxt;)*) >
+<!element  pr       - - (ll,ul,opd?) >
+<!element  in       - - (ll,ul,opd?) >
+<!element  sum      - - (ll,ul,opd?) >
+<!element  lim      - - (op,ll,ul,opd?) >
+<!element  op       o o (%fcstxt;|rf|%fph;) -(tu) >
+<!element  root     - - ((%fbutxt;)*) >
+<!attlist  root
+        n cdata "">
+<!element col o o ((%fbutxt;)*) >
+<!element row o o (col, (arc, col)*) >
+
+<!element  ar       - - (row, (arr, row)*) >
+<!attlist  ar
+    ca     cdata    #required >
+<!element  arr      - o empty >
+<!element  arc      - o empty >
+<!entity   arr "<arr>" >
+<!entity   arc "<arc>" >
+
+<!shortref arrmap
+     "&#RE;" space
+      "@" arr
+      "|" arc 
+      "_" thinsp
+      "~" nbsp
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub >
+
+<!usemap   arrmap   ar >
+<!element  sup      - - ((%fbutxt;)*) -(tu) >
+<!element  inf      - - ((%fbutxt;)*) -(tu) >
+<!element  unl - - ((%fbutxt;)*) >
+<!element  ovl - - ((%fbutxt;)*) >
+<!element  rf  - o (#pcdata) >
+<!element  phr - o ((%fphtxt;)*) >
+<!element  v   - o ((%fcstxt;)*) 
+       -(tu|%limits;|%fbu;|%fph;) >
+<!element  fi  - o (#pcdata) >
+<!element  tu  - o empty >
+
+<!usemap global (rf,phr)>
+<!element def - - (thtag?, p+) >
+<!element prop - - (thtag?, p+) >
+<!element lemma - - (thtag?, p+) >
+<!element coroll - - (thtag?, p+) >
+<!element proof - - (p+) >
+<!element theorem - - (thtag?, p+) >
+<!element thtag - - (%inline)>
+
+<!usemap global (def,prop,lemma,coroll,proof,theorem)>
+<!usemap oneline thtag>
+<!entity   qtag     '<sq>' >
+
+<!shortref global
+      "&#RS;B" null  -- delete leading blanks --
+  --    '"' qtag -- 
+      "[" ftag
+      "~" nbsp
+      "_" lowbar
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+
+<!usemap global linuxdoc>
+<!element label - o empty>
+<!attlist label id cdata #required>
+
+<!-- ref modified to have an optional name field HG -->
+<!element ref - o empty>
+<!attlist ref   
+        id cdata #required
+        name cdata "&refnam">
+
+<!-- url entity added to have direct url references HG -->
+<!element url - o empty>
+<!attlist url   
+        url cdata #required
+        name cdata "&urlnam" >
+
+<!-- htmlurl entity added to have quieter url references esr -->
+<!element htmlurl - o empty>
+<!attlist htmlurl   
+        url cdata #required
+        name cdata "&urlnam" >
+
+<!element pageref - o empty>
+<!attlist pageref
+        id cdata #required>
+<!element comment - - (%inline)>
+<!element x - - ((#pcdata | mc)*) >
+<!usemap   #empty   x >
+
+<!-- Hacked by mdw to exclude abstract; abstract now part of titlepag -->
+<!element article - -
+        (titlepag, header?, 
+         toc?, lof?, lot?, p*, sect*, 
+         (appendix, sect+)?, biblio?) +(footnote)>
+
+<!attlist article
+        opts cdata "null">
+
+<!-- Hacked by mdw to exclude abstract; abstract now part of titlepag -->
+<!element report - - 
+        (titlepag, header?, toc?, lof?, lot?, p*,
+         chapt*, (appendix, chapt+)?, biblio?) +(footnote)>
+
+<!attlist report
+        opts cdata "null">
+<!element book  - - 
+        (titlepag, header?, toc?, lof?, lot?, p*, chapt*, 
+         (appendix, chapt+)?, biblio?) +(footnote) >
+
+<!attlist book
+        opts cdata "null">
+
+<!-- Hacked by mdw, abstract now part of titlepag -->
+<!element titlepag o o (title, author, date?, abstract?)>
+<!element title - o (%inline, subtitle?) +(newline)>
+<!element subtitle - o (%inline)>
+<!usemap oneline titlepag>
+<!element author - o (name, thanks?, inst?, 
+                        (and, name, thanks?, inst?)*)>
+<!element name o o (%inline) +(newline)>
+<!element and - o empty>
+<!element thanks - o (%inline)>
+<!element inst - o (%inline) +(newline)>
+<!element date - o (#pcdata) >
+
+<!usemap global thanks>
+<!element newline - o empty >
+<!entity nl "<newline>"> 
+
+<!-- Hacked by mdw -->
+<!element abstract - o (%inline)>
+<!usemap oneline abstract>
+
+
+<!element toc - o empty>
+<!element lof - o empty>
+<!element lot - o empty>
+<!element header - - (lhead, rhead) >
+<!element lhead - o (%inline)>
+<!element rhead - o (%inline)>
+<!entity % sect "heading, header?, p* " >
+<!element heading o o (%inline)>
+<!element chapt - o (%sect, sect*) +(footnote)> 
+<!element sect  - o (%sect, sect1*) +(footnote)>
+<!element sect1 - o (%sect, sect2*)>
+<!element sect2 - o (%sect, sect3*)>
+<!element sect3 - o (%sect, sect4*)>
+<!element sect4 - o (%sect)>
+<!usemap oneline (chapt,sect,sect1,sect2,sect3,sect4)>
+<!element appendix - o empty >
+<!element footnote - - (%inline)>
+<!usemap global footnote>
+<!element cite - o empty>
+<!attlist cite 
+        id cdata #required>
+
+<!element ncite - o empty>
+<!attlist ncite 
+        id cdata #required
+       note cdata #required>
+
+<!element file - - (#pcdata)>
+
+<!element idx - - (#pcdata)>
+<!element cdx - - (#pcdata)>
+<!element nidx - - (#pcdata)>
+<!element ncdx - - (#pcdata)>
+
+<!element biblio - o empty>
+<!attlist biblio
+       style cdata "linuxdoc"
+        files cdata "">
+<!element slides - - (slide*) >
+
+<!attlist slides
+       opts cdata "null">
+<!element slide - o (title?, p+) >
+<!entity  % addr "(address?, email?, phone?, fax?)" >  
+       
+<!element letter - - 
+       (from, %addr, to, %addr, cc?, subject?, sref?, rref?,
+         rdate?, opening, p+, closing, encl?, ps?)>
+
+<!attlist letter
+       opts cdata "null">
+       
+<!element from         - o (#pcdata) >
+<!element to           - o (#pcdata) >
+       
+<!usemap oneline (from,to)>
+       
+<!element address      - o (#pcdata) +(newline) >
+<!element email                - o (#pcdata) >
+<!element phone                - o (#pcdata) >
+<!element fax          - o (#pcdata) >
+       
+<!element subject      - o (%inline;) >
+<!element sref         - o (#pcdata) >
+<!element rref          - o (#pcdata) >
+<!element rdate         - o (#pcdata) >
+       
+<!element opening      - o (%inline;) >
+<!usemap oneline opening>
+       
+<!element closing - o (%inline;) >
+<!element cc - o (%inline;) +(newline) >
+<!element encl - o (%inline;) +(newline) >
+       
+<!element ps - o (p+) >
+
+<!element telefax - - 
+       (from, %addr, to, address, email?, 
+         phone?, fax, cc?, subject?,
+         opening, p+, closing, ps?)>
+
+<!attlist telefax
+       opts cdata "null"
+       length cdata "2">
+
+<!element notes - - (title?, p+) >
+<!attlist notes
+       opts cdata "null" >
+<!element manpage - - (sect1*) 
+       -(sect2 | f | %mathpar | figure | tabular | 
+          table | %xref | %thrm )>
+
+
+<!attlist manpage
+       opts cdata "null"
+       title cdata ""
+       sectnum cdata "1" >
+<!shortref manpage
+      "&#RS;B" null
+--      '"' qtag  --
+      "[" ftag
+      "~" nbsp
+      "_" lowbar
+      "#" num
+      "%" percnt
+      "^" circ
+      "{" lcub
+      "}" rcub
+      "|" verbar>
+
+<!usemap manpage  manpage >
+
+<!-- ================================================= -->
+<!-- end of LINUXDOC DTD                               -->
+<!--
+     Local Variables:
+     mode: sgml
+     End:                                              -->                 
+<!-- ================================================= -->
diff --git a/doc/sgml2html b/doc/sgml2html
new file mode 100755 (executable)
index 0000000..3f7b682
--- /dev/null
@@ -0,0 +1,44 @@
+#!/usr/bin/perl 
+#
+#   sgmltools.in
+#
+#   $Id$
+#
+#   SGML-Tools driver. Calls all other SGML-Tools components, contains
+#   configuration information, etcetera.
+#
+package main;
+
+sub BEGIN 
+{
+  require 5.004;
+}
+use strict;
+
+use vars qw($prefix $LibDir $BinDir $progs);
+
+$prefix = "/usr";
+$LibDir = "sbase";
+$BinDir = "/usr/bin";
+
+use lib "/usr/lib/sgml-tools";
+use lib "/usr/perl5";
+use lib "/usr/lib/perl5";
+$progs = {
+  "NSGMLS" => "/usr/bin/nsgmls",
+  "SGMLSASP" => "/usr/bin/sgmlsasp",
+  "GROFF" => "/usr/bin/groff",
+  "GROFFMACRO" => "-mgs"
+};
+
+require SGMLTools;
+&SGMLTools::init;
+
+my @FileList = SGMLTools::process_options ($0, @ARGV);
+for my $curfile (@FileList)
+  {
+    SGMLTools::process_file ($curfile);
+  }
+
+exit 0;
+
diff --git a/doc/sgml2latex b/doc/sgml2latex
new file mode 100755 (executable)
index 0000000..3f7b682
--- /dev/null
@@ -0,0 +1,44 @@
+#!/usr/bin/perl 
+#
+#   sgmltools.in
+#
+#   $Id$
+#
+#   SGML-Tools driver. Calls all other SGML-Tools components, contains
+#   configuration information, etcetera.
+#
+package main;
+
+sub BEGIN 
+{
+  require 5.004;
+}
+use strict;
+
+use vars qw($prefix $LibDir $BinDir $progs);
+
+$prefix = "/usr";
+$LibDir = "sbase";
+$BinDir = "/usr/bin";
+
+use lib "/usr/lib/sgml-tools";
+use lib "/usr/perl5";
+use lib "/usr/lib/perl5";
+$progs = {
+  "NSGMLS" => "/usr/bin/nsgmls",
+  "SGMLSASP" => "/usr/bin/sgmlsasp",
+  "GROFF" => "/usr/bin/groff",
+  "GROFFMACRO" => "-mgs"
+};
+
+require SGMLTools;
+&SGMLTools::init;
+
+my @FileList = SGMLTools::process_options ($0, @ARGV);
+for my $curfile (@FileList)
+  {
+    SGMLTools::process_file ($curfile);
+  }
+
+exit 0;
+