推奨されるユーザー書き込み可能なマンパスは何ですか?

推奨されるユーザー書き込み可能なマンパスは何ですか?

文章を書いています対話型シェルユーティリティman(これはbashスクリプトです。)ここにページを提供したいと思います。これはPATHスーパーユーザー権限を必要とするスクリプトではなく、ユーザーがダウンロードして挿入したいスクリプトです。マニュアルページをどこに置くべきか知っていますか?

現在、スクリプトの横に配置し、スクリプト内のユーティリティ内dirname $0で検索や表示などの機能を使用できます。しかし、も提供する方が良いでしょうman。現在はお勧めman -l /path/to/script/help.1ですが、厄介で直感的ではありません。

メモ:私はこれを見つけました前の質問しかし、許可された答えが実際に質問に正しく答えていないようです。

答え1

私が知る限り、ユーザーが書くことができるマニュアルページディレクトリに対する標準的な推奨事項はありません。ファイルシステム階層標準3.0おすすめXDGの基本ディレクトリ仕様そしてxdg-user-dirs 仕様ユーザーのホームディレクトリの内容について説明しますが、これらのいずれもマニュアルページディレクトリの内容については具体的に説明しません。

通常、これは環境変数に独自のマニュアルページディレクトリツリーを追加するのは簡単ではなかったMANPATHためです。ただし、最新の実装では通常、変数を空白のままにして、次の設定ファイルmanMANPATHマニュアルページディレクトリ階層を指定します。/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/

答え2

コマンドラインにある場合は、マンページを確認してくださいman

man man

マンページは通常、次の場所に保存されます。11月/usr/share/man などのディレクトリに書式を設定します。

関連情報