Re: [avr-libc-dev] [Bug #2845] clicking on 'fdevopen' in 'standard IO Facilities' page doesn't work

[Theodore A. Roth]

On Mon, 17 Mar 2003, Joerg Wunsch wrote:

:) As address@hidden wrote:
:)
:) > Summary:  clicking on 'fdevopen' in 'standard IO Facilities' page doesn't 
work
:)
:) > At least it doesn't for the ones in the initial piece of text where
:) > the concept is explained. The link for fdevopen under 'Functions'
:) > does work but it points at a different file (the current one).
:)
:) That must be a bug in doxygen.  Somehow it confuses the link targets,
:) and where it ought to link to group__avr__stdio.html#a1, it links to
:) fdevopen_8c.html#a1.
:)
:) Perhaps rearranging the text a bit works around it, if not, our only
:) chance is to post-build filter this with yet another stream editor hack
:) in the Makefile...

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

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.


Ted Roth