From owner-freebsd-doc Tue Aug 29 20:35:22 1995 Return-Path: doc-owner Received: (from majordom@localhost) by freefall.FreeBSD.org (8.6.11/8.6.6) id UAA06332 for doc-outgoing; Tue, 29 Aug 1995 20:35:22 -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 UAA06325 for ; Tue, 29 Aug 1995 20:35:20 -0700 Received: (from jfieber@localhost) by fieber-john.campusview.indiana.edu (8.6.11/8.6.9) id WAA15002; Tue, 29 Aug 1995 22:34:35 -0500 From: John Fieber Message-Id: <199508300334.WAA15002@fieber-john.campusview.indiana.edu> Subject: Re: /usr/share/doc/handbook? To: rgrimes@gndrsh.aac.dev.com (Rodney W. Grimes) Date: Tue, 29 Aug 1995 22:34:34 -0500 (EST) Cc: CVS-commiters@freefall.FreeBSD.org, doc@freebsd.org In-Reply-To: <199508300119.SAA05223@gndrsh.aac.dev.com> from "Rodney W. Grimes" at Aug 29, 95 06:19:00 pm X-Mailer: ELM [version 2.4 PL24] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 3488 Sender: doc-owner@freebsd.org Precedence: bulk [lots quoted for those on -commiters who may have missed the original] Rodney W. Grimes writes: > > > > > 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...). > > Please post it to -committers, or to -current, not to -core. > > Yes, I am up to me ears in it, only now it is so deep I can even > stick my hand straight up and feel the top any more :-(. > > > 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. > > You have my blessing to kill that ugly hack for the time being and > only product the .ascii versions of the files by default. If some > one really needs the .ps files they can easily be generated. We > can then go in and fix the bsd.doc.mk file to handle a list of > output device types at a later date. > > > 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. > > PRINTER determines output type, not input type. SRCS determintes > input type. It should be valid to have multiple types in SRCS for > documents just as you can for a binary (ie, .o, .s, .S, .c, .cc, etc). Exactly. I'm talking about output here, not input. sgmlfmt can generates html, thus PRINTER=html. In bsd.sgml.mk, I've tenatively ditched the PRINTER in favor of FORMATS since we may be generating output that isn't intended to be printed. Maybe FORMATS is unclear? How about OUTPUT? DEVICE? OUTDEV? Other suggestions? > > > 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. > > Yes, that is the correct solution. > > > 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. > > :-). So kill the ugly hack in src/share/doc/Makefile and we can go fix > it in bsd.doc.mk the right way after the fact. > > -- > Rod Grimes rgrimes@gndrsh.aac.dev.com > Accurate Automation Company Reliable computers for FreeBSD > == jfieber@indiana.edu =========================================== == http://fieber-john.campusview.indiana.edu/~jfieber ============