From owner-freebsd-questions  Fri Jan  5 01:14:29 1996
Return-Path: owner-questions
Received: (from root@localhost)
          by freefall.freebsd.org (8.7.3/8.7.3) id BAA21270
          for questions-outgoing; Fri, 5 Jan 1996 01:14:29 -0800 (PST)
Received: from toadflax.cs.ucdavis.edu (toadflax.cs.ucdavis.edu [128.120.56.188])
          by freefall.freebsd.org (8.7.3/8.7.3) with SMTP id BAA21260
          for <questions@freebsd.org>; Fri, 5 Jan 1996 01:14:25 -0800 (PST)
Received: by toadflax.cs.ucdavis.edu (4.1/UCD.CS.2.6)
	id AA05662; Fri, 5 Jan 96 01:14:14 PST
From: obrien@cs.ucdavis.edu (David E. O'Brien)
Message-Id: <9601050914.AA05662@toadflax.cs.ucdavis.edu>
Subject: Re: handbook
To: ptroot@uswest.com
Date: Fri, 5 Jan 1996 01:14:12 -0800 (PST)
Cc: questions@freebsd.org
In-Reply-To: <9601041953.AA01318@kermit.acs.uswest.com> from "ptroot@uswest.com" at Jan 4, 96 01:53:32 pm
X-Mailer: ELM [version 2.4 PL24 ME8b]
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Sender: owner-questions@freebsd.org
Precedence: bulk

>         I'm trying to get the handbook printed out. When I run it
> through latex, I get a couple of errors (with a ?) prompt. And when I
> view the dvi file (or converted ps file) the table of contents is
> blank and any references to other sections is just ??.

The handbook's LaTeX generated source is written for LaTeX 2e.  LaTeX 2e
is the newer version that brings together many patches and enhancements
for LaTeX.  However, many, many shops installed LaTeX years ago and
haven't upgraded it.  (since it can be such a bear to get a new version
up and running who can blame them?)

So, yes, often you will have trouble processing the LaTeX output.  I am
also assuming you are either taking the SGML source and running it
sgmlfmt to generate the LaTeX files (and have
/usr/share/sgml/FreeBSD/lib/linuxdoc.sty installed).  Or, you are taking
the LaTeX source from ftp.freebsd.org:/pub/FreeBSD/docs


>         Am I doing anything wrong, or is it just that the handbook
> is incomplete?

Neither, see above.

>         I'm doing it on my Sparc at work, running Solaris 2.5. No, I'm
> not convinced that latex is correctly installed on the Sparc. Is it
> worth my while to pkg_add tex on my FreeBSD machine to create the doc?

YES, either that or get the PostScript file from someone.

(Gee, wouldn't it be nice (how many times have I said this to the Docs
people?) if the PostScript version of the handbook were also at
ftp.freebsd.org:/pub/FreeBSD/docs ?)

-- David   (obrien@cs.ucdavis.edu)