И насчёт неказистости тоже... :)

Как Вы можете отлаживать код и писать доки одновременно?
Может научите меня?

Сначала Вам нужно глаза вылечить. Где вы видите отладку ?

Сначала Вам нужно глаза вылечить. Где Вы видите отладку ?

Не-а, не научу. Это раньше делать надо было - потому как документация пишется по-классике в три-четыре захода - обязательно ДО начала разработки (иначе встаёт вопрос, что вообще разрабатывается), корректируется - в ходе разработки, и окончательно доводится (параллельно с кодом) в ходе отладки и экспериментальной эксплуатации. Кстати, параллельно с отладкой доводить документацию очень полезно - много интересных вещей выплывает. Даже на несложных задачках...

Короче, кто через ЕС ЭВМ не прошёл, не поймет.

А я не понял, а в чем там дока пишется?

В Nedit + TCM + GraphViz, только не всё на поверхности экрана.

aterm?

Это там какая-то читалка man'ов ? Или это писалка ? Как называется ?

Это TkMan + rman (утилита командной строки, конвертор man в куда хочешь, включая html).