Интерсно, есть ли более менее функциональный редактор позволяющий рисовать диаграммы непосредственно в коментариях к исходнику?
Лично мне очень нравятся небольшие диаграмки объясняющие нетривиальную взаимосвязь между классами, объектами, потоками данных и пр. Зачатую такая диаграмма дает больше информации чем десятки строк текста.
Тем, что "стандартные" не дают возможности получить изображение в текстовом формате и вставить его в исходник в виде комментария.
Все иначе делается. Исходник остается исходником. А DOxyGen документирует его, при желании рисует UML там где скажешь.
