/usr/share/doc/linuxdoc-tools/html/guide-2.html is in linuxdoc-tools 0.9.71-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.71">
<TITLE>LinuxDoc-Tools User's Guide: Installation</TITLE>
<LINK HREF="guide-3.html" REL=next>
<LINK HREF="guide-1.html" REL=previous>
<LINK HREF="guide.html#toc2" REL=contents>
</HEAD>
<BODY>
<A HREF="guide-3.html"><IMG SRC="next.png" ALT="Next"></A>
<A HREF="guide-1.html"><IMG SRC="prev.png" ALT="Previous"></A>
<A HREF="guide.html#toc2"><IMG SRC="toc.png" ALT="Contents"></A>
<HR>
<H2><A NAME="s2">2.</A> <A HREF="guide.html#toc2">Installation</A></H2>
<H2><A NAME="ss2.1">2.1</A> <A HREF="guide.html#toc2.1">Where to get the source archive</A>
</H2>
<P>You can get the source archive of the linuxdoc-tools from:
<UL>
<LI>
<A HREF="http://www.debian.org/~sano/linuxdoc-tools/">http://www.debian.org/~sano/linuxdoc-tools/</A></LI>
</UL>
The name of the archive may be <CODE>linuxdoc-tools_x.y.z.tar.gz</CODE> or
<CODE>linuxdoc-tools_x.y.z-rel.tar.gz</CODE> or <CODE>linuxdoc-tools_x.y.z.orig.tar.gz</CODE>.
These have the equivalent contents. You can use anyone.</P>
<H2><A NAME="ss2.2">2.2</A> <A HREF="guide.html#toc2.2">What LinuxDoc-Tools Needs</A>
</H2>
<P>LinuxDoc-Tools depends on the usage of sgml parser from Jade or OpenJade
(nsgmls or onsgmls). You have to install either of them to use this.</P>
<P>The source archive of the linuxdoc-tools contains the tools and data
that you need to write SGML documents and convert them to groff, LaTeX,
PostScript, HTML, GNU info, LyX, and RTF. In addition to this package,
you will need some additional tools for generating formatted output.
<OL>
<LI><CODE>groff</CODE>. You <EM>need</EM> version 1.08 or greater.
You can get this from
<A HREF="ftp://prep.ai.mit.edu/pub/gnu">ftp://prep.ai.mit.edu/pub/gnu</A>.
There is a Linux binary
version at
<A HREF="ftp://sunsite.unc.edu/pub/Linux/utils/text">ftp://sunsite.unc.edu/pub/Linux/utils/text</A> as well. You
will need <CODE>groff</CODE> to produce plain text from your SGML documents.
<CODE>nroff</CODE> will <EM>not</EM> work!
You can find the version of your <CODE>groff</CODE> from <CODE>groff -v < /dev/null</CODE>.
</LI>
<LI>TeX and LaTeX. This is available more or less everywhere; you should
have no problem getting it and installing it (there is a Linux binary
distribution on <CODE>sunsite.unc.edu</CODE>). Of course, you only need TeX/LaTeX
if you want to format your SGML documents with LaTeX. So, installing
TeX/LaTeX is optional. If you need PDF output, then you need pdfLaTeX also.
</LI>
<LI><CODE>flex</CODE>. <CODE>lex</CODE> will probably not work. You can get flex from
<CODE>
<A HREF="ftp://prep.ai.mit.edu/pub/gnu">ftp://prep.ai.mit.edu/pub/gnu</A></CODE>.
</LI>
<LI><CODE>gawk</CODE> and the GNU info tools, for formatting and viewing
info files. These are also available on
<CODE>
<A HREF="ftp://prep.ai.mit.edu/pub/gnu">ftp://prep.ai.mit.edu/pub/gnu</A></CODE>, or on
<CODE>
<A HREF="ftp://sunsite.unc.edu/pub/Linux/utils/text">ftp://sunsite.unc.edu/pub/Linux/utils/text</A></CODE>
(for <CODE>gawk</CODE>) and
<CODE>
<A HREF="ftp://sunsite.unc.edu/pub/Linux/system/Manual-pagers">ftp://sunsite.unc.edu/pub/Linux/system/Manual-pagers</A></CODE>
(for GNU info tools). <CODE>awk</CODE> will not work.
</LI>
<LI>LyX (a quasi-WYSIWYG interface to LaTeX, with SGML layouts), is
available on
<A HREF="ftp://ftp.via.ecp.fr">ftp://ftp.via.ecp.fr</A>.</LI>
</OL>
</P>
<H2><A NAME="ss2.3">2.3</A> <A HREF="guide.html#toc2.3">Installing The Software</A>
</H2>
<P>The steps needed to install and configure the LinuxDoc-Tools are:</P>
<P>
<OL>
<LI>First, unpack the tar file of the source archive somewhere.
This will create the directory <CODE>linuxdoc-tools-x.y.z</CODE>.
It doesn't matter where you unpack this file; just don't move things
around within the extracted source tree.
</LI>
<LI>Read the <CODE>INSTALL</CODE> file - it has detailed installation instructions.
Follow them. If all went well, you should be ready to use the system
immediately once you have done so.</LI>
</OL>
</P>
<HR>
<A HREF="guide-3.html"><IMG SRC="next.png" ALT="Next"></A>
<A HREF="guide-1.html"><IMG SRC="prev.png" ALT="Previous"></A>
<A HREF="guide.html#toc2"><IMG SRC="toc.png" ALT="Contents"></A>
</BODY>
</HTML>
|