Date: Mon, 20 May 2002 18:41:28 +0930 From: Greg 'groggy' Lehey <grog@FreeBSD.org> To: Jeremy Lea <reg@FreeBSD.org>, 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> In-Reply-To: <20020520105506.A74325@shale.csir.co.za> References: <200205200044.g4K0ipT51646@freefall.freebsd.org> <20020520105506.A74325@shale.csir.co.za>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020520184128.K12212>