patch to style(9) man page to reflect current practices
joerg at britannica.bec.de
Thu Feb 5 10:24:37 PST 2004
On Thu, Feb 05, 2004 at 10:18:58AM -0800, Chris Pressey wrote:
> There was one other change I wanted to make, re:
> "In header files visible to userland applications, prototypes that are
> visible must use either ``protected'' names (ones beginning with an
> underscore) or no names with the types. It is preferable to use pro-
> tected names. E.g., use:
> void function(int);
> void function(int _fd);"
Well, I say simple drop the name.
> I completely fail to see the rationale for that, but I might be missing
> something. Also, I don't think I've ever seen prototype declarations
> like that, but I probably just haven't been looking hard enough.
You might have a #define fd foo somewhere.
> Anyone have any idea why that clause is in there, and whether it should
> be reworded/taken out? The least that could be done is to clarify why
> "protected" names should be used (what do they conflict with?)
More information about the Submit