А чем вы делаете man-странички?

Как вариант генерить ман `help2man(1)`, а нормальные доки писать в текинфо.

manedit

>в mcedit - показалось муторно

омг.

>Как принято правильно это делать?

(or vim emacs)

docbook/SGML(iproute2), xmlto(linux kernel man 8), xsltproc(valgrind man/doc/html), ручками(нуегонах), texinfo скорее для info.

Полазьте сами по системам контроля версий проектов, понравившихся по оформлению man :]. Если найдете что-то лёгкое и удобное в сопровождении - буду рад услышать.