Hello All,<br><br>I&#39;ve been looking at the doxygen and want to try and standardise it a little bit more.<br>Here are my suggestions:<br>1. Using \retval instead of return to make it easier to read in code (shame doxygen puts it all together when parsing it to be in html)  
<br>2.&nbsp;For&nbsp;documentation&nbsp;of&nbsp;&#39;__functions&#39;&nbsp;we&nbsp;add&nbsp;just&nbsp;\see&nbsp;&#39;function&#39;&nbsp;since&nbsp;it&nbsp;should&nbsp;be&nbsp;documented&nbsp;at&nbsp;the&nbsp;.h&nbsp;level&nbsp;and&nbsp;that&nbsp;way&nbsp;when&nbsp;people&nbsp;browse&nbsp;the&nbsp;documentation&nbsp;they&nbsp;can&nbsp;click&nbsp;to&nbsp;get&nbsp;the&nbsp;actual&nbsp;full&nbsp;description&nbsp;rather&nbsp;than
&nbsp;creating&nbsp;clutter&nbsp;in&nbsp;the&nbsp;.c doxygen can&#39;t understand that the __ version and normal  link.This can reduce duplication and clutter when viewing the source itself. <br><br>For example res_crypto .c  I would just add the following 
<br><br>/*!<br> * \brief return the ast_key structure for name<br>* Check .h for full documentation <br> * \see ast_key_get<br>*/<br>static struct ast_key *__ast_key_get(const char *kname, int ktype)<br><br>3. If anyone could help me understand the \ref errors in &#39;make progdocs&#39; and how i could go about fixing them let me know. 
<br>4. If all doxygen comments&nbsp;for&nbsp;variables must be in the form of /*! */ before a variable is declared and replacing all /*!&lt; */ instances that can be done.  <br><br>I&#39;m&nbsp;open&nbsp;for&nbsp;suggestions&nbsp;on&nbsp;how&nbsp;to&nbsp;proceed&nbsp;<br>
<br>-Brad<br><br>