
私はman
ページを編集する方法を学んでいます。ソースファイルのSEE ALSOセクションが別々の行(1つの長い行で示されているman
)で構成されていることを確認しました。これは言いますか?それとも長い参照リストを1行に入れることができますか?
PS簡単な関連質問は主な質問と一緒に行われます(無視してもよい)。一部のソースファイルでは、行はgrep
「、」()で終わり、一部はそうではありませんcgcreate
。.BR
()で始まるか、()で始まらgrep
ないcgcreate
。インデントに加えて他に何かありますか?
答え1
参照を別々の行に保持することの価値は、参照が追加または削除されたときに毎回行全体を再処理するのではなく、独自の変更が発生することです。
私のアドバイスは従うということですマンページプロジェクトルール:
関連マニュアルページのカンマ区切りリストで、その後に他の関連ページまたは文書が続くことがあります。
リストは章番号でソートし、名前でアルファベット順にソートする必要があります。このリストをピリオドで終わらないでください。
.BR
使用時には、マニュアルページのタイトルは太字で表示されますが、セクションは太字ではありません。