20 Oct
2009
20 Oct
'09
9:02 p.m.
> 2. Could you (in the future) please use
javadoc style for files in
> the core,
> tm and files added by me? That means using /** shortdesc . ...
> instead of /*! \brief shortdesc */
In kamailio, we had /*!
The \brief needs to be there regardless, like \file and all the
other doxygen
commands.
I think we need *one* standard, regardless of where files are,
having one for
core, tm and Andrei-files does not make sense to me. I can settle
with
both /** and /*!, just got used to /*! from Kamailio and Asterisk.
Another rule is that contributors must obey the format of main
developer. For example, I like opening brackets on a new line after
if/while/etc. Others want it at the end of line. When adding code to
parts not started by me I try to conform the general pattern found
in the file. I expect same from the others.