Еще довольно удобная штука в данном плане - NaturalDocs. Генерит красивые доки, сразу с поиском по классам/методам. Понимает наследование в классах, можно делать внутренние ссылки и много других вкусностей.<br>Можно юзать стандартный под синтаксис всего с парой-тройкой кастомных ключевых слов:<br>
<i>=begin nd<br>Method: foo<br><br>Parameters:<br>bar - bar parameter<br><br>baz - baz parameter<br><br>Returns: foobarbaz<br>=cut<br>sub foo {<br>...<br></i>}<br><br>Btw, написан на перле.<br><br><div class="gmail_quote">
28 ноября 2008 г. 23:00 пользователь  <span dir="ltr">&lt;<a href="mailto:moscow-pm-request@pm.org">moscow-pm-request@pm.org</a>&gt;</span> написал:<br><blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;">
Комменты вестимо, ибо по ним можно доксигеном пройтись, вот интеловцы<br>
молодцы, что б я без комментов делал ?<br>
<br></blockquote></div><br>