Unixコマンドのドキュメントを提供していますか？

Question

WordファイルをMacからUnixに変換するmacmac2unixというUnixコマンドを作成しました。

私のコマンドのドキュメントを提供するにはどうすればよいですか？ 私はPerl's POD formatをお勧め男

$man macmac2unix 

Answer 1

と私のコマンドについて読みたいです。この名前にもかかわらず、Perlスクリプトの外で使うことができます。pod2manコマンドはOS Xに同梱されています。troffよりもはるかに賢明です。 Markdownを思い出させる。

ここにはexample pod documentとconversion scriptがあります。

Answer 2

Unixコマンドのドキュメントを提供するために、明らかにDocBookも使用できます。