From owner-freebsd-commit Mon Apr 10 13:21:47 1995 Return-Path: commit-owner Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id NAA27534 for commit-outgoing; Mon, 10 Apr 1995 13:21:47 -0700 Received: (from majordom@localhost) by freefall.cdrom.com (8.6.10/8.6.6) id NAA27479 for cvs-share-outgoing; Mon, 10 Apr 1995 13:20:07 -0700 Received: from isl.cf.ac.uk (isl-gate.elsy.cf.ac.uk [131.251.22.1]) by freefall.cdrom.com (8.6.10/8.6.6) with ESMTP id NAA27431 ; Mon, 10 Apr 1995 13:19:37 -0700 Received: (from paul@localhost) by isl.cf.ac.uk (8.6.9/8.6.9) id VAA26767; Mon, 10 Apr 1995 21:19:30 +0100 From: Paul Richards Message-Id: <199504102019.VAA26767@isl.cf.ac.uk> Subject: Re: cvs commit: src/share/FAQ/SGML adminman.sgml infosources.sgml To: phk@ref.tfs.com (Poul-Henning Kamp) Date: Mon, 10 Apr 1995 21:19:29 +0100 (BST) Cc: jfieber@cs.smith.edu, jfieber@freefall.cdrom.com, CVS-commiters@freefall.cdrom.com, cvs-share@freefall.cdrom.com In-Reply-To: <199504102010.NAA00435@ref.tfs.com> from "Poul-Henning Kamp" at Apr 10, 95 01:10:59 pm X-Mailer: ELM [version 2.4 PL23] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Content-Length: 2170 Sender: commit-owner@FreeBSD.org Precedence: bulk In reply to Poul-Henning Kamp who said > > > > 1) Sgmls and sgmlsasp: an sgml parser. This is an easy > > > out-of-the-box compile. > > > > > > 2) The linuxdoc DTD, asp replacemet files and the sgmlformat > > > perl script. There is a fair amount of cruft to be removed > > > from this before anybody would let it near. One binary > > > is involved but I plan to absorb its functionality in > > > the perl script. > > > > Please spend time doing this. > > > > The extra cruft you've added to the cvs tree WILL NEVER GO AWAY! > > Cool down Paul. Hey man, I'm always cool :-) > > Just now I think many of us are in favour of any kind of doc, no matter > what bloat it adds to the tree, as compared to having no doc at all. But this is a silly argument. I'm all in favour of getting the docs but there's little extra work involved in writing it in SGML rather than HTML. It doesn't solve the underlying problem at all, we can't provide LaTeX versions of these docs or anything else. I'd rather see them written in SGML and at some point before release one of use will have to sit down and port the conversion tools. Doing it this way means no-one will ever have the incentive to fix the underlying problem and we'll end up being stuck with it this way. > > > >From now until the end of FreeBSD's existence I'm going to have X Mb of > > disk space taken up by html files that we shouldn't have in the tree because > > even when you implement the proper mechanism those html files will hang > > around in the attic. > > We will probably have to do regular cleans of the CVSROOT anyway, so don't > get your blood pressure too high yet... We can't do that, not without totally buggering up any chance of checking out previous releases. We *can* do this with the required surgery between tags though. If it's not done before the next tag, i.e. at alpha, then it shouldn't ever be done. -- Paul Richards, FreeBSD core team member. Internet: paul@FreeBSD.org, URL: http://isl.cf.ac.uk/~paul/ Phone: +44 1222 874000 x6646 (work), +44 1222 457651 (home) Dept. Mechanical Engineering, University of Wales, College Cardiff.