<HTML><BODY style="word-wrap: break-word; -khtml-nbsp-mode: space; -khtml-line-break: after-white-space; "><DIV><DIV>On Feb 26, 2008, at 1:36 AM, Bill Wendling wrote:</DIV><BLOCKQUOTE type="cite"><DIV><DIV>On Feb 25, 2008, at 5:32 PM, Nick Kledzik wrote:</DIV><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></BLOCKQUOTE><BR></DIV><DIV>Thanks for catching that. I've added the extra asterisk to the start of each comment.</DIV><DIV><BR class="khtml-block-placeholder"></DIV><DIV>-Nick</DIV><DIV><BR class="khtml-block-placeholder"></DIV></BODY></HTML>