Date: Sun, 20 Aug 2000 14:00:41 +0000 From: Nik Clayton <nik@freebsd.org> To: jlm@welearn.com.au Cc: freebsd-doc@freebsd.org Subject: Re: setting up to produce documentation Message-ID: <20000820140040.B2217@kilt.nothing-going-on.org> In-Reply-To: <20000819185408.A88564@phoenix.welearn.com.au>; from jon@welearn.com.au on Sat, Aug 19, 2000 at 06:54:10PM %2B1000 References: <20000819185408.A88564@phoenix.welearn.com.au>
next in thread | previous in thread | raw e-mail | index | archive | help
On Sat, Aug 19, 2000 at 06:54:10PM +1000, Jonathan Michaels wrote:
> i understand how freebsd works, but i'll be damned if i can
> work out out to construct the machine that will produce printed
> documentation.
Assuming you're talking about writing in SGML, and then producing printed
output, by far the simplest way to do this (but not necessarily the
fastest) is to
1. Get and Install textproc/docproj,
# cd /usr/ports/texproc/docproj
# make JADETEX=yes install
I've heard occasional reports from people that this doesn't work
right for them. I've just tried it on a freshly installed FreeBSD
system and it worked straight away, so you shouldn't have any problems.
2. Write your documentation in DocBook. Use the examples at the bottom
of the FDP Primer to convert your DocBook to other formats (in
particular, Postscript). You can preview these with tools like
Ghostview.
3. If you have a Postscript printer then configure FreeBSD to use it,
following the directions in the Handbook.
4. Use the output from (2), and what ever you did in (3), to print your
Postscript documents.
N
--
Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95.
Telephone line, $24.95 a month. Software, free. USENET transmission,
hundreds if not thousands of dollars. Thinking before posting, priceless.
Somethings in life you can't buy. For everything else, there's MasterCard.
-- Graham Reed, in the Scary Devil Monastery
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000820140040.B2217>