[Top][All Lists]

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

Re: comments in getdelim.h

From: Simon Josefsson
Subject: Re: comments in getdelim.h
Date: Wed, 03 May 2006 16:24:37 +0200
User-agent: Gnus/5.110006 (No Gnus v0.6) Emacs/22.0.50 (gnu/linux)

Jim Meyering <address@hidden> writes:

> Simon Josefsson <address@hidden> wrote:
>>> May I add comments to getdelim.h?
>> Hi!  There is one in getdelim.c already.  Maybe remove it?  I'm not
>> sure what the policy is on placing function documentation, although I
>> usually keep them with the actual function.
>> Or we could have two function descripts, one in getdelim.c and one in
>> getdelim.h, I don't mind.
>> Perhaps we could discuss this generally, agree on a principle on
>> document it?  My preference is as above, but it is not a strong one.
> Hi Simon,
> We've had this debate at least once before.
> The conclusion was that we agreed to disagree.
> Bruno prefers to put documentation in .h files near the public
> declaration, most (all?) others prefer to put it in the .c files (nearer
> the actual implementation).  One proposal is to keep it in both places,
> but that violates the no-duplication tenet, since there is no easy way to
> keep them in sync.  So far, we're at an impasse.  Things owned by Bruno
> follow his approach.  Most others put public function documentation near
> the definition.
> Don't succumb :-)

Ok, then since getdelim.c have documentation with the source code, I
think that module fine as is.  Bruno, if your docstring improved on
the current, incorporating yours in getdelim.c seems like a good idea.

As for getline: Bruno, is it ok to apply your docstring to getline.c

Your #include fix to getline.c seem good.


reply via email to

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