知りたいです。マクロパッケージを使用してUNIXのマニュアルページを作成するには、(章のタイトル)と(セクション)がman
あります。しかし、「サブセクション」をしたい場合はどうすればよいですか?.SH
.SS
そんな基準がありますか?一部のページで(少なくともtroff
)のフォントサイズを変更するのを見たようですが、.SS
実際には(準)標準があるかどうか疑問に思います。
ベストアンサー1
私は短い答えが「いいえ」と信じています。マニュアルページにはサブセクションの標準はありません。
この問題は昨年9月に発生しました。メーリングリストlinux-man
、多くの資料が選別されていますが、man
そうすることが許されるイディオムを知っている人は誰もいません。
私が強調したいのは「必要ならマニュアルページ、[その後]ページ全体のディスカッションレベルがあまりにも概略的です。 「マンページを複数の文書に分割することを禁止する方法はありません。これがgroffとPerlがすることです。
でもオリジナルman
マクロパッケージのマニュアルページ(1979)分割されたマクロも記録せずにドアから出ましたSS
。
私にとって、これらの(意図的な?)監督は、「簡潔な」文書というマニュアルページの元の概念と一致するようです。
あなたがこれをしなければならないなら、私はあなた自身のマクロを書いたり、スレッドTP
で議論したようにそれを乱用しないでしょうlinux-man
。おそらく「インポートヘッダー」を使用します。つまり、タイトルで始まる段落をイタリック体または太字で表示します。
.P
.B Error handling.
The Z language does not support an exception mechanism.
Therefore you have to check return values at every point blah blah blah