[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/