avr-libc-dev
[Top][All Lists]
Advanced

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

Re: [avr-libc-dev] [Bug #2845] clicking on 'fdevopen' in 'standard IO Fa


From: Joerg Wunsch
Subject: Re: [avr-libc-dev] [Bug #2845] clicking on 'fdevopen' in 'standard IO Facilities' page doesn't work
Date: Mon, 17 Mar 2003 20:12:24 +0100
User-agent: Mutt/1.2.5i

As Theodore A. Roth wrote:

> Moving the dox comment from stdio.h to libc/stdio/fdevopen.c fixes the
> problem.

Fine, are you going to commit that and close the bug report?

> Personally, I prefer to have the dox with the source for the function
> instead of in the header. I think a developer is more likely to
> remember to update the dox when the function changes if they are kept
> together.

Then we should re-org it that way, but IMHO only after 1.0 is ready.
Editing the headers was simpler for the ``mass changes'' when
documenting everything.  I agree that documenting the source is better
for an ongoing effort.
-- 
J"org Wunsch                                           Unix support engineer
address@hidden        http://www.interface-systems.de/~j/




reply via email to

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