From owner-cvs-share  Mon Apr 10 12:59:53 1995
Return-Path: cvs-share-owner
Received: (from majordom@localhost)
          by freefall.cdrom.com (8.6.10/8.6.6) id MAA25514
          for cvs-share-outgoing; Mon, 10 Apr 1995 12:59:53 -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 MAA25481
          ; Mon, 10 Apr 1995 12:59:31 -0700
Received: (from paul@localhost) by isl.cf.ac.uk (8.6.9/8.6.9) id UAA26603; Mon, 10 Apr 1995 20:59:42 +0100
From: Paul Richards <paul@isl.cf.ac.uk>
Message-Id: <199504101959.UAA26603@isl.cf.ac.uk>
Subject: Re: cvs commit: src/share/FAQ/SGML adminman.sgml infosources.sgml
To: jfieber@cs.smith.edu (John Fieber)
Date: Mon, 10 Apr 1995 20:59:42 +0100 (BST)
Cc: jfieber@freefall.cdrom.com, CVS-commiters@freefall.cdrom.com,
        cvs-share@freefall.cdrom.com
In-Reply-To: <199504101727.NAA08267@grendel.csc.smith.edu> from "John Fieber" at Apr 10, 95 01:27:16 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: 1709      
Sender: cvs-share-owner@freebsd.org
Precedence: bulk

In reply to John Fieber who said
> 
> Paul Richards writes:
> > >   Log:
> > >   HTML versions of the SGML documents.  These are intended to be
> > >   accessed through the index.html file in the parent directroy.
> 
> > This is very bad. If there's no way to automatically generate the HTML
> > files from the SGML sources during *installation* then we'll have to
> > re-think the whole setup. This will just lead to inconsistencies between the
> > two formats and wastes a lot of space.
> 
> Indeed. Having it build during the install involves to pieces
> that are not in the tree:
> 
>   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!

>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.

Rod, can we just nuke the html area from the repository completely and
pretend this never happened since as yet we've not release anything that
depends on this.

-- 
  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.