From 6e06e6eef098859da95ff56a8ee9b4c75467901a Mon Sep 17 00:00:00 2001
From: Pavel Machek <pavel@ucw.cz>
Date: Thu, 11 May 2000 12:00:35 +0000
Subject: [PATCH] Critical files from linuxdoc1 distribution checked in.

---
 doc/sbase/dist/birddoc/html/mapping    | 422 ++++++++++++++
 doc/sbase/dist/birddoc/latex2e/mapping | 734 +++++++++++++++++++++++++
 doc/sbase/dtd/linuxdoc.dtd             | 642 +++++++++++++++++++++
 doc/sgml2html                          |  44 ++
 doc/sgml2latex                         |  44 ++
 5 files changed, 1886 insertions(+)
 create mode 100644 doc/sbase/dist/birddoc/html/mapping
 create mode 100644 doc/sbase/dist/birddoc/latex2e/mapping
 create mode 100644 doc/sbase/dtd/linuxdoc.dtd
 create mode 100755 doc/sgml2html
 create mode 100755 doc/sgml2latex

diff --git a/doc/sbase/dist/birddoc/html/mapping b/doc/sbase/dist/birddoc/html/mapping
new file mode 100644
index 00000000..834fe0fe
--- /dev/null
+++ b/doc/sbase/dist/birddoc/html/mapping
@@ -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
index 00000000..ec533bd4
--- /dev/null
+++ b/doc/sbase/dist/birddoc/latex2e/mapping
@@ -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
index 00000000..7a7bc73a
--- /dev/null
+++ b/doc/sbase/dtd/linuxdoc.dtd
@@ -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
index 00000000..3f7b6826
--- /dev/null
+++ b/doc/sgml2html
@@ -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
index 00000000..3f7b6826
--- /dev/null
+++ b/doc/sgml2latex
@@ -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;
+