マニュアルページの書き方は？
マニュアルページを書くにはどうすればいいですか？
すべてのフォーマットコードのリファレンスはどこにありますか？
Manページの作成に関する優れたチュートリアルはありますか？
Manページを書く最も便利な方法は何ですか？テキストエディターに直接入力する必要がありますか？ WYSIWYGエディタはありますか？または、別の形式で書き込んでから変換する必要がありますか？
良いmanページはどのルールに従うべきですか？
ここにあなたが始めるのに役立ついくつかのウェブページがあります：
いくつかの便利なツール：
Troffフォーマットをバイパスするmanページを書くためのツールがあります。マンページは小さくて区切られた言語であり、簡単にターゲティングできます。
2つの一般的なツールは次のとおりです。
- xmltoman 、マンページとhtmlを生成できる、小さくて構造化されたxml言語。 Lennart Poetteringのプロジェクトで使用されています syrep および たとえば、pulseaudio 。
- asciidoc 、 たとえばgitで使用される 。
yodl と zoem は、この分野では他の素晴らしい形式のようです。
概して、xmltomanはマンページ固有のdslであるため、詳しく説明します。
私はトピックについてかなり広範囲のブログ記事を書きました、あなたはここで見つけることができます：
ronn project を見てください。その markdown からmanページジェネレータ。 this のように、HTMLでmanページを生成することもできます。
ソフトウェアのドキュメントをすべて1つの形式で書くのが好きです。 Markdown IMOは良い選択です
IDEやチュートリアルは知りませんが、まずは既存のmanページをコピーして、ニーズに合わせて修正することができます。
MANマクロ（manページで使用されているもの）でのgroff言語のリファレンスについては、groff_manマニュアルページ、または ここからオンラインで読む