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.

Bruno


Reply via email to