unroff/INSTALL

91 lines
3.5 KiB
Plaintext

Installation Guide for the `unroff' Source Distribution
-------------------------------------------------------
Requirements: you need Elk 2.2 or Elk 3.0 and an ANSI C compiler
to install unroff from the source distribution. If you don't have
Elk and don't want to install it, you may want to obtain the binary
unroff distribution instead.
You can obtain Elk 3.0 in the World Wide Web at
http://www.informatik.uni-bremen.de/~net/elk
and from a number of FTP servers including these:
ftp://ftp.x.org/contrib/devel_tools/elk-3.0.tar.gz
ftp://ftp.uni-bremen.de/pub/programming/languages/scheme/elk/elk-3.0.tar.gz
o If you are still using Elk 2.2, you may have to apply a small patch to
your Elk installation. The patch is in the file src/elk-2.2-patch.
Assuming you have unpacked unroff under /usr/local/src/unroff-1.0,
change to the directory where the Elk "src" directory is located and call:
patch < /usr/local/src/unroff-1.0/src/elk-2.2-patch
If the patch program detects a `Reverse patch', the patch is not
required and you are done. If the patch succeeded, recompile the
interpreter by calling "make" and "make install" in the directory "src".
o Go to the sub-directory "src" below the directory where you unpacked
unroff:
cd /usr/local/src/unroff-1.0/src
and edit the Makefile. Check the site and compiler dependencies at the
beginning of the Makefile and modify them if necessary.
(Don't worry about DIR= if you just want to test unroff; you can
override the directory later by setting the environment variable
UNROFF_DIR before calling unroff.)
o Call "make depend" and then "make".
o Test unroff and the HTML back-end included in the distribution.
For example, change to the directory "doc" and run "make" to convert
the manual pages and the Programmer's Manual to HTML. Then view the
resulting .html files with your favorite WWW browser.
Test the supplementary -ms features by calling (still in "doc"):
unroff -ms document=test split=1 hyper.scm manual.ms
This creates several files beginning with "test". Load test.html
into your WWW browser; observe the automatically generated table of
contents and the hypertext links embedded in the document. When
finished, you may want to "rm test*".
You can proceed by using unroff with a few troff documents of your
own. For example, try to convert a large manual page:
unroff -man /usr/man/man1/csh.1
Don't worry if this displays numerous warning messages. unroff
usually produces good results even if many low-level troff requests
are ignored. Check csh.1.html with your WWW browser.
o Read the documentation located in the directory "doc", in particular
the manual pages.
You can convert the troff files to HTML and view them with your
WWW browser (as explained in the previous step), or typeset them
using your local troff and send the output to the printer, or read
them online using nroff or man.
o You may want to place a number of default settings into an initialization
file ".unroff" in your home directory. There is a sample init file
"sample.unroff" in the directory "misc". If you decide to use this
file, replace the string "net@cs.tu-berlin.de" by your e-mail address.
o If you find unroff useful, you may want to install it in a central
directory at your site. If so, install the executable, the contents
of the directory "scm", and the manual pages.
If you have any questions, problems, or suggestions send a message to
net@cs.tu-berlin.de.
# $Revision: 1.6 $