From owner-freebsd-doc  Tue Aug 29 08:03:50 1995
Return-Path: doc-owner
Received: (from majordom@localhost)
          by freefall.FreeBSD.org (8.6.11/8.6.6) id IAA07879
          for doc-outgoing; Tue, 29 Aug 1995 08:03:50 -0700
Received: from fieber-john.campusview.indiana.edu (Fieber-John.campusview.indiana.edu [149.159.1.34])
          by freefall.FreeBSD.org (8.6.11/8.6.6) with ESMTP id IAA07866
          ; Tue, 29 Aug 1995 08:03:44 -0700
Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id KAA12213; Tue, 29 Aug 1995 10:03:11 -0500
From: John Fieber <jfieber@indiana.edu>
Message-Id: <199508291503.KAA12213@fieber-john.campusview.indiana.edu>
Subject: Re: /usr/share/doc/handbook?
To: asami@cs.berkeley.edu (Satoshi Asami)
Date: Tue, 29 Aug 1995 10:03:11 -0500 (EST)
Cc: doc@freebsd.org, core@freebsd.org
In-Reply-To: <199508291110.EAA14461@silvia.HIP.Berkeley.EDU> from "Satoshi Asami" at Aug 29, 95 04:10:22 am
X-Mailer: ELM [version 2.4 PL24]
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
Content-Length: 1879      
Sender: doc-owner@freebsd.org
Precedence: bulk

Satoshi Asami writes:
> Is there a the reason why the html version of the handbook isn't
> installed by default?  As far as I can tell, the sgml version 
> compiles fine with "sgmlfmt -html".

Because there is no makefile.  I've put together a bsd.sgml.mk
that I've passed by Rod for approval.  He has not yet commented
on the latest revision.  I'll probably post it to core in the
next day or so for general review if I hear nothing (I gather Rod
is up to his ears in other stuff...).

A primary issue is the current make procedure for /usr/share/doc
is a little wierd and is somewhat inhospitable to non-troff
documents.  Specifically, the top level Makefile makes multiple
passes over the tree, each time with a different value of PRINTER
which determines the output generated.  This is okay so long as
all the documents in the tree are generated in the same way.

With different sorts of document (e.g. texinfo or sgml), then the
value of PRINTER becomes a problem.  For example, PRINTER=html
would cause great confusion for the troff documents. 

What I think needs to be done is to have the
bsd.(doc|info|sgml).mk have a built in default list of formats to
generate and then replace the current toplevel Makefile for
/usr/share/doc with a standard subdir makefile.  It will make a
single pass over the tree and generate/install the output formats
appropriate for each document.

This is how I've set up my bsd.sgml.mk.  It currently ignores the
value of PRINTER, in favor of a FORMATS variable (which can be
overridden in individual makefiles or on the make command line).
As it stands with the old bsd.doc.mk, the /usr/src/shar/doc tree
is done in two passes which means the sgml docs (FAQ and
handbook) would be installed twice.

-john

== jfieber@indiana.edu ===========================================
== http://fieber-john.campusview.indiana.edu/~jfieber ============