[tarantool-patches] Re: [PATCH v2 2/4] sql: refactor getNewIid() function

[Konstantin Osipov]

* n.pettik <korablev at tarantool.org> [19/03/29 21:18]:
> > 1. According to doxygen docs http://www.doxygen.nl/manual/commands.html <http://www.doxygen.nl/manual/commands.html>
> > there is no such a command as @space_id. But obviously I know what
> > you've implied here. For references to parameters we use '@a' before a
> > parameter. Like this:
> >    ...
> >    * the space identifier by @a space_id.
> >    ...
> 
> Does anybody even try to generate doxygen doc?
> I still believe that doxygen format may be useful only
> for external (aka interface) functions. The rest of comments
> (especially for static funcs) are seem to be aimed solely at
> developers.

True, but functions and comments live for a long time so it's
better to stick to a single style of comments.

-- 
Konstantin Osipov, Moscow, Russia, +7 903 626 22 32
http://tarantool.io - www.twitter.com/kostja_osipov