文章を書いています対話型シェルユーティリティman
(これはbashスクリプトです。)ここにページを提供したいと思います。これはPATH
スーパーユーザー権限を必要とするスクリプトではなく、ユーザーがダウンロードして挿入したいスクリプトです。マニュアルページをどこに置くべきか知っていますか?
現在、スクリプトの横に配置し、スクリプト内のユーティリティ内dirname $0
で検索や表示などの機能を使用できます。しかし、も提供する方が良いでしょうman
。現在はお勧めman -l /path/to/script/help.1
ですが、厄介で直感的ではありません。
メモ:私はこれを見つけました前の質問しかし、許可された答えが実際に質問に正しく答えていないようです。
答え1
私が知る限り、ユーザーが書くことができるマニュアルページディレクトリに対する標準的な推奨事項はありません。ファイルシステム階層標準3.0おすすめXDGの基本ディレクトリ仕様そしてxdg-user-dirs 仕様ユーザーのホームディレクトリの内容について説明しますが、これらのいずれもマニュアルページディレクトリの内容については具体的に説明しません。
通常、これは環境変数に独自のマニュアルページディレクトリツリーを追加するのは簡単ではなかったMANPATH
ためです。ただし、最新の実装では通常、変数を空白のままにして、次の設定ファイルman
でMANPATH
マニュアルページディレクトリ階層を指定します。/etc/manpath.config
以前のバージョンとの互換性のために、これらの最新の実装MANPATH
に対して変数を設定すると、man
次の傾向があります。書くメソッドを提供するのではなく、完全なマニュアルページ検索パス次へ追加これは不便かもしれません。ユーザーは適切な設定ファイルを読み、理解し、保存する予定のすべてのシステムマニュアルページを正確に含むMANPATH値を生成し、カスタムマニュアルページディレクトリを次の場所に追加する必要があります。この注文リスト。ただし、システムソフトウェアおよび/またはディレクトリ構造への主要な更新がない限り、通常、これは一度だけ実行する必要があるため、実行しないでください。それするのは難しいです。
PATH
全体的に、(に追加するのに適した)実行可能ファイルのディレクトリがまたはにある場合は、対応する<some path>/bin/
マニュアル<some path>/sbin/
ページ階層のルートが<some path>/man/
それぞれにあることが古典的な慣例のようです。しかし、フライング3.0/usr/share/man/
これは、システムのデフォルトのマニュアルページ階層(実行可能ディレクトリに相当)を指定することによって/[s]bin/
外れました/usr/[s]bin/
。