Date: Mon, 21 Jun 1999 19:17:16 +1000 (EST) From: John Birrell <jb@cimlogic.com.au> To: sheldonh@uunet.co.za (Sheldon Hearn) Cc: jb@cimlogic.com.au, billf@jade.chc-chimes.com, cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: doc/en/handbook/ports chapter.sgml Message-ID: <199906210917.TAA08078@cimlogic.com.au> In-Reply-To: <77890.929954721@axl.noc.iafrica.com> from Sheldon Hearn at "Jun 21, 1999 10:45:21 am"
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199906210917.TAA08078>