
<html><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><div>On Feb 25, 2008, at 5:32 PM, Nick Kledzik wrote:</div><br class="Apple-interchange-newline"><blockquote type="cite"><div>I've updated the header (enclosed).</div><div><br class="khtml-block-placeholder"></div><div><span></span><span><lto.h></span></div><div><span></span></div><div><br></div></blockquote>Hi Nick,</div><div><br class="webkit-block-placeholder"></div><div>My turn. :-) Just one question. Will the comments you have here be doxygen-friendly? (N.B., I'm not an expert on doxygen.) One thing I notice in other code is that the function or variable names are repeated in the comments. There might also be a special C-style comment quoting for doxygen. Something like this:</div><div><br class="webkit-block-placeholder"></div><div>/**</div><div> * <span class="Apple-style-span" style="font-family: 'Courier New'; ">lto_module_is_object_file_in_memory - Checks if a buffer is a loadable object file.</span></div><div><font class="Apple-style-span" face="'Courier New'"> */</font></div><div><font class="Apple-style-span" face="'Courier New'">extern bool</font></div><div><font class="Apple-style-span" face="'Courier New'">lto_module_is_object_file_in_memory(const void* mem, size_t length);</font></div><div><font class="Apple-style-span" face="'Courier New'"><br class="webkit-block-placeholder"></font></div><div>and so on.</div><div><br class="webkit-block-placeholder"></div><div>-bw</div></body></html>