From owner-cvs-all Mon May 20 2:19:45 2002 Delivered-To: cvs-all@freebsd.org Received: from critter.freebsd.dk (port757.uc1-esp.isdn-lan.cybercity.dk [212.242.98.245]) by hub.freebsd.org (Postfix) with ESMTP id 532DD37B401; Mon, 20 May 2002 02:19:38 -0700 (PDT) Received: from critter.freebsd.dk (localhost [127.0.0.1]) by critter.freebsd.dk (8.12.3/8.12.2) with ESMTP id g4K9IlOw013484; Mon, 20 May 2002 11:18:47 +0200 (CEST) (envelope-from phk@critter.freebsd.dk) To: Jeremy Lea Cc: Greg Lehey , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/doc/psd/02.implement Makefile In-Reply-To: Your message of "Mon, 20 May 2002 10:55:07 +0200." <20020520105506.A74325@shale.csir.co.za> Date: Mon, 20 May 2002 11:18:47 +0200 Message-ID: <13483.1021886327@critter.freebsd.dk> From: Poul-Henning Kamp Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG In message <20020520105506.A74325@shale.csir.co.za>, Jeremy Lea writes: [re: share/doc] >Since these documents are (1) mostly out of date, and (2) never change, >should we be building them with the world at all. Would it not be >better to convert what is still relevant too docbook and add it to the >doc tree? Or, if we want to keep them for historical interest, convert >them all. I think share/doc is one of our best kept secrets, few people seem to realize the documents are there until you actually point it out for them. Now, just because it is a secret doesn't mean that the various documents necessarily has high value, they vary from hysterically historical to valuable current documentation. Some years back, I had a vain hope that the BSD tradition of putting (Free)BSD in the tree would continue, but as far as I can tell, my malloc, bufbio and jail papers are the only ones added since 4.4 was checked in. I think this is a pity, I would love if there were some place were we could put up a reference library, but obviously troff isn't the language of choice anymore so share/doc disqualifies itself under the "make world" doctrine. So failing the role of project library, I think these documents would be better off if we asked the doc project to please adopt them and hinted (nudge, nudge, wink, wink!) that they could form the start of a collection of project related papers. -- Poul-Henning Kamp | UNIX since Zilog Zeus 3.20 phk@FreeBSD.ORG | TCP/IP since RFC 956 FreeBSD committer | BSD since 4.3-tahoe Never attribute to malice what can adequately be explained by incompetence. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message