[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.
Bruno
- Re: New module argp-version-etc, (continued)
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/24
- Re: New module argp-version-etc, Bruno Haible, 2009/06/24
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/25
- Re: New module argp-version-etc, Jim Meyering, 2009/06/25
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/25
- Re: New module argp-version-etc, Jim Meyering, 2009/06/25
- Re: New module argp-version-etc, Paolo Bonzini, 2009/06/25
- Re: New module argp-version-etc, Bruno Haible, 2009/06/26
- Re: New module argp-version-etc, Paolo Bonzini, 2009/06/26
- Re: New module argp-version-etc,
Bruno Haible <=
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/25
- Re: New module argp-version-etc, Bruno Haible, 2009/06/25
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/25
- Re: New module argp-version-etc, Eric Blake, 2009/06/25
- Re: New module argp-version-etc, Eric Blake, 2009/06/25
- Re: New module argp-version-etc, Sergey Poznyakoff, 2009/06/25
- Re: New module argp-version-etc, Jim Meyering, 2009/06/26