[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Doxygen policy ideas

From: Branko Čibej <brane_at_xbc.nu>
Date: 2005-04-08 18:13:20 CEST

Julian Foad wrote:

> Certainly not @c. We should let Doxygen generate links wherever
> possible. '#' is for macros, not types.
>
> According to the manual on www.doxygen.org, '#' can mark any symbol,
> and is almost identical to a '::' prefix. Not that we would
> necessarily want to use it that freely. The manual doesn't seem to
> make any recommendations about best usage - it only documents the syntax.
>
>
>>> Refer to any other Subversion public symbol in the global namespace
>>> (e.g. typedef, #define macro, but not enumerated constants) with
>>> prefix "#" (not with "@c").
>>
>>
>> +1
>
>
> You contradict yourself here. How would you prefer to mark types that
> aren't structures?

Hm, yes, I forgot that doxy treats structs specially. Ignore my
ignorance; # it is, then, as I do think that links are important.

-- Brane

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Fri Apr 8 18:14:19 2005

This is an archived mail posted to the Subversion Dev mailing list.

This site is subject to the Apache Privacy Policy and the Apache Public Forum Archive Policy.