On Fri, 21 Jan 2000 21:57:44 +0100 
 Hauke Fath <hauke@Espresso.Rhein-Neckar.DE> wrote:

 > I have never really understood that one. I see header files as documenting
 > a module's Interface, and
 > 
 > 	int foo(int, int, int, int, int *)
 > 
 > does not really cut it for me.

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

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

        -- Jason R. Thorpe <thorpej@nas.nasa.gov>