44 lines
2.1 KiB
HTML
44 lines
2.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
<HTML>
|
|
<HEAD>
|
|
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21">
|
|
<TITLE>: Getting/Using the LinuxDoc Software</TITLE>
|
|
<LINK HREF="Howtos-with-LinuxDoc-7.html" REL=next>
|
|
<LINK HREF="Howtos-with-LinuxDoc-5.html" REL=previous>
|
|
<LINK HREF="Howtos-with-LinuxDoc.html#toc6" REL=contents>
|
|
</HEAD>
|
|
<BODY>
|
|
<A HREF="Howtos-with-LinuxDoc-7.html">Next</A>
|
|
<A HREF="Howtos-with-LinuxDoc-5.html">Previous</A>
|
|
<A HREF="Howtos-with-LinuxDoc.html#toc6">Contents</A>
|
|
<HR>
|
|
<H2><A NAME="s6">6.</A> <A HREF="Howtos-with-LinuxDoc.html#toc6">Getting/Using the LinuxDoc Software</A></H2>
|
|
|
|
<P> You could write a LinuxDoc document without having any LinuxDoc
|
|
software. However, it's likely that it would contain some errors in
|
|
the tags (or their use) so that it would be returned to you for
|
|
correction. Even if there were no errors, the results might not
|
|
not look quite right. So it's best for you to have the software to
|
|
convert your source code on your computer.</P>
|
|
<P>The Debian distribution of Linux has a linuxdoc-tools package. There
|
|
is also a rpm package for non-Debian distributions. It was formerly
|
|
called sgml-tools. Don't use the sgmltools-2 package which is
|
|
primarily for DocBook-sgml. </P>
|
|
<P>To use linuxdoc-tools you run converter programs on the *.sgml files.
|
|
For example for versions after 0.9.21-0.8 to get text output, type:
|
|
"sgml2txt -f --blanks=1 my-HOWTO.sgml". For earlier versions due to a
|
|
bug you must substitute --pass="-P-cbou" for -f. (If interested, see
|
|
<A HREF="Howtos-with-LinuxDoc-11.html#esc_seqs">Old Problem of Escape Sequences in Text Output</A> for more info on this bug.) To get html output,type:
|
|
"sgml2html my-HOWTO.sgml". If it shows errors, it will show the line
|
|
number and the column number where the error is in the source file.
|
|
Typing "man -k sgml" should show you a number of other programs with a
|
|
one-line description of each but not all of them are for
|
|
linuxdoc-sgml.</P>
|
|
|
|
<HR>
|
|
<A HREF="Howtos-with-LinuxDoc-7.html">Next</A>
|
|
<A HREF="Howtos-with-LinuxDoc-5.html">Previous</A>
|
|
<A HREF="Howtos-with-LinuxDoc.html#toc6">Contents</A>
|
|
</BODY>
|
|
</HTML>
|