On 2010-04-12 10:35, Guilhem Bichot wrote:
> Hello Serg,
> Sergei Golubchik a écrit, Le 11.04.2010 16:27:
>> Hi, Davi!
>> On Apr 11, Davi Arnaut wrote:
>>> Hi Timour,
>>> On 4/11/10 12:39 AM, Timour Katchaounov wrote:
>>>> Guilhem, guys,
>>>> I'd say, enough theoretical talk. Could each proponent
>>>> of a specific method of commenting pick some class, and
>>>> send to the list a sample with comments for both the
>>>> interface and implementation of few class members.
>>>> Such an example should contain a complete meaningful
>>>> description, not just a formal description of parameters
>>>> and results.
>>> Besides Monty, I think everybody else is in agreement.
>> 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?
By default, etags will not tag function declarations.
see 'man etags' and the --declarations option