[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:24:41 +0200
User-agent: KMail/1.9.9

Hi Jim,

Thanks for your understanding.

> It's not a big deal for me, now that I'm used to seeing no documentation
> in gnulib's .c files for certain public functions, but it still does rankle
> a little, each time I notice.

Well, for me, it's the opposite: I start boiling a bit, each time I see
a public header file without documentation, or a function declaration that
mentions only the types of the parameters and not their meaning.

> He has explained that he does this
> in an attempt to make it easier to find for *users* of the function.

Yes, and the functions are used more often than they are modified.

Anyway, in this case I was mostly protesting because of the references
to other pieces of documentation, which are hard to follow in a medium
that does not support hyperlinks.

Sergey solved it fine.


reply via email to

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