2015-03-05 0:56 GMT+01:00 <sl@9front.org>:

> > And btw, programs don't write man pages... yet.
>
> Are you familiar with the conventions that power godoc?
>

No, but I know quite well it's predecessors (Docstrings, Javadoc etc...).

They are great for API, but IMHO not every unix man page can be generated
from code. They are a specialized kind of prose.

What I can't undestand I why we still need troff for them.

It's almost like using a teletype to chat! :-)


Giacomo