[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: New module argp-version-etc

From: Bruno Haible
Subject: Re: New module argp-version-etc
Date: Fri, 26 Jun 2009 14:30:15 +0200
User-agent: KMail/1.9.9

Paolo Bonzini wrote:
> > With Bruno's approach, a public function must
> > have *no* spec just before its definition, while each private one does.
> That also depends on whether you insist on prototypes for all static 
> functions.  In that case, that's the place for specs of private 
> functions, and *no* function has a spec before the definition.

Why would these two issues be correlated? The important thing for me is that
a user of a module only needs to read through the .h file, which is typically
much smaller than the .c file. If someone needs to know the documentation of
a 'static' function, he's in the situation of modifying the module, and he
better has read the entire .c file before he starts doing so. So, in this
case, it does not really matter where in the .c file the comments for 'static'
functions are located.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]