From: Sergei Golubchik
Date: April 12 2010 11:20am
Subject: Re: doxygen comments in header files
List-Archive: http://lists.mysql.com/internals/37866
Message-Id: <20100412112007.GA1586@sergbook.mysql.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

Hi, Tor!

On Apr 12, Tor Didriksen wrote:
>>>
>>> No, as a heavy ctags user I prefer the function documentation near
>>> the implementation. With the exception of the public API headers,
>>> like plugin.h or mysql.h.
>>>
>>> I'm not going to argue my case though. But I would be happy to know
>>> a solution for ctags users for "documentation in the headers" style.
>>
>> I remember you raised the ctags problem previously, but I don't
>> remember what it was (just that it was about ctags not finding
>> information) :-( Could you please re-explain it?
>> Thanks!
>
> By default, etags will not tag function declarations.
> see 'man etags' and the --declarations option

Right. But as a downside on every jump I'll have a choice from two tags
to jump to and have to pick up the right one depending on whether I want
a documentation or a code :(

Oh well...

Regards,
Sergei