title: Objective C @property comments
body: <p>I use Doxygen to generate docs for my objective c code.  Up to now though, I haven't been able to find any guidelines for how to correctly document properties.  Examples I've looked at do it every conceivable way.  Some people document the variables themselves, some people document the @property declarations.  Some use //, while others use full /** */ blocks.</p>
  
  <p>Can anyone point me to a reference for best practices?  Or maybe some information about future compatibility with Doxygen?  I would like to stick to a pattern that, at the very least, will be easy to adapt to Doxygen once they develop an official pattern.</p>