From owner-freebsd-hackers Sun Aug 29 7: 0:31 1999 Delivered-To: freebsd-hackers@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 9017214EA1; Sun, 29 Aug 1999 06:57:46 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.3/8.9.3) id OAA81667; Sun, 29 Aug 1999 14:48:24 +0100 (BST) (envelope-from nik) Date: Sun, 29 Aug 1999 14:48:24 +0100 From: Nik Clayton To: "Daniel C. Sobral" Cc: Nik Clayton , hackers@FreeBSD.ORG Subject: Re: [Fwd: Re: cvs commit: doc/en/handbook/ports chapter.sgml] Message-ID: <19990829144824.A80972@catkin.nothing-going-on.org> References: <37C1296C.82D5A24C@newsguy.com> <19990825142659.A10355@kilt.nothing-going-on.org> <37C7F616.481430D3@newsguy.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <37C7F616.481430D3@newsguy.com>; from Daniel C. Sobral on Sat, Aug 28, 1999 at 11:45:42PM +0900 Organization: FreeBSD Project Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Sat, Aug 28, 1999 at 11:45:42PM +0900, Daniel C. Sobral wrote: > You know how people can get sidetracked easily. :-) For that matter, > if chapter.sgml still has a log of why the version changed, then I > think it would be a good thing to insert the above comment in > param.h. I don't recall seeing any objections, though I can imagine > some people might think it's not appropriate for the source to refer > to an outside documentation such as the handbook. Given that: 1. The 'committer rules' document will apply to doc/ just as much as it applies to src/. 2. The FDP mailing list is @FreeBSD.org 3. After a big discussion recently, the FDP documentation will continue to be installed under /usr/share/doc/ (rather than /usr/local/share/doc, which is where third-party documentation is installed) I think it's safe to say that the source code should be able to refer to any documentation in the doc/ tree. If you don't beat me to it, I'll commit that comment. N -- [intentional self-reference] can be easily accommodated using a blessed, non-self-referential dummy head-node whose own object destructor severs the links. -- Tom Christiansen in <375143b5@cs.colorado.edu> To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message