[cfe-dev] Random, tiny question about doxygen comment style

[Jacob Carlborg]

On 2012-06-15 07:25, Chandler Carruth wrote:
> Figured it was good to ask this as James is busy making sure the Clang
> doxygen is actually all well formed, and reasonably linked together so
> we have proper docs for the ever growing number of Clang library users...
>
> There are two ways to use doxygen directives:
>
> /// \brief ...
>
> and
>
> /// @brief ...
>
>
> I'd like to pick one form and be consistent going forward (with no real
> intention or need to clean up existing comments) just so the bikeshed
> stays a consistent hue.
>
> I prefer '\brief' by a small margin, mostly because I read all of the
> @foo things as either email stuff, twitter stuff, or ObjC stuff. Does
> anyone care passionately about this bikeshed being painted the other
> color? If so, I cede the field. I'm much more interested in having a
> single preferred form than which one it is. The mixture kills me. =]

How about doing some quick investigation and see which style is 
currently used in most places.

-- 
/Jacob Carlborg