patch to style(9) man page to reflect current practices

[Joerg Sonnenberger]

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);
>      or:
>      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.

Joerg

> 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?)
> 
> -Chris