Jedinej zpusob ktery se mi kdy pro seriozni cli aplikace na dlouhy beh osvedcil je to secko generovat z jedinyho source. tzn:
pgm -h/--help (+ -v/--verhose pro vetsi info) generuje plaintext help. A umi navic generovat i man formatted text, ktery napriklad behem buildu spusti sam sebe (ve sve verzi) a vygeneruje do release tarballu manpage. Pridat generovani reame.md a pouzit hod do release docu/titulnmi stranku projektu je jednoducha tresnicka na dortu. Jednotlive readme se muzo malinko lisit. Vetsinou man page vychazi na ten -h ve verbose mode, a readme.md na -h ve -vvv (very verbose mode).
Jednou to pridam no jcmd a clapu....