From owner-cvs-all Mon Jun 21 1:52:45 1999 Delivered-To: cvs-all@freebsd.org Received: from cimlogic.com.au (cimlog.lnk.telstra.net [139.130.51.31]) by hub.freebsd.org (Postfix) with ESMTP id 985F514D02; Mon, 21 Jun 1999 01:52:29 -0700 (PDT) (envelope-from jb@cimlogic.com.au) Received: (from jb@localhost) by cimlogic.com.au (8.9.1/8.9.1) id TAA08078; Mon, 21 Jun 1999 19:17:31 +1000 (EST) (envelope-from jb) From: John Birrell Message-Id: <199906210917.TAA08078@cimlogic.com.au> Subject: Re: cvs commit: doc/en/handbook/ports chapter.sgml In-Reply-To: <77890.929954721@axl.noc.iafrica.com> from Sheldon Hearn at "Jun 21, 1999 10:45:21 am" To: sheldonh@uunet.co.za (Sheldon Hearn) Date: Mon, 21 Jun 1999 19:17:16 +1000 (EST) Cc: jb@cimlogic.com.au, billf@jade.chc-chimes.com, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org X-Mailer: ELM [version 2.4ME+ PL43 (25)] MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk Sheldon Hearn wrote: > I'm sure developers the world over share your sentiment. However, the > issue here is that it's not developers that Bill is trying to help with > this -- it's porters. > > And as a porter, I _would_ expect to find this sort of information where > Bill's suggesting we put it. I'd say Bill's change should be accompanied > by the one suggested below. As a porter, you should expect to find a _link_ to the documentation that applies to non-porters equally. Anyone who has custom kernel code (like lkm/klds) knows how often FreeBSD changes the APIs. The only way of handling that (AFAIK) is to test for __FreeBSD_version. I still say that finding that sort of documentation in middle of the ports docs is non-intuitive. -- John Birrell - jb@cimlogic.com.au; jb@freebsd.org http://www.cimlogic.com.au/ CIMlogic Pty Ltd, GPO Box 117A, Melbourne Vic 3001, Australia +61 418 353 137 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message