From owner-cvs-all Mon May 20 19:19: 1 2002 Delivered-To: cvs-all@freebsd.org Received: from wantadilla.lemis.com (wantadilla.lemis.com [192.109.197.80]) by hub.freebsd.org (Postfix) with ESMTP id 1509537B40F; Mon, 20 May 2002 19:18:54 -0700 (PDT) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id A6B8981466; Tue, 21 May 2002 11:48:51 +0930 (CST) Date: Tue, 21 May 2002 11:48:51 +0930 From: Greg 'groggy' Lehey To: Poul-Henning Kamp Cc: Jeremy Lea , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/doc/psd/02.implement Makefile Message-ID: <20020521114851.V12212@wantadilla.lemis.com> References: <20020520105506.A74325@shale.csir.co.za> <13483.1021886327@critter.freebsd.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <13483.1021886327@critter.freebsd.dk> User-Agent: Mutt/1.3.23i Organization: The FreeBSD Project Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-418-838-708 WWW-Home-Page: http://www.FreeBSD.org/ X-PGP-Fingerprint: 9A1B 8202 BCCE B846 F92F 09AC 22E6 F290 507A 4223 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 On Monday, 20 May 2002 at 11:18:47 +0200, Poul-Henning Kamp wrote: > 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. Agreed, the /usr/src/share/doc hierarchy seems to be an anachronism. They'd be better off (and more likely to be found) in /usr/doc. Greg -- See complete headers for address and phone numbers To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message