From owner-cvs-all Mon May 20 2:11:39 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 64BE837B403; Mon, 20 May 2002 02:11:30 -0700 (PDT) Received: by wantadilla.lemis.com (Postfix, from userid 1004) id 717B4812F7; Mon, 20 May 2002 18:41:28 +0930 (CST) Date: Mon, 20 May 2002 18:41:28 +0930 From: Greg 'groggy' Lehey To: Jeremy Lea , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/doc/psd/02.implement Makefile Message-ID: <20020520184128.K12212@wantadilla.lemis.com> References: <200205200044.g4K0ipT51646@freefall.freebsd.org> <20020520105506.A74325@shale.csir.co.za> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020520105506.A74325@shale.csir.co.za> 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 10:55:07 +0200, Jeremy Lea wrote: > Hi all, > > On Sun, May 19, 2002 at 05:44:51PM -0700, Greg Lehey wrote: >> This is only a partial solution; the whole issue of building the >> documentation needs to be revisited. > > Unless I'm reading the sources completely wrong (there's an excellent > chance that I am), these documents are the only thing which require that > we have groff as a buildtool in a make world, and groff is the only thing > which requires that we have a C++ compiler available in > buildtools... Well, if with "these documents", you mean all the files in /usr/share/doc, then you could be right. Certainly the existing documentation needs it. Note also, though, that the man pages need *roff to process them. Currently, that's *very* tied in with groff. Theoretically we could now import the old [nt]roff from 4.4BSD, but I don't think that's a good idea. It's a lot more primitive than groff, and the macros we use wouldn't work under it. > 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. Are you expressing interest in doing the work? > Converting them to docbook would be a good introduction to docbook > for budding doc committers... It might scare them off for life. 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