Subject: Re: man pages & style guide
To: Julian Bean <jules@mailbox.co.uk>
From: Rafal Boni <rafal@scofflaw.banyan.com>
List: current-users
Date: 03/07/1996 17:27:21
In message <313EE082.6440@mailbox.co.uk>, you write: 

-> J.T. Conklin wrote:
[...]
-> > So prototype function arguments in system headers must either not have
-> > names, or have names in the implementers namespace.
[...]

-> So, *never* have any #defines before system header files, unless you know
-> exactly what you are doing.  It could have horrible consequences in many 
-> ways:

[..rest snipped...]

	Yeah, but what JTC says doesn't have that limitation... Since the
	system headers is something "we" have control over, "we" can easily
	snip out the names (or do as der Mouse suggrsted and put them inside
	C-style comments as in "extern int add (int /* op1 */, int /* op2 */);"
	so that they are more "self-documenting").

	What people define (or don't) before including system headers is 
	mostly out of the control of the NetBSD team... JT's suggestion
	takes the "high road" wrt portability and such, whereas you suggest
	a much more "well, if does *that*, then it deserves to be broken"
	approach.  Moreover, you approach *gains* nothing!

	--rafal