mdocのマンページのセクションは何を参照していますか?

mdocのマンページのセクションは何を参照していますか?

だから私はプロジェクトのマンページを書こうと思って、ついにこれを見つけました。mdoc マニュアルページ。とりわけ、以下を含むマンページの一般的なレイアウトについて説明します。

   .\" .Sh CONTEXT
   .\" For section 9 functions only.
   .\" .Sh IMPLEMENTATION NOTES
   .\" Not used in OpenBSD.
   .\" .Sh RETURN VALUES
   .\" For sections 2, 3, and 9 function return values only.
   .\" .Sh ENVIRONMENT
   .\" For sections 1, 6, 7, and 8 only.

しかし、この1、6、7、8節が実際に何を指しているのか理解できませんか。私の推測では、マニュアルのページ(例:システムコールの2ページ)のようですが、あまり意味がありません。なぜ1ページの戻り値ではないのですか?

ベストアンサー1

参照されたマニュアルページが実際にどのように見えるかを確認してください。文書(7)。これは、マンページコレクションのセクション7から取得したことを意味します。「様々な種類」。すべてのマニュアルページが完全な本である場合、これらのセクションは章と見なされます。

RETURN VALUESこれは、セクション2、3、または9に配置するマニュアルページを作成していることを確認する必要があることを意味します。

一般的なコマンドはセクション1にあります。LS(1)そして裏(1)(どちらもオペレーティングシステムに付属しています)。ただし、外部プロジェクトは通常同じマッピングを使用します。ポストグレス(1)そしてMySQL(1)。後者は関連ページを参照しないので、マニュアルページのあまり良い例ではありません。その後、最終的にオンラインで検索します。ページ。そんな人にならないでください!

バラよりセクション13.2。カテゴリの列挙です。

全体(そして簡単)第13章 マニュアルページマニュアルページの代わりに、より高度な紹介が提供されることがあります。

人々がよく見逃すもう一つの上級ページは、はじめに(7)。私の考えでは、これは本の最初のページだと思います。人々は「本」。各部に紹介する各セクションを説明するページ:

数値カテゴリ

  1. 一般的なコマンド
  2. システムコール
  3. ライブラリ機能
  4. カーネルインタフェース
  5. ファイル形式
  6. ゲーム
  7. 様々な種類
  8. システム管理者
  9. カーネル開発者

おすすめ記事