Hi,
I have prepared a patch to show how we could integrate/write man pages in asciidoc[1], a textual format which is simpler to use than troff. The patch contains abrt-action-mailx manpage which I just wrote.
Git uses this format, and its manpages are good source for finding usage examples.
Karel
[1] http://www.methods.co.nz/asciidoc/
-- Karel Klíč kklic@redhat.com Developer, package maintainer
Office: +420 532 294 128 Mobile: +420 776 196 877 Red Hat Inc. http://cz.redhat.com