From owner-freebsd-doc  Sun Aug 20 14: 3:14 2000
Delivered-To: freebsd-doc@freebsd.org
Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66])
	by hub.freebsd.org (Postfix) with ESMTP id 61AA637B424
	for <freebsd-doc@freebsd.org>; Sun, 20 Aug 2000 14:03:10 -0700 (PDT)
Received: from kilt.nothing-going-on.org (root@kilt.nothing-going-on.org [192.168.1.18])
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) with ESMTP id VAA52349;
	Sun, 20 Aug 2000 21:40:27 +0100 (BST)
	(envelope-from nik@catkin.nothing-going-on.org)
Received: (from nik@localhost)
	by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA02513;
	Sun, 20 Aug 2000 14:00:41 GMT
	(envelope-from nik)
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>
References: <20000819185408.A88564@phoenix.welearn.com.au>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.2i
In-Reply-To: <20000819185408.A88564@phoenix.welearn.com.au>; from jon@welearn.com.au on Sat, Aug 19, 2000 at 06:54:10PM +1000
Organization: FreeBSD Project <URL:http://www.freebsd.org/>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

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