> In headers files that include user-accessible prototypes, you CANNOT
> include variable names, as they intrude on the user's namespace.

I buy this, but it's a shame. Seems like a constructed argument to me, I've
never been hit by such a thing in everyday work. That was the reasons K&R
suggested macros to be all uppercase?

> Documentation documents the interface.  Header files are for the compiler
> to read.

Here, here! And NetBSD is a great example to what level this works ;-}
Sorry, couldn't resist.


Martin