.\" Updated 2008-08-09, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>, LDP v3.05
.\"
.TH MAN-PAGES 7 2008-10-28 "Linux" "Linux Programmer's Manual"
-.SH ̾Á°
-man-pages \- Linux ¤Î man ¥Ú¡¼¥¸¤ò½ñ¤¯ºÝ¤Î·è¤Þ¤ê»ö
-.SH ½ñ¼°
+.SH 名前
+man-pages \- Linux の man ページを書く際の決まり事
+.SH 書式
.B man
.RI [ section ]
.I title
-.SH ÀâÌÀ
-¤³¤Î¥Ú¡¼¥¸¤Ç¤Ï¡¢
-Linux \fIman-pages\fP ¥×¥í¥¸¥§¥¯¥È¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ò½ñ¤¯ºÝ¤Ë
-½¾¤¦¤Ù¤·è¤Þ¤ê»ö¤Ë¤Ä¤¤¤ÆÀâÌÀ¤¹¤ë¡£
-Linux \fIman-pages\fP ¤Ï Linux ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î
-¥»¥¯¥·¥ç¥ó 2, 3, 4, 5, 7 ¤«¤é¹½À®¤µ¤ì¤Æ¤¤¤ë¡£
-¤³¤Î¥Ú¡¼¥¸¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë·è¤Þ¤ê»ö¤Ï¡¢Â¾¤Î¥×¥í¥¸¥§¥¯¥È¤Î
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ò½ñ¤¯ºî¼Ô¤Ë¤âÌòΩ¤Ä¤³¤È¤À¤í¤¦¡£
-.SS ¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥»¥¯¥·¥ç¥ó
+.SH 説明
+このページでは、
+Linux \fIman-pages\fP プロジェクトのマニュアルページを書く際に
+従うべき決まり事について説明する。
+Linux \fIman-pages\fP は Linux のマニュアルページの
+セクション 2, 3, 4, 5, 7 から構成されている。
+このページで説明されている決まり事は、他のプロジェクトの
+マニュアルページを書く作者にも役立つことだろう。
+.SS マニュアルページのセクション
.PP
-¥Þ¥Ë¥å¥¢¥ë¤Î¥»¥¯¥·¥ç¥ó¤Ï¡¢½¬´·Åª¤Ë°Ê²¼¤Î¤è¤¦¤ÊÄêµÁ¤¬ÍѤ¤¤é¤ì¤Æ¤¤¤ë:
+マニュアルのセクションは、習慣的に以下のような定義が用いられている:
.TP 10
-.B 1 ¥³¥Þ¥ó¥É (¥×¥í¥°¥é¥à)
-¥·¥§¥ë¤ÎÃ椫¤é¥æ¡¼¥¶¤¬¼Â¹Ô¤Ç¤¤ë¥³¥Þ¥ó¥É¡£
+.B 1 コマンド (プログラム)
+シェルの中からユーザが実行できるコマンド。
.TP
-.B 2 ¥·¥¹¥Æ¥à¥³¡¼¥ë
-¥«¡¼¥Í¥ë¤¬½èÍý¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤´Ø¿ô¡£
+.B 2 システムコール
+カーネルが処理しなければならない関数。
.TP
-.B 3 ¥é¥¤¥Ö¥é¥ê¥³¡¼¥ë
+.B 3 ライブラリコール
.I libc
-¤Î´Ø¿ô¤ÎÂçÉôʬ¡£
+の関数の大部分。
.TP
-.B 4 ¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë (¥Ç¥Ð¥¤¥¹)
+.B 4 ã\82¹ã\83\9aã\82·ã\83£ã\83«ã\83\95ã\82¡ã\82¤ã\83« (ã\83\87ã\83\90ã\82¤ã\82¹)
.I /dev
-°Ê²¼¤Ë¤¢¤ë¥Õ¥¡¥¤¥ë¡£
+以下にあるファイル。
.TP
-.B 5 ¥Õ¥¡¥¤¥ë¤Î¥Õ¥©¡¼¥Þ¥Ã¥È¤Èµ¬Ìó
+.B 5 ファイルのフォーマットと規約
.I /etc/passwd
-¤Ê¤É¤Î¿Í¤¬Æɤá¤ë¥Õ¥¡¥¤¥ë¤Î¥Õ¥©¡¼¥Þ¥Ã¥È¡£
+などの人が読めるファイルのフォーマット。
.TP
-.B 6 ¥²¡¼¥à
+.B 6 ゲーム
.TP
-.B 7 Ìó«»ö¤½¤Î¾
-ÍÍ¡¹¤Ê»öÊÁ¤Î³µÍס¢´·½¬¡¢¥×¥í¥È¥³¥ë¡¢Ê¸»ú½¸¹ç¤Îµ¬³Ê¡¢¤½¤Î¾»¨Â¿¤Ê¤³¤È¡£
+.B 7 約束事その他
+様々な事柄の概要、慣習、プロトコル、文字集合の規格、その他雑多なこと。
.TP
-.B 8 ¥·¥¹¥Æ¥à´ÉÍý¥³¥Þ¥ó¥É
+.B 8 システム管理コマンド
.BR mount (8)
-¤Î¤è¤¦¤Ê root ¤Î¤ß¤¬¼Â¹Ô²Äǽ¤Ê¥³¥Þ¥ó¥É¡£
+のような root のみが実行可能なコマンド。
.\" .TP
-.\" .B 9 ¥«¡¼¥Í¥ë¥ë¡¼¥Á¥ó
-.\" ¤³¤Î¥Þ¥Ë¥å¥¢¥ë¥»¥¯¥·¥ç¥ó¤ÏÇѻߤµ¤ì¤¿¡£
-.\" ¤«¤Ä¤Æ¤Ï¤³¤³¤Ë Linux ¥«¡¼¥Í¥ë¤Î¥É¥¥å¥á¥ó¥È¤òÃÖ¤¯¤Î¤¬Îɤ¤¤³¤È¤À¤È
-.\" ¹Í¤¨¤é¤ì¤Æ¤¤¤¿¡£¤·¤«¤·¡¢Ê¸½ñ²½¤µ¤ì¤¿¤â¤Î¤ÏÈó¾ï¤Ë¾¯¤Ê¤¯¡¢
-.\" ¤Þ¤¿¤½¤ì¤é¤â¤¹¤Ç¤Ë¸Å¤¤¤â¤Î¤È¤Ê¤Ã¤Æ¤·¤Þ¤Ã¤¿¡£
-.\" ¥«¡¼¥Í¥ë³«È¯¼Ô¤Ë¤È¤Ã¤Æ¡¢¤â¤Ã¤È¤è¤¤¾ðÊ󸻤¬Â¾¤Ë¤¢¤ë¤À¤í¤¦¡£
-.SS ¥Þ¥¯¥í¥Ñ¥Ã¥±¡¼¥¸
-¿·¤·¤¤¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ï
+.\" .B 9 カーネルルーチン
+.\" このマニュアルセクションは廃止された。
+.\" かつてはここに Linux カーネルのドキュメントを置くのが良いことだと
+.\" 考えられていた。しかし、文書化されたものは非常に少なく、
+.\" またそれらもすでに古いものとなってしまった。
+.\" カーネル開発者にとって、もっとよい情報源が他にあるだろう。
+.SS ã\83\9eã\82¯ã\83ã\83\91ã\83\83ã\82±ã\83¼ã\82¸
+新しいマニュアルページは
.BR man (7)
-¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë
+で説明されている
.B groff an.tmac
-¥Ñ¥Ã¥±¡¼¥¸¤ò»È¤Ã¤Æµ½Ò¤¹¤Ù¤¤Ç¤¢¤ë¡£
-¤³¤ÎÊý¿Ë¤Ï°ì´ÓÀ¤Î³ÎÊݤ¬¼ç¤ÊÍýͳ¤Ç¤¢¤ë¡£´û¸¤Î Linux ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸
-¤Î°µÅÝŪ¿¿ô¤¬¤³¤ì¤é¤Î¥Þ¥¯¥í¤ò»È¤Ã¤Æµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
-.SS ¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤ÎÇÛÃ֤˴ؤ¹¤ë·è¤Þ¤ê»ö
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥½¡¼¥¹¥³¡¼¥É¤Î 1¹Ô¤ÎŤµ¤Ï
-²Äǽ¤Ê¸Â¤ê 75ʸ»ú¤ò±Û¤¨¤Ê¤¤¤è¤¦¤Ë¤·¤Æ¤Û¤·¤¤¡£
-¤³¤¦¤¹¤ë¤³¤È¤Ç¡¢¥Ñ¥Ã¥Á¤ò¥á¡¼¥ëËÜʸ¤ËºÜ¤»¤ÆÁ÷¤ë¾ì¹ç¤Ë¡¢
-¥á¡¼¥ë¥¯¥é¥¤¥¢¥ó¥È¤Ë¤è¤ë¹ÔÀÞ¤êÊÖ¤·¤ò²óÈò¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
+パッケージを使って記述すべきである。
+ã\81\93ã\81®æ\96¹é\87\9dã\81¯ä¸\80貫æ\80§ã\81®ç¢ºä¿\9dã\81\8c主ã\81ªç\90\86ç\94±ã\81§ã\81\82ã\82\8bã\80\82æ\97¢å\98ã\81® Linux ã\81®ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\83\9aã\83¼ã\82¸
+の圧倒的多数がこれらのマクロを使って記述されている。
+.SS ソースファイルの配置に関する決まり事
+マニュアルページのソースコードの 1行の長さは
+可能な限り 75文字を越えないようにしてほしい。
+こうすることで、パッチをメール本文に載せて送る場合に、
+メールクライアントによる行折り返しを回避することができる。
-¿·¤·¤¤Ê¸¤Ï¹ÔƬ¤«¤é³«»Ï¤¹¤ë¡£
-¤³¤ì¤Ë¤è¤ê¡¢¥Ñ¥Ã¥Á¤ÎÆâÍƤò³Îǧ¤·¤ä¤¹¤¯¤Ê¤ë¡£
-¥Ñ¥Ã¥Á¤Ïʸñ°Ì¤Ç¤¢¤ë¤³¤È¤¬Â¿¤¤¤«¤é¤Ç¤¢¤ë¡£
-.SS ¥¿¥¤¥È¥ë¹Ô
-man ¥Ú¡¼¥¸¤ÎºÇ½é¤Î¹Ô¤Ï \fBTH\fP ¥³¥Þ¥ó¥É¤Ë¤¹¤Ù¤¤Ç¤¢¤ë¡£
+新しい文は行頭から開始する。
+これにより、パッチの内容を確認しやすくなる。
+パッチは文単位であることが多いからである。
+.SS タイトル行
+man ページの最初の行は \fBTH\fP コマンドにすべきである。
.RS
.sp
.B \&.TH
.I "title section date source manual"
.sp
.RE
-¸Ä¡¹¤ÎÀâÌÀ:
+個々の説明:
.RS
.TP 10
.I title
-man ¥Ú¡¼¥¸¤Î¥¿¥¤¥È¥ë¡£Á´ÉôÂçʸ»ú¤ÇµºÜ¤¹¤ë (Îã:
-.IR MAN-PAGES )¡£
+man ページのタイトル。全部大文字で記載する (例:
+.IR MAN-PAGES )。
.TP
.I section
-man ¥Ú¡¼¥¸¤¬Â°¤¹¤ë¥»¥¯¥·¥ç¥óÈÖ¹æ (Îã:
-.IR 7 )¡£
+man ページが属するセクション番号 (例:
+.IR 7 )。
.TP
.I date
-ºÇ¿·¤Î¥ê¥Ó¥¸¥ç¥ó¤ÎÆüÉÕ\(emman ¥Ú¡¼¥¸¤ËÊѹ¹¤ò²Ã¤¨¤¿¤È¤¤Ë¤Ï
-ɬ¤º¤³¤ì¤òÊѹ¹¤¹¤ë¤³¤È¡£
-¤³¤ì¤¬ºÇ¤â°ìÈÌŪ¤Ê¥Ð¡¼¥¸¥ç¥ó´ÉÍýÊýË¡¤Ç¤¢¤ë¡£
-ÆüÉÕ¤Ï YYYY-MM-DD ¤Î·Á¼°¤ÇµºÜ¤¹¤Ù¤¤Ç¤¢¤ë¡£
+最新のリビジョンの日付\(emman ページに変更を加えたときには
+必ずこれを変更すること。
+これが最も一般的なバージョン管理方法である。
+日付は YYYY-MM-DD の形式で記載すべきである。
.TP
.I source
-¥³¥Þ¥ó¥É¡¢´Ø¿ô¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î½Ð¼«¡£
+コマンド、関数、システムコールの出自。
-¿ô¾¯¤Ê¤¤¥»¥¯¥·¥ç¥ó 1 ¤È 8 ¤Î¥Ú¡¼¥¸¤Î¾ì¹ç¡¢¤ª¤½¤é¤¯Ã±¤Ë
+数少ないセクション 1 と 8 のページの場合、おそらく単に
.I GNU
-¤È¤À¤±½ñ¤¯¤³¤È¤¬Â¿¤¤¤À¤í¤¦¡£
+とだけ書くことが多いだろう。
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤Î¾ì¹ç¡¢Ã±¤Ë
+システムコールの場合、単に
.I "Linux"
-¤È¤À¤±½ñ¤¯¡£
-(°ÊÁ°¤Î´·½¬¤Ç¤Ï¡¢¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤òµºÜ¤·¤¿/ÆâÍƤò³Îǧ¤·¤¿¥«¡¼¥Í¥ë¤Î
-¥Ð¡¼¥¸¥ç¥óÈÖ¹æ¤òµºÜ¤·¤Æ¤¤¤¿¡£¤·¤«¤·¡¢¥Ð¡¼¥¸¥ç¥óÈֹ椬¼ÂºÝ¤ÎÆâÍƤÈ
-°ìÃפ·¤Æ¤¤¤ë¤³¤È¤Ï¤Ê¤¯¡¢¤½¤Î¤¿¤á¥Ð¡¼¥¸¥ç¥óÈֹ椬¤Ê¤¤¤è¤ê¤â
-¤ª¤½¤é¤¯°¤¤·Á¤Ë¤Ê¤Ã¤Æ¤¤¤¿¡£
-º£¸å¤Ï¡¢¥Ð¡¼¥¸¥ç¥óÈÖ¹æ¤ò´Þ¤á¤ë¤Î¤ÏÈò¤±¤ë¤³¤È¡£)
+とだけ書く。
+(以前の慣習では、マニュアルページを記載した/内容を確認したカーネルの
+バージョン番号を記載していた。しかし、バージョン番号が実際の内容と
+一致していることはなく、そのためバージョン番号がないよりも
+おそらく悪い形になっていた。
+今後は、バージョン番号を含めるのは避けること。)
-glibc ¤Î¥é¥¤¥Ö¥é¥ê¥³¡¼¥ë¤ä
-¤½¤Î¾¤Î°ìÈÌŪ¤Ê GNU ¥é¥¤¥Ö¥é¥ê¤Î¥é¥¤¥Ö¥é¥ê¥³¡¼¥ë¤Î¾ì¹ç¡¢
-ñ¤Ë
+glibc のライブラリコールや
+その他の一般的な GNU ライブラリのライブラリコールの場合、
+単に
.IR "GNU C Library" ", " GNU
-¤È½ñ¤¯¤«¡¢¶õ¤Îʸ»úÎó¤ò»È¤¦¡£
+と書くか、空の文字列を使う。
-¥»¥¯¥·¥ç¥ó 4 ¤Î¥Ú¡¼¥¸¤Ç¤Ï
+セクション 4 のページでは
.I "Linux"
-¤ò»È¤¦¡£
+を使う。
-¤è¤¯¤ï¤«¤é¤Ê¤¤¾ì¹ç¤Ï¡¢
+よくわからない場合は、
.I Linux
-¤È¤«
+とか
.I GNU
-¤È½ñ¤¤¤Æ¤ª¤¯¡£
+と書いておく。
.TP
.I manual
-¥Þ¥Ë¥å¥¢¥ë¤Î¥¿¥¤¥È¥ë (Îã:
-\fIman-pages\fP ¥Ñ¥Ã¥±¡¼¥¸¤Î¥»¥¯¥·¥ç¥ó 2 ¤ª¤è¤Ó 3 ¤Î¥Ú¡¼¥¸¤Î¾ì¹ç¤Ë¤Ï¡¢
+マニュアルのタイトル (例:
+\fIman-pages\fP パッケージのセクション 2 および 3 のページの場合には、
.I "Linux Programmer's Manual"
-¤ò»È¤¦¤³¤È)¡£
+を使うこと)。
.RE
-.SS ¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥»¥¯¥·¥ç¥ó
-ÀΤ«¤é»È¤ï¤ì¤Æ¤¤¿¥»¥¯¥·¥ç¥ó̾¤ò°Ê²¼¤Î¥ê¥¹¥È¤Ë¼¨¤¹¡£
-¤³¤ì¤é¤ò»È¤¦¤ÈÎɤ¤¤À¤í¤¦¡£
-°ìÈÌŪ¤Ë¡¢¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ï¡¢¾¯¤Ê¤¯¤È¤â
-.B ¿§¤Ä¤
-¤Î¥»¥¯¥·¥ç¥ó¤ò»ý¤Ä¤Î¤¬Ë¾¤Þ¤·¤¤¡£
-¿·¤·¤¯¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤òºîÀ®¤¹¤ëºÝ¤Ë¤Ï¡¢¤À¤¤¤¿¤¤°Ê²¼¤Î¥ê¥¹¥È¤Ë¼¨¤·¤¿
-½ç½ø¤Ç¥»¥¯¥·¥ç¥ó¤òÇÛÃÖ¤¹¤ë¤è¤¦¤Ë¤·¤Æ¤â¤é¤¤¤¿¤¤¡£
+.SS マニュアルページのセクション
+昔から使われてきたセクション名を以下のリストに示す。
+これらを使うと良いだろう。
+一般的に、マニュアルページは、少なくとも
+.B 色つき
+のセクションを持つのが望ましい。
+新しくマニュアルページを作成する際には、だいたい以下のリストに示した
+順序でセクションを配置するようにしてもらいたい。
.in +0.5i
.nf
-\fB̾Á°\fP
-\fB½ñ¼°\fP
-ÀßÄê [Ä̾ï¤Ï¥»¥¯¥·¥ç¥ó 4 ¤Î¤ß]
-\fBÀâÌÀ\fP
-¥ª¥×¥·¥ç¥ó [Ä̾ï¤Ï¥»¥¯¥·¥ç¥ó 1, 8 ¤Î¤ß]
-½ªÎ»¥¹¥Æ¡¼¥¿¥¹ [Ä̾ï¤Ï¥»¥¯¥·¥ç¥ó 1, 8 ¤Î¤ß]
-ÊÖ¤êÃÍ [Ä̾ï¤Ï¥»¥¯¥·¥ç¥ó 2, 3 ¤Î¤ß]
+\fB名前\fP
+\fB書式\fP
+設定 [通常はセクション 4 のみ]
+\fB説明\fP
+オプション [通常はセクション 1, 8 のみ]
+終了ステータス [通常はセクション 1, 8 のみ]
+返り値 [通常はセクション 2, 3 のみ]
.\" May 07: Few current man pages have an ERROR HANDLING section,,,
-.\" ¥¨¥é¡¼½èÍý
-¥¨¥é¡¼ [¤¿¤¤¤Æ¤¤¤Ï¥»¥¯¥·¥ç¥ó 2, 3 ¤Î¤ß]
+.\" エラー処理
+エラー [たいていはセクション 2, 3 のみ]
.\" May 07: Almost no current man pages have a USAGE section,,,
-.\" ÍøÍÑË¡
-.\" ¿ÇÃÇ¥á¥Ã¥»¡¼¥¸
+.\" 利用法
+.\" 診æ\96ã\83¡ã\83\83ã\82»ã\83¼ã\82¸
.\" May 07: Almost no current man pages have a SECURITY section,,,
-.\" ¥»¥¥å¥ê¥Æ¥£
-´Ä¶ÊÑ¿ô
-¥Õ¥¡¥¤¥ë
-¥Ð¡¼¥¸¥ç¥ó [Ä̾ï¤Ï¥»¥¯¥·¥ç¥ó 2, 3 ¤Î¤ß]
-½àµò
-Ãí°Õ/È÷¹Í
-¥Ð¥°
-Îã
-.\" Ãø¼Ô ¥»¥¯¥·¥ç¥ó¤ÏÈó¿ä¾©¤Ç¤¢¤ë
-.\" Ãø¼Ô
-\fB´ØÏ¢¹àÌÜ\fP
+.\" ã\82»ã\82ã\83¥ã\83ªã\83\86ã\82£
+環境変数
+ファイル
+バージョン [通常はセクション 2, 3 のみ]
+準拠
+注意/備考
+ã\83\90ã\82°
+例
+.\" 著者 セクションは非推奨である
+.\" 著者
+\fB関連項目\fP
.fi
.in
-¡ÖÅÁÅýŪ¤Ë»È¤ï¤ì¤Æ¤¤¿¸«½Ð¤·¤¬»È¤¨¤ë¾ì¹ç¤Ë¤Ï¡¢¤½¤ì¤ò»È¤Ã¤Æ¤Û¤·¤¤¡£¡×
-¤³¤Î¼ï¤Î°ì´ÓÀ¤òÊݤĤ³¤È¤Ç¡¢¾ðÊó¤òÍý²ò¤·¤ä¤¹¤¯¤Ê¤ë¤«¤é¤Ç¤¢¤ë¡£
-¤É¤¦¤·¤Æ¤âɬÍפʾì¹ç¤Ë¤Ï¡¢Íý²ò¤·¤ä¤¹¤¯¤Ê¤ë¤è¤¦¤ËÆȼ«¤Î¸«½Ð¤·¤ò
-ºî¤Ã¤Æ¤â¤è¤¤ (Æä˥»¥¯¥·¥ç¥ó 4 ¤ä 5 ¤Î¥Ú¡¼¥¸¤Ç¤Ï¤³¤¦¤·¤¿Êý¤¬
-¤ï¤«¤ê¤ä¤¹¤¯¤Ê¤ë)¡£¤¿¤À¤·¡¢¤½¤¦¤¹¤ëÁ°¤Ë¡¢ÅÁÅýŪ¤Ê¸«½Ð¤·¤ò»È¤¤¡¢
-¤½¤Î¥»¥¯¥·¥ç¥óÆâ¤Ë¥µ¥Ö¥»¥¯¥·¥ç¥ó (\fI.SS\fP) ¤òÀߤ±¤ë¤³¤È¤Ç
-Âбþ¤Ç¤¤Ê¤¤¤«¹Í¤¨¤Æ¤Û¤·¤¤¡£
+「伝統的に使われてきた見出しが使える場合には、それを使ってほしい。」
+この種の一貫性を保つことで、情報を理解しやすくなるからである。
+どうしても必要な場合には、理解しやすくなるように独自の見出しを
+作ってもよい (特にセクション 4 や 5 のページではこうした方が
+わかりやすくなる)。ただし、そうする前に、伝統的な見出しを使い、
+そのセクション内にサブセクション (\fI.SS\fP) を設けることで
+対応できないか考えてほしい。
-°Ê²¼¤Î¥ê¥¹¥È¤Ç¤Ï¡¢¾åµ¤Î¥»¥¯¥·¥ç¥ó¤Î¤½¤ì¤¾¤ì¤ÎÆâÍƤˤĤ¤¤Æ
-¾Ü¤·¤¯ÀâÌÀ¤¹¤ë¡£
+以下のリストでは、上記のセクションのそれぞれの内容について
+詳しく説明する。
.TP 14
-.B ̾Á° (NAME)
-¤½¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î̾Á°¡£
-\fB.SH NAME\fP ¥³¥Þ¥ó¥É¤Î¹Ô¤¬½¾¤¦¤Ù¤Âç»ö¤ÊÅÀ¤Ë¤Ä¤¤¤Æ¤Ï
+.B 名前 (NAME)
+そのマニュアルページの名前。
+\fB.SH NAME\fP コマンドの行が従うべき大事な点については
.BR man (7)
-¤ò»²¾È¤·¤Æ¤Û¤·¤¤¡£
-.TP
-.B ½ñ¼° (SYNOPSIS)
-¥³¥Þ¥ó¥É¤ä´Ø¿ô¤Î¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤ò´Ê·é¤Ëµ½Ò¤¹¤ë¡£
-¥³¥Þ¥ó¥É¤ËÂФ·¤Æ¤Ï¡¢¥³¥Þ¥ó¥É¤ä°ú¤¿ô (¥ª¥×¥·¥ç¥ó) ¤Îʸˡ¤ò½ñ¤¯¡£
-¤½¤Î¤Þ¤Þ½ñ¤¯¥Æ¥¥¹¥È¤Ë¤Ï¥Ü¡¼¥ë¥ÉÂΤòÍѤ¤¡¢ÃÖ¤´¹¤¨¤ë°ú¤¿ô¤Ë¤Ï
-¥¤¥¿¥ê¥Ã¥¯ÂΤòÍѤ¤¤ë¡£¾Êά²Äǽ¤Ê¥ª¥×¥·¥ç¥ó¤Ï¥Ö¥é¥±¥Ã¥È ([]) ¤Ç°Ï¤¤¡¢
-ÁªÂò»è¤Ï½ÄËÀ (|) ¤Ç¶èÀڤꡢ·«¤êÊÖ¤·¤Ë¤Ï¾ÊάÉä¹æ (...) ¤ò½ñ¤¯¡£
-´Ø¿ô¤ËÂФ·¤Æ¤Ï¡¢É¬Íפʥǡ¼¥¿Àë¸À¤ä
+を参照してほしい。
+.TP
+.B 書式 (SYNOPSIS)
+コマンドや関数のインターフェースを簡潔に記述する。
+コマンドに対しては、コマンドや引き数 (オプション) の文法を書く。
+そのまま書くテキストにはボールド体を用い、置き換える引き数には
+イタリック体を用いる。省略可能なオプションはブラケット ([]) で囲い、
+選択肢は縦棒 (|) で区切り、繰り返しには省略符号 (...) を書く。
+関数に対しては、必要なデータ宣言や
.B #include
-»ØÄê¤ò½ñ¤¡¢´Ø¿ôÀë¸À¤ò³¤±¤ë¡£
+指定を書き、関数宣言を続ける。
-¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤«¤é´Ø¿ô (¤äÊÑ¿ô) ¤ÎÄêµÁ¤òÆÀ¤ë¤¿¤á¤Ë
-µ¡Ç½¸¡ºº¥Þ¥¯¥í (feature test macro) ¤òÄêµÁ¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¾ì¹ç¡¢
-½ñ¼° (SYNOPSIS) ¤ËɬÍפʵ¡Ç½¸¡ºº¥Þ¥¯¥í¤òµºÜ¤¹¤Ù¤¤Ç¤¢¤ë¡£
-µ¡Ç½¸¡ºº¥Þ¥¯¥í¤Ë¤Ä¤¤¤Æ¤Ï
+ヘッダファイルから関数 (や変数) の定義を得るために
+機能検査マクロ (feature test macro) を定義しなければならない場合、
+書式 (SYNOPSIS) に必要な機能検査マクロを記載すべきである。
+機能検査マクロについては
.BR feature_test_macros (7)
-¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¡£
+で説明されている。
.\" FIXME . Say something here about compiler options
.TP
.B CONFIGURATION
-¥Ç¥Ð¥¤¥¹¤ÎÀßÄê¾ÜºÙ¡£
-Ä̾¤³¤Î¥»¥¯¥·¥ç¥ó¤Ï 4 ¾Ï¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç¤Î¤ßÅо줹¤ë¡£
-.TP
-.B ÀâÌÀ (DESCRIPTION)
-¥×¥í¥°¥é¥à¡¦´Ø¿ô¡¦¥Õ¥©¡¼¥Þ¥Ã¥È¤ÎÆ°ºî¡¦ÌÜŪ¤òÀâÌÀ¤¹¤ë¡£
-¥Õ¥¡¥¤¥ë¤äɸ½àÆþÎϤò¤É¤Î¤è¤¦¤Ë½èÍý¤·¡¢É¸½à½ÐÎϤäɸ½à¥¨¥é¡¼½ÐÎϤò
-¤É¤Î¤è¤¦¤ËÀ¸À®¤¹¤ë¤«¤È¤¤¤Ã¤¿¤³¤È¤Ë¤Ä¤¤¤Æ½Ò¤Ù¤ë¡£
-ÆâÉôÆ°ºî¤ä¼ÂÁõ¤Î¾ÜºÙ¤Ë¤Ä¤¤¤Æ¤Ï¾Êά¤¹¤ë
-(¤¿¤À¤·¤½¤ì¤¬Æ°ºî¤ÎÍý²ò¤Ë¤É¤¦¤·¤Æ¤âɬÍפʤéÊÌ)¡£
-Ä̾ï¤Î¾ì¹ç¤Ë¤Ä¤¤¤Æµ½Ò¤¹¤ë¡£
-¥×¥í¥°¥é¥à¤Î¥³¥Þ¥ó¥É¥é¥¤¥ó¡¦¥ª¥×¥·¥ç¥ó¤ÎÀâÌÀ¤Ë¤Ï¡¢
-.B ¥ª¥×¥·¥ç¥ó
-¤Î¥»¥¯¥·¥ç¥ó¤òÍѤ¤¤ë¡£
-.\" ÆþÎϤˤ¢¤ë¼ï¤Îʸˡ¤¬¤¢¤Ã¤¿¤ê¡¢Ê£»¨¤Ê¥µ¥Ö¥³¥Þ¥ó¥É¤¬¤¢¤ë¾ì¹ç¤Ï¡¢
-.\" ¤½¤ì¤é¤Ï
-.\" .B ÍøÍÑË¡
-.\" ¤Î¥»¥¯¥·¥ç¥ó¤ËʬΥ¤¹¤ë¤³¤È¤ò¹Í¤¨¤ë¤È¤è¤¤
-.\" .RB ( ÀâÌÀ
-.\" ¤Î¥»¥¯¥·¥ç¥ó¤Ë¤Ï³µÍפÀ¤±¤òÃÖ¤¯¤è¤¦¤Ë¤¹¤ë)¡£
-.TP
-.B ¥ª¥×¥·¥ç¥ó (OPTIONS)
-¥×¥í¥°¥é¥à¤¬¼õ¤±ÉÕ¤±¤ë¥³¥Þ¥ó¥É¥é¥¤¥ó¡¦¥ª¥×¥·¥ç¥ó¤È¡¢
-¤½¤Î¾ì¹ç¥×¥í¥°¥é¥à¤Î¿¶Éñ¤¤¤¬¤É¤¦ÊѤï¤ë¤«¤òÀâÌÀ¤¹¤ë¡£
-¤³¤Î¥»¥¯¥·¥ç¥ó¤Ï¥»¥¯¥·¥ç¥ó 1 ¤È 8 ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë¤À¤±Åо줹¤Ù¤¤Ç¤¢¤ë¡£
+デバイスの設定詳細。
+通常、このセクションは 4 章のマニュアルページでのみ登場する。
+.TP
+.B 説明 (DESCRIPTION)
+プログラム・関数・フォーマットの動作・目的を説明する。
+ファイルや標準入力をどのように処理し、標準出力や標準エラー出力を
+どのように生成するかといったことについて述べる。
+内部動作や実装の詳細については省略する
+(ただしそれが動作の理解にどうしても必要なら別)。
+通常の場合について記述する。
+プログラムのコマンドライン・オプションの説明には、
+.B オプション
+のセクションを用いる。
+.\" 入力にある種の文法があったり、複雑なサブコマンドがある場合は、
+.\" それらは
+.\" .B 利用法
+.\" のセクションに分離することを考えるとよい
+.\" .RB ( 説明
+.\" のセクションには概要だけを置くようにする)。
+.TP
+.B オプション (OPTIONS)
+プログラムが受け付けるコマンドライン・オプションと、
+その場合プログラムの振舞いがどう変わるかを説明する。
+このセクションはセクション 1 と 8 のマニュアルページにだけ登場すべきである。
.\" .TP
-.\" .B ÍøÍÑË¡ (USAGE)
-.\" ¥³¥Þ¥ó¥É¤Ê¤É¤¬¼ÂÁõ¤·¤Æ¤¤¤ëÉû¸À¸ì (sublanguage) ¤Îʸˡ¤òµ½Ò¤¹¤ë¡£
+.\" .B 利用法 (USAGE)
+.\" コマンドなどが実装している副言語 (sublanguage) の文法を記述する。
.TP
-.B ½ªÎ»¥¹¥Æ¡¼¥¿¥¹ (EXIT STATUS)
-¥×¥í¥°¥é¥à¤Î½ªÎ»¥¹¥Æ¡¼¥¿¥¹¤ÎÃͤȡ¢¤½¤ì¤é¤ÎÃͤËÂбþ¤¹¤ë¾õ¶·¤òÎóµó¤¹¤ë¡£
-¤³¤Î¥»¥¯¥·¥ç¥ó¤Ï¥»¥¯¥·¥ç¥ó 1 ¤È 8 ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë¤À¤±Åо줹¤Ù¤¤Ç¤¢¤ë¡£
+.B çµ\82äº\86ã\82¹ã\83\86ã\83¼ã\82¿ã\82¹ (EXIT STATUS)
+プログラムの終了ステータスの値と、それらの値に対応する状況を列挙する。
+このセクションはセクション 1 と 8 のマニュアルページにだけ登場すべきである。
.TP
-.B ÊÖ¤êÃÍ (RETURN VALUE)
-¥»¥¯¥·¥ç¥ó 2 ¤È 3 ¤Î¥Ú¡¼¥¸¤Î¾ì¹ç¡¢¤³¤Î¥»¥¯¥·¥ç¥ó¤Ë
-¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó¤¬¸Æ¤Ó½Ð¤·¸µ¤ËÊÖ¤¹ÃͤΥꥹ¥È¤òµºÜ¤¹¤ë¡£
-¤½¤ì¤é¤ÎÃͤ¬ÊÖ¤µ¤ì¤¿¾ì¹ç¤Î¾õÂÖ¤ËÂФ¹¤ëÀâÌÀ¤â½ñ¤¯¡£
+.B 返り値 (RETURN VALUE)
+セクション 2 と 3 のページの場合、このセクションに
+ライブラリルーチンが呼び出し元に返す値のリストを記載する。
+それらの値が返された場合の状態に対する説明も書く。
.TP
-.B ¥¨¥é¡¼ (ERRORS)
-¥»¥¯¥·¥ç¥ó 2 ¤È 3 ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç¤Ï¡¢
-¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ë
+.B ã\82¨ã\83©ã\83¼ (ERRORS)
+セクション 2 と 3 のマニュアルページでは、
+エラーが発生した場合に
.I errno
-¤ËÀßÄꤵ¤ì¤ë²ÄǽÀ¤¬¤¢¤ëÃͤΥꥹ¥È¤òµºÜ¤¹¤ë¡£
-¥ê¥¹¥È¤Ë¤Ï¡¢¥¨¥é¡¼¤ÎÃͤȥ¨¥é¡¼¤Î¸¶°ø¤Ë¤Ä¤¤¤Æ¤Î¾ðÊó¤ò½ñ¤¯¡£
-¡Ö¥¨¥é¡¼¥ê¥¹¥È¤Ï¥¢¥ë¥Õ¥¡¥Ù¥Ã¥È½ç¤Ë¤¹¤Ù¤¤Ç¤¢¤ë¡£¡×
-.TP
-.B ´Ä¶ÊÑ¿ô (ENVIRONMENT)
-¥×¥í¥°¥é¥à¤ä´Ø¿ô¤Ë±Æ¶Á¤¹¤ë´Ä¶ÊÑ¿ô¤ò¥ê¥¹¥È¤·¡¢¤½¤ì¤é¤Î¸ú²Ì¤ò½ñ¤¯¡£
-.TP
-.B ¥Õ¥¡¥¤¥ë (FILES)
-¥×¥í¥°¥é¥à¤ä´Ø¿ô¤¬ÍѤ¤¤ë¥Õ¥¡¥¤¥ë¤òÎ󵤹¤ë¡£
-Î㤨¤Ð¡¢ÀßÄê¥Õ¥¡¥¤¥ë¡¢µ¯Æ°¥Õ¥¡¥¤¥ë¡¢¥×¥í¥°¥é¥à¤¬Ä¾ÀÜÁàºî¤¹¤ë¥Õ¥¡¥¤¥ë¤Ê¤É¤Ç¤¢¤ë¡£
-¤³¤ì¤é¤Î¥Õ¥¡¥¤¥ë¤Î¥Õ¥¡¥¤¥ë̾¤Ï¥Õ¥ë¥Ñ¥¹¤ÇµºÜ¤·¡¢
-¥Ç¥£¥ì¥¯¥È¥ê¤ÎÉôʬ¤Ï¥æ¡¼¥¶¡¼¤Î¹¥¤ß¤Ë¹ç¤ï¤»¤Æ
-¥¤¥ó¥¹¥È¡¼¥ë½èÍý¤ÇÊѹ¹¤Ç¤¤ë¤è¤¦¤Ë¤¹¤ë¡£
-¿¤¯¤Î¥×¥í¥°¥é¥à¤Ç¤Ï¥Ç¥Õ¥©¥ë¥È¤Î¥¤¥ó¥¹¥È¡¼¥ëÀè¤Ï
+に設定される可能性がある値のリストを記載する。
+リストには、エラーの値とエラーの原因についての情報を書く。
+「エラーリストはアルファベット順にすべきである。」
+.TP
+.B 環境変数 (ENVIRONMENT)
+プログラムや関数に影響する環境変数をリストし、それらの効果を書く。
+.TP
+.B ファイル (FILES)
+プログラムや関数が用いるファイルを列記する。
+例えば、設定ファイル、起動ファイル、プログラムが直接操作するファイルなどである。
+これらのファイルのファイル名はフルパスで記載し、
+ディレクトリの部分はユーザーの好みに合わせて
+インストール処理で変更できるようにする。
+多くのプログラムではデフォルトのインストール先は
.I /usr/local
-¤Ç¤¢¤ë¡£¤·¤¿¤¬¤Ã¤Æ¥Ù¡¼¥¹¤È¤Ê¤ë¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç¤â
+である。したがってベースとなるマニュアルページでも
.I /usr/local
-¤¬»È¤ï¤ì¤Æ¤¤¤ë¤³¤È¤¬Â¿¤¤¤À¤í¤¦¡£
+が使われていることが多いだろう。
.\" May 07: Almost no current man pages have a DIAGNOSTICS section;
.\" "RETURN VALUE" or "EXIT STATUS" is preferred.
.\" .TP
-.\" .B ¿ÇÃÇ¥á¥Ã¥»¡¼¥¸ (DIAGNOSTICS)
-.\" ¤´¤¯°ìÈÌŪ¤Ê¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸¤Î³µÍפȡ¢
-.\" ¤½¤ì¤é¤ò¤É¤¦°·¤¦¤«¤Ë¤Ä¤¤¤Æ½Ò¤Ù¤ë¡£¥×¥í¥°¥é¥à¤Î¼Â¹Ô»þ¤Ë¸½¤ì¤ë
-.\" ¥·¥¹¥Æ¥à¥¨¥é¡¼¥á¥Ã¥»¡¼¥¸¤äÃ×̿Ū¥·¥°¥Ê¥ë¤òÁ´ÉôÀâÌÀ¤¹¤ëɬÍפϤʤ¤¡£
-.\" ¤¿¤À¤·¤½¤ì¤é¤¬¥×¥í¥°¥é¥à¤ËÂФ·¤Æ
-.\" ²¿¤é¤«¤ÎÆüì¤Ê°ÕÌ£¤ò»ý¤Ã¤Æ¤¤¤ë¾ì¹ç¤ÏÊ̤Ǥ¢¤ë¡£
+.\" .B 診æ\96ã\83¡ã\83\83ã\82»ã\83¼ã\82¸ (DIAGNOSTICS)
+.\" ごく一般的なエラーメッセージの概要と、
+.\" それらをどう扱うかについて述べる。プログラムの実行時に現れる
+.\" システムエラーメッセージや致命的シグナルを全部説明する必要はない。
+.\" ただしそれらがプログラムに対して
+.\" 何らかの特殊な意味を持っている場合は別である。
.\"
.\" May 07: Almost no current man pages have a SECURITY section.
.\".TP
-.\" .B ¥»¥¥å¥ê¥Æ¥£ (SECURITY)
-.\" ¥»¥¥å¥ê¥Æ¥£´ØÏ¢¤ÎÏÃÂꡦÌäÂê¤Ë¤Ä¤¤¤Æ½Ò¤Ù¤ë¡£
-.\" Èò¤±¤ë¤Ù¤ÀßÄê¤ä´Ä¶¡¦¥»¥¥å¥ê¥Æ¥£¾å¤ÎÌäÂê¤ò°ú¤µ¯¤³¤¹¥³¥Þ¥ó¥É
-.\" ¤Ê¤É¤Ë¤Ä¤¤¤Æ·Ù¹ð¤¹¤ë¡£¤½¤ì¤é¤¬ÌÀ¤é¤«¤Ç¤Ê¤¤¾ì¹ç¤Ë¤Ï¡¢¤³¤ì¤ÏÆä˽ÅÍפǤ¢¤ë¡£
-.\" ¥»¥¥å¥ê¥Æ¥£¤Ë´Ø¤¹¤ëÏÃÂê¤Ï¡¢É¬¤º¤·¤âÆÈΩ¤·¤¿¥»¥¯¥·¥ç¥ó¤Ë¤¹¤ëɬÍפϤʤ¤¡£
-.\" ¤â¤·Íý²ò¤·¤ä¤¹¤±¤ì¤Ð¡¢¥»¥¥å¥ê¥Æ¥£¤Î¾ðÊó¤Ï¾¤Î¥»¥¯¥·¥ç¥ó
-.\" (Î㤨¤Ð
-.\" .B ÀâÌÀ
-.\" ¤ä
-.\" .B ÍøÍÑË¡
-.\" ¤Ê¤É) ¤Ë½ñ¤¤¤Æ¤â¤è¤¤¡£
-.\" ¤·¤«¤·¡¢¥»¥¥å¥ê¥Æ¥£¤Î¾ðÊó¤Ï¤É¤³¤«¤Ë¤Ï½ñ¤¤¤Æ¤ª¤¤¤Æ¤Û¤·¤¤!
-.TP
-.B ¥Ð¡¼¥¸¥ç¥ó (VERSIONS)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ä¥é¥¤¥Ö¥é¥ê´Ø¿ô¤¬Åо줷¤¿¤ê¡¢Æ°ºî¤Î½ÅÍפÊÊѹ¹¤¬¹Ô¤ï¤ì¤¿¡¢
-Linux ¥«¡¼¥Í¥ë¤ä glibc ¤Î¥Ð¡¼¥¸¥ç¥ó¤Ë¤Ä¤¤¤Æ¤Î´Ê·é¤Ê³µÍס£
-°ìÈ̤ˡ¢Á´¤Æ¤Î¿·¤·¤¤¥¤¥ó¥¿¡¼¥Õ¥§¥¤¥¹¤Ï¡¢¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë
-¡Ö¥Ð¡¼¥¸¥ç¥ó¡×¤ÎÀá¤òÀߤ±¤ë¤Ù¤¤Ç¤¢¤ë¡£
-»ÄÇ°¤Ê¤³¤È¤Ë¡¢Â¿¤¯¤Î´û¸¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë¤³¤Î¾ðÊó¤Ï´Þ¤Þ¤ì¤Æ¤¤¤Ê¤¤
-(¤³¤ì¤é¤Î¥Ú¡¼¥¸¤¬½ñ¤«¤ì¤¿»þÅÀ¤Ç¤Ï¤½¤Î¤è¤¦¤Ê¥Ý¥ê¥·¡¼¤Ï¤Ê¤«¤Ã¤¿¤«¤é¤Ç¤¢¤ë)¡£
-¤³¤ì¤ò²þÁ±¤¹¤ë¥Ñ¥Ã¥Á¤Ï´¿·Þ¤µ¤ì¤ë¤¬¡¢
-¿·¤·¤¤¥³¡¼¥É¤ò½ñ¤¯¥×¥í¥°¥é¥Þ¤Î´ÑÅÀ¤«¤é¤¹¤ì¤Ð¡¢
-¤ª¤½¤é¤¯¤³¤Î¾ðÊ󤬽ÅÍפˤʤë¤Î¤Ï¡¢
-Linux 2.4 °Ê¹ß¤ÇÄɲ䵤줿¥«¡¼¥Í¥ë¥¤¥ó¥¿¡¼¥Õ¥§¥¤¥¹ (¥«¡¼¥Í¥ë 2.2 ¤«¤é¤ÎÊѹ¹) ¤È
-glibc ¥Ð¡¼¥¸¥ç¥ó 2.1 °Ê¹ß¤ÇÄɲ䵤줿¥é¥¤¥Ö¥é¥ê´Ø¿ô (glibc 2.0 ¤«¤é¤ÎÊѹ¹)
-¤Ë¤Ä¤¤¤Æ¤Î¤ß¤Ç¤¢¤í¤¦¡£
+.\" .B ã\82»ã\82ã\83¥ã\83ªã\83\86ã\82£ (SECURITY)
+.\" セキュリティ関連の話題・問題について述べる。
+.\" 避けるべき設定や環境・セキュリティ上の問題を引き起こすコマンド
+.\" などについて警告する。それらが明らかでない場合には、これは特に重要である。
+.\" セキュリティに関する話題は、必ずしも独立したセクションにする必要はない。
+.\" もし理解しやすければ、セキュリティの情報は他のセクション
+.\" (例えば
+.\" .B 説明
+.\" や
+.\" .B 利用法
+.\" など) に書いてもよい。
+.\" しかし、セキュリティの情報はどこかには書いておいてほしい!
+.TP
+.B バージョン (VERSIONS)
+システムコールやライブラリ関数が登場したり、動作の重要な変更が行われた、
+Linux カーネルや glibc のバージョンについての簡潔な概要。
+一般に、全ての新しいインターフェイスは、マニュアルページに
+「バージョン」の節を設けるべきである。
+残念なことに、多くの既存のマニュアルページにこの情報は含まれていない
+(これらのページが書かれた時点ではそのようなポリシーはなかったからである)。
+これを改善するパッチは歓迎されるが、
+新しいコードを書くプログラマの観点からすれば、
+おそらくこの情報が重要になるのは、
+Linux 2.4 以降で追加されたカーネルインターフェイス (カーネル 2.2 からの変更) と
+glibc バージョン 2.1 以降で追加されたライブラリ関数 (glibc 2.0 からの変更)
+についてのみであろう。
.BR syscalls (2)
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë¤â¡¢¤¤¤í¤¤¤í¤Ê¥·¥¹¥Æ¥à¥³¡¼¥ë¤¬½é¤á¤ÆÅо줷¤¿
-¥«¡¼¥Í¥ë¥Ð¡¼¥¸¥ç¥ó¤Ë¤Ä¤¤¤Æ¤Î¾ðÊ󤬽ñ¤«¤ì¤Æ¤¤¤ë¡£
-.TP
-.B ½àµò (CONFORMING TO)
-¤½¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÇÀâÌÀ¤·¤Æ¤¤¤ë´Ø¿ô¤ä¥³¥Þ¥ó¥É¤Ë´ØÏ¢¤¹¤ë
-ɸ½àµ¬³Ê¤ä´·½¬¤Ë¤Ä¤¤¤ÆµºÜ¤¹¤ë¡£
-¥»¥¯¥·¥ç¥ó 2 ¤ä 3 ¤Î¥Ú¡¼¥¸¤Ç¤Ï¡¢¤³¤Î¥»¥¯¥·¥ç¥ó¤Ç
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ä´Ø¿ô¤¬½àµò¤¹¤ë POSIX.1 ¤Î¥Ð¡¼¥¸¥ç¥ó¤È¡¢
-C99 ¤Çµ¬Äꤵ¤ì¤Æ¤¤¤ë¤«¤Ë¿¨¤ì¤ë¤Ù¤¤Ç¤¢¤ë¡£
-(SUS, SUSv2, XPG ¤Ê¤É¤Î¾¤Îɸ½àµ¬³Ê¤ä¡¢SVr4 ¤ä 4.xBSD ¤Î¼ÂÁõɸ½à¤Ë
-¤Ä¤¤¤Æ¤Ï¡¢ÀâÌÀ¤·¤Æ¤¤¤ë¥³¡¼¥ë¤¬¤³¤ì¤é¤Îµ¬³Ê¤Çµ¬Äꤵ¤ì¤Æ¤ª¤ê
-POSIX.1 ¤Î¸½¹Ô¥Ð¡¼¥¸¥ç¥ó¤Çµ¬Äꤵ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç°Ê³°¤Ï¡¢
-¤¢¤Þ¤ê¿¼¤¯µ¤¤Ë¤¹¤ëɬÍפϤʤ¤¡£)
+マニュアルページにも、いろいろなシステムコールが初めて登場した
+カーネルバージョンについての情報が書かれている。
+.TP
+.B 準拠 (CONFORMING TO)
+そのマニュアルページで説明している関数やコマンドに関連する
+標準規格や慣習について記載する。
+セクション 2 や 3 のページでは、このセクションで
+システムコールや関数が準拠する POSIX.1 のバージョンと、
+C99 で規定されているかに触れるべきである。
+(SUS, SUSv2, XPG などの他の標準規格や、SVr4 や 4.xBSD の実装標準に
+ついては、説明しているコールがこれらの規格で規定されており
+POSIX.1 の現行バージョンで規定されていない場合以外は、
+あまり深く気にする必要はない。)
.RB ( standards (7)
-»²¾È¡£)
+参照。)
-¤½¤Î¥³¡¼¥ë¤¬¤É¤Îɸ½à¤Ë¤â´ð¤Å¤¤¤Æ¤¤¤Ê¤¤¤¬¡¢
-¾¤Î¥·¥¹¥Æ¥à¤Ç¹¤¯Â¸ºß¤¹¤ë¾ì¹ç¤Ï¡¢¤½¤Î»Ý¤òµºÜ¤¹¤ë¤³¤È¡£
-¤½¤Î¥³¡¼¥ë¤¬ Linux ¸Çͤξì¹ç¤Ï¡¢¤½¤Î»Ý¤òµºÜ¤¹¤ë¤³¤È¡£
+そのコールがどの標準にも基づいていないが、
+他のシステムで広く存在する場合は、その旨を記載すること。
+そのコールが Linux 固有の場合は、その旨を記載すること。
-(¤½¤¦¤Ê¤Ã¤Æ¤¤¤ë¥Ú¡¼¥¸¤¬Â¿¤¤¤¬) ¤³¤Î¥»¥¯¥·¥ç¥ó¤ÎÆâÍƤ¬É¸½à¤Î¥ê¥¹¥È
-¤À¤±¤Î¾ì¹ç¡¢¥ê¥¹¥È¤ÎºÇ¸å¤Ë¥Ô¥ê¥ª¥É (\(aq.\(aq) ¤òÃÖ¤¯¤³¤È¡£
-.TP
-.B Ãí°Õ (NOTES)
-¤½¤Î¾¤ÎÃí°ÕÅÀ¤ò½ñ¤¯¡£
-¥»¥¯¥·¥ç¥ó 2 ¤È 3 ¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç¤Ï¡¢
-\fILinux ¤Ç¤ÎÃí°Õ (Linux Notes)\fP ¤ä \fIglibc ¤Ç¤ÎÃí°Õ (Glibc Notes)\fP
-¤È¤¤¤¦Ì¾Á°¤Î¥µ¥Ö¥»¥¯¥·¥ç¥ó (\fBSS\fP) ¤òÀߤ±¤ë¤ÈÊØÍø¤Ê¤³¤È¤â¤¢¤ë¡£
-.TP
-.B ¥Ð¥° (BUGS)
-À©¸Â¡¦ÃΤé¤ì¤Æ¤¤¤ë·ç´Ù¤äÉÔÊؤÊÅÀ¡¢¤½¤Î¾ÉԻ׵ĤÊÆ°ºî¤Ê¤É¤ò½ñ¤¯¡£
-.TP
-.B Îã (EXAMPLE)
-¤³¤Î´Ø¿ô¡¦¥Õ¥¡¥¤¥ë¡¦¥³¥Þ¥ó¥É¤ò¤É¤Î¤è¤¦¤Ë»È¤¦¤«¤ò¼¨¤·¤¿
-¤Ò¤È¤Ä¤Þ¤¿¤ÏÊ£¿ô¤ÎÎã¤òµ½Ò¤¹¤ë¡£
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤ò½ñ¤¯ºÝ¤Î¾ÜºÙ¤Ï
-°Ê²¼¤Î¡Ö¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¡×¤ÎÀá¤ò»²¾È¤Î¤³¤È¡£
-.TP
-.B Ãø¼Ô (AUTHORS)
-ʸ½ñ¤Þ¤¿¤Ï¥×¥í¥°¥é¥à¤ÎÃø¼Ô¤òÎ󵤹¤ë¡£
-.B Ãø¼Ô¥»¥¯¥·¥ç¥ó¤Ï¶ËÎÏ»ÈÍѤ·¤Ê¤¤¤³¤È¡£
-°ìÈÌŪ¤Ë¤Ï¡¢Ãø¼Ô¤Î¥ê¥¹¥È¤ò³Æ¥Ú¡¼¥¸¤Ë»µ¤»¶¤é¤µ¤Ê¤¤Êý¤¬¤è¤¤
-(»þ´Ö¤¬¤¿¤Ä¤È¡¢ºî¼Ô¤Î¥ê¥¹¥È¤ÏËÄÂç¤Ë¤Ê¤ë²ÄǽÀ¤¬¤¢¤ë)¡£
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ò¿·µ¬¤Ë½ñ¤¤¤¿¤ê¡¢ÂçÉý¤Ë½¤Àµ¤ò¹Ô¤Ã¤¿¾ì¹ç¤Ë¤Ï¡¢
-¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤Ë¥³¥á¥ó¥È¤È¤·¤ÆÃøºî¸¢É½¼¨¤òÄɲ乤뤳¤È¡£
-¤¢¤Ê¤¿¤¬¥Ç¥Ð¥¤¥¹¥É¥é¥¤¥Ð¤Îºî¼Ô¤Ç¡¢¥Ð¥°¤òÊó¹ð¤¹¤ë¤¿¤á¤Î¥¢¥É¥ì¥¹¤ò
-ºÜ¤»¤¿¤¤¾ì¹ç¤Ï¡¢¡Ö¥Ð¥°¡×¥»¥¯¥·¥ç¥ó¤Î¸å¤í¤Ë¤³¤Î¥»¥¯¥·¥ç¥ó¤òÇÛÃÖ¤¹¤ë¤³¤È¡£
-.TP
-.B ´ØÏ¢¹àÌÜ (SEE ALSO)
-´ØÏ¢¤¹¤ë¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ò¡¢¥³¥ó¥Þ¶èÀÚ¤ê¤Î¥ê¥¹¥È¤Ç¡¢
-¥»¥¯¥·¥ç¥óÈÖ¹æ½ç¤Ë¡¢¥»¥¯¥·¥ç¥óÆâ¤Ç¤Ï¥¢¥ë¥Õ¥¡¥Ù¥Ã¥È½ç¤ÇµºÜ¤¹¤ë¡£
-²Äǽ¤Ê¤é´ØÏ¢¤¹¤ë¾¤Îʸ½ñ¤â½ñ¤¯¡£
-´·½¬¤Ç¤Ï¡¢¤³¤Î¥»¥¯¥·¥ç¥ó¤ÏºÇ¸å¤ËÃÖ¤¯¡£
-¥ê¥¹¥È¤ÎËöÈø¤Ë¥Ô¥ê¥ª¥É¤òÃÖ¤«¤Ê¤¤¤³¤È¡£
-.SS ¥Õ¥©¥ó¥È¤Î´·½¬
+(そうなっているページが多いが) このセクションの内容が標準のリスト
+だけの場合、リストの最後にピリオド (\(aq.\(aq) を置くこと。
+.TP
+.B 注意 (NOTES)
+その他の注意点を書く。
+セクション 2 と 3 のマニュアルページでは、
+\fILinux での注意 (Linux Notes)\fP や \fIglibc での注意 (Glibc Notes)\fP
+という名前のサブセクション (\fBSS\fP) を設けると便利なこともある。
+.TP
+.B ã\83\90ã\82° (BUGS)
+制限・知られている欠陥や不便な点、その他不思議な動作などを書く。
+.TP
+.B 例 (EXAMPLE)
+この関数・ファイル・コマンドをどのように使うかを示した
+ひとつまたは複数の例を記述する。
+サンプルプログラムを書く際の詳細は
+以下の「サンプルプログラム」の節を参照のこと。
+.TP
+.B 著者 (AUTHORS)
+文書またはプログラムの著者を列記する。
+.B 著者セクションは極力使用しないこと。
+一般的には、著者のリストを各ページに撒き散らさない方がよい
+(時間がたつと、作者のリストは膨大になる可能性がある)。
+マニュアルページを新規に書いたり、大幅に修正を行った場合には、
+ソースファイルにコメントとして著作権表示を追加すること。
+あなたがデバイスドライバの作者で、バグを報告するためのアドレスを
+載せたい場合は、「バグ」セクションの後ろにこのセクションを配置すること。
+.TP
+.B 関連項目 (SEE ALSO)
+関連するマニュアルページを、コンマ区切りのリストで、
+セクション番号順に、セクション内ではアルファベット順で記載する。
+可能なら関連する他の文書も書く。
+慣習では、このセクションは最後に置く。
+リストの末尾にピリオドを置かないこと。
+.SS フォントの慣習
.PP
-´Ø¿ô¤ËÂФ·¤Æ¤Ï¡¢°ú¤¿ô¤Ë¤Ï¾ï¤Ë¥¤¥¿¥ê¥Ã¥¯ÂΤòÍѤ¤¤ë¡£
-¡Ö¤¿¤È¤¨½ñ¼° (SYNOPSIS) ¥»¥¯¥·¥ç¥ó¤Ç¤¢¤Ã¤Æ¤â¡¢¤³¤Î¥ë¡¼¥ë¤Ë½¾¤¦¡×
-´Ø¿ô¤Î¾¤ÎÉôʬ¤Ï¥Ü¡¼¥ë¥É¤ò»ØÄꤹ¤ë:
+関数に対しては、引き数には常にイタリック体を用いる。
+「たとえ書式 (SYNOPSIS) セクションであっても、このルールに従う」
+関数の他の部分はボールドを指定する:
.PP
.BI " int myfunction(int " argc ", char **" argv );
.PP
-°ú¤¿ô̾¤È¤¤¤Ã¤¿ÊÑ¿ô̾¤Ï¥¤¥¿¥ê¥Ã¥¯ÂΤò»ØÄꤹ¤Ù¤¤Ç¤¢¤ë¡£
+引き数名といった変数名はイタリック体を指定すべきである。
.PP
-¥Õ¥¡¥¤¥ë̾ (¥Ñ¥¹Ì¾¡¢¤Þ¤¿¤Ï
+ファイル名 (パス名、または
.I /usr/include
-¥Ç¥£¥ì¥¯¥È¥êÆâ¤Î¥Õ¥¡¥¤¥ë¤Ø¤Î»²¾È) ¤Ï¾ï¤Ë¥¤¥¿¥ê¥Ã¥¯ÂΤˤ¹¤ë (Îã:
-.IR <stdio.h> )¡£
-¤¿¤À¤·¡¢½ñ¼° (SYNOPSIS) ¥»¥¯¥·¥ç¥ó¤ÏÎã³°¤Ç¡¢
-¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë¤Ï¥Ü¡¼¥ë¥É¤Ë¤¹¤ë (Îã:
-.BR "#include <stdio.h>" )¡£
+ディレクトリ内のファイルへの参照) は常にイタリック体にする (例:
+.IR <stdio.h> )。
+ただし、書式 (SYNOPSIS) セクションは例外で、
+インクルードファイルはボールドにする (例:
+.BR "#include <stdio.h>" )。
.I /usr/include
-°Ê²¼¤Îɸ½à¤Î¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë¤ò»²¾È¤¹¤ëºÝ¤Ï¡¢
-Ä̾ï¤Î C ¸À¸ì¤ÈƱÍͤ˻³³ç¸Ì¤Ç¥Ø¥Ã¥À¥Õ¥¡¥¤¥ë¤ò°Ï¤Ì¤Ç»ØÄꤹ¤ë (Î㡧
-.IR <stdio.h> )¡£
+以下の標準のインクルードファイルを参照する際は、
+通常の C 言語と同様に山括弧でヘッダファイルを囲ぬで指定する (例：
+.IR <stdio.h> )。
.PP
-Ä̾Âçʸ»ú¤Çɽ¸½¤¹¤ëÆüì¥Þ¥¯¥í¤Ï¥Ü¡¼¥ë¥É¤Çɽ¤¹ (Î㤨¤Ð
-.BR MAXINT )¡£
-Îã³°¤È¤·¤Æ NULL ¤Ï¥Ü¡¼¥ë¥É¤Ë¤·¤Ê¤¤¡£
+通常、大文字で表現する特殊マクロはボールドで表す (例えば
+.BR MAXINT )。
+例外として NULL はボールドにしない。
.PP
-¥¨¥é¡¼¥³¡¼¥É¤Î¥ê¥¹¥È¤òÎóµó¤¹¤ë»þ¤Ë¤Ï¡¢¥³¡¼¥É¤Ï¥Ü¡¼¥ë¥É¤Çɽ¤¹
-(¤³¤Î¥ê¥¹¥È¤Ë¤ÏÄ̾ï
+エラーコードのリストを列挙する時には、コードはボールドで表す
+(このリストには通常
.B \&.TP
-¥Þ¥¯¥í¤òÍѤ¤¤ë)¡£
+マクロを用いる)。
.PP
-´°Á´¤Ê¥³¥Þ¥ó¥É¤Ï¡¢Ä¹¤¤¾ì¹ç¤Ë¤Ï¡¢Îã¤Ë¼¨¤¹¤è¤¦¤Ë
-»ú²¼¤²¤·¤¿¹Ô¤Ë¥³¥Þ¥ó¥É¤À¤±¤òµºÜ¤¹¤Ù¤¤Ç¤¢¤ë¡£
+完全なコマンドは、長い場合には、例に示すように
+字下げした行にコマンドだけを記載すべきである。
.in +4n
.nf
.fi
.in
-¥³¥Þ¥ó¥É¤¬Ã»¤¤¾ì¹ç¤Ï¡¢
+コマンドが短い場合は、
.I "man 7 man-pages"
-¤Î¤è¤¦¤Ë¥¤¥¿¥ê¥Ã¥¯ÂΤÇʸÃæ¤ËËä¤á¹þ¤ó¤ÇµºÜ¤·¤Æ¤â¤è¤¤¡£
-¤³¤Î¾ì¹ç¡¢¥³¥Þ¥ó¥ÉÆâ¤ÎŬÀڤʰÌÃ֤ˡ¢²þ¹Ô¤Ç¤¤Ê¤¤¥¹¥Ú¡¼¥¹ ("\e\ ")
-¤ò»È¤¦¤È¤è¤¤¤«¤â¤·¤ì¤Ê¤¤¡£
-¥³¥Þ¥ó¥É¥ª¥×¥·¥ç¥ó¤â
+のようにイタリック体で文中に埋め込んで記載してもよい。
+ã\81\93ã\81®å ´å\90\88ã\80\81ã\82³ã\83\9eã\83³ã\83\89å\86\85ã\81®é\81©å\88\87ã\81ªä½\8dç½®ã\81«ã\80\81æ\94¹è¡\8cã\81§ã\81\8dã\81ªã\81\84ã\82¹ã\83\9aã\83¼ã\82¹ ("\e\ ")
+を使うとよいかもしれない。
+コマンドオプションも
.I \-l
-¤Î¤è¤¦¤Ë¥¤¥¿¥ê¥Ã¥¯ÂΤǵºÜ¤¹¤Ù¤¤Ç¤¢¤ë¡£
+のようにイタリック体で記載すべきである。
.PP
-¼°¤Ï¡¢ÀìÍѤλú²¼¤²¤·¤¿¹Ô¤ËµºÜ¤·¤Ê¤¤¾ì¹ç¡¢¥¤¥¿¥ê¥Ã¥¯ÂΤò»ØÄꤹ¤ë¤³¤È¡£
-·«¤êÊÖ¤·¤Ë¤Ê¤ë¤¬¡¢¼°¤òÄ̾ï¤ÎʸÃæ¤ËËä¤á¹þ¤à¾ì¹ç¤Ë¤â¡¢
-²þ¹Ô¤Ç¤¤Ê¤¤¥¹¥Ú¡¼¥¹¤ò»È¤¦¤È¤è¤¤¤À¤í¤¦¡£
+式は、専用の字下げした行に記載しない場合、イタリック体を指定すること。
+繰り返しになるが、式を通常の文中に埋め込む場合にも、
+改行できないスペースを使うとよいだろう。
.PP
-¤½¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÎÀâÌÀÂоݤؤλ²¾È¤Ï¡¢¥Ü¡¼¥ë¥É¤Ç̾Á°¤òµºÜ¤¹¤ë¡£
-Âоݤ¬´Ø¿ô (¤Ä¤Þ¤ê¡¢¥»¥¯¥·¥ç¥ó 2 ¤ä 3 ¤Î¥Ú¡¼¥¸) ¤Î¾ì¹ç¡¢
-̾Á°¤Î¸å¤í¤Ë¥í¡¼¥Þ¥ó¥Õ¥©¥ó¥È (Ä̾ï¤Î¥Õ¥©¥ó¥È) ¤Ç´Ý³ç¸Ì¤ÎÂФò³¤±¤ë¡£
-Î㤨¤Ð¡¢
+そのマニュアルページの説明対象への参照は、ボールドで名前を記載する。
+対象が関数 (つまり、セクション 2 や 3 のページ) の場合、
+名前の後ろにローマンフォント (通常のフォント) で丸括弧の対を続ける。
+例えば、
.BR fcntl (2)
-¤Î¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç¤Ï¡¢ÀâÌÀÂоݤؤλ²¾È¤Ï
+のマニュアルページでは、説明対象への参照は
.BR fcntl ()
-¤Î¤è¤¦¤ËµºÜ¤¹¤ë¡£
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤Ë¤Ï¼¡¤Î¤è¤¦¤ËµºÜ¤¹¤ë¤Î¤¬Ë¾¤Þ¤·¤¤:
+のように記載する。
+マニュアルページのソースファイルには次のように記載するのが望ましい:
.nf
.BR fcntl ()
.fi
-("\\fB...\\fP()" ¤è¤ê¤â¡¢¤³¤Î·Á¼°¤ò»È¤¦¤³¤È¡£
-¤³¤ì¤Ë¤è¤ê¡¢¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤ò²ò¼á¤¹¤ë¥Ä¡¼¥ë¤ò
-½ñ¤¯¤Î¤¬´Êñ¤Ë¤Ê¤ë¡£)
+("\\fB...\\fP()" よりも、この形式を使うこと。
+これにより、マニュアルページのソースファイルを解釈するツールを
+書くのが簡単になる。)
.PP
-Ê̤Υޥ˥奢¥ë¥Ú¡¼¥¸¤Ø¤Î»²¾È¤Ï¡¢¥Ü¡¼¥ë¥É¤Ç̾Á°¤òµºÜ¤·¡¢
-¤½¤ì¤Ë³¤±¤Æ¥»¥¯¥·¥ç¥óÈÖ¹æ¤ò¡Öɬ¤º¡×½ñ¤¯¡£¥»¥¯¥·¥ç¥óÈÖ¹æ¤Ï
-¥í¡¼¥Þ¥ó¥Õ¥©¥ó¥È (Ä̾ï¤Î¥Õ¥©¥ó¥È) ¤Ç½ñ¤¡¢¥¹¥Ú¡¼¥¹¤ÏÆþ¤ì¤Ê¤¤
-(Îã:
-.BR intro (2))¡£
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Î¥½¡¼¥¹¥Õ¥¡¥¤¥ë¤Ë¤Ï¼¡¤Î¤è¤¦¤ËµºÜ¤¹¤ë¤Î¤¬Ë¾¤Þ¤·¤¤:
+別のマニュアルページへの参照は、ボールドで名前を記載し、
+それに続けてセクション番号を「必ず」書く。セクション番号は
+ローマンフォント (通常のフォント) で書き、スペースは入れない
+(例:
+.BR intro (2))。
+マニュアルページのソースファイルには次のように記載するのが望ましい:
.nf
.BR intro (2)
.fi
-(Áê¸ß»²¾È¤Ë¥»¥¯¥·¥ç¥óÈÖ¹æ¤ò´Þ¤á¤Æ¤ª¤¯¤È¡¢
+(相互参照にセクション番号を含めておくと、
.B man2html
-¤È¤¤¤Ã¤¿¥Ä¡¼¥ë¤¬¥Ú¡¼¥¸´Ö¤Î¥Ï¥¤¥Ñ¡¼¥ê¥ó¥¯¤òŬÀÚ¤ËÀ¸À®¤Ç¤¤ë¡£)
-.SS ÄÖ¤ê (spelling)
-¥ê¥ê¡¼¥¹ 2.59 ¤«¤é¤À¤¬¡¢
+といったツールがページ間のハイパーリンクを適切に生成できる。)
+.SS 綴り (spelling)
+リリース 2.59 からだが、
.I man-pages
-¤Ï¥¢¥á¥ê¥«±Ñ¸ì¤ÎÄÖ¤ê¤Î´·½¬¤Ë½¾¤Ã¤Æ¤¤¤ë¡£
-¿·¤·¤¤¥Ú¡¼¥¸¤ä¥Ñ¥Ã¥Á¤ÏÁ´¤Æ¤³¤Î´·½¬¤Ë½¾¤Ã¤Æ²¼¤µ¤¤¡£
-.SS ¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤È¥·¥§¥ë¤Î¥»¥Ã¥·¥ç¥ó
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ë¤Ï¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ä¥é¥¤¥Ö¥é¥ê´Ø¿ô¤Î»È¤¤Êý¤ò¼¨¤¹
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤ò´Þ¤á¤ë¤³¤È¤¬¤Ç¤¤ë¡£
-¤½¤ÎºÝ¤Ë¤Ï¡¢°Ê²¼¤ÎÅÀ¤Ëα°Õ¤¹¤Ù¤¤Ç¤¢¤ë¡£
+はアメリカ英語の綴りの慣習に従っている。
+新しいページやパッチは全てこの慣習に従って下さい。
+.SS サンプルプログラムとシェルのセッション
+マニュアルページには、システムコールやライブラリ関数の使い方を示す
+サンプルプログラムを含めることができる。
+その際には、以下の点に留意すべきである。
.TP 3
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï C ¤ÇµºÜ¤¹¤ë¤³¤È¡£
+サンプルプログラムは C で記載すること。
.TP
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï¡¢
-¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ë¤Ä¤¤¤Æʸ¾Ï¤Ç´Êñ¤ËÀâÌÀ¤Ç¤¤ë°Ê¾å¤Î¤³¤È¤ò¼¨¤¹¾ì¹ç¤Ë¤À¤±
-ɬÍפ«¤ÄÍÍѤǤ¢¤ë¡£¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤ò¸Æ¤Ó½Ð¤¹°Ê³°¤Ë²¿¤â¤·¤Ê¤¤¥µ¥ó¥×¥ë
-¥×¥í¥°¥é¥à¤ÏÉáÄ̤ϤۤȤó¤ÉÌò¤ËΩ¤¿¤Ê¤¤¡£
+サンプルプログラムは、
+インタフェースについて文章で簡単に説明できる以上のことを示す場合にだけ
+必要かつ有用である。インタフェースを呼び出す以外に何もしないサンプル
+プログラムは普通はほとんど役に立たない。
.TP
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï¤«¤Ê¤êû¤á¤Ë¤¹¤ë¤³¤È
-(100¹Ô̤Ëþ¤¬Ë¾¤Þ¤·¤¯¡¢50¹Ô̤Ëþ¤¬ÍýÁÛŪ¤Ç¤¢¤ë)¡£
+サンプルプログラムはかなり短めにすること
+(100行未満が望ましく、50行未満が理想的である)。
.TP
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ç¤Ï¡¢¥·¥¹¥Æ¥à¥³¡¼¥ë¤ä¥é¥¤¥Ö¥é¥ê´Ø¿ô¤ò¸Æ¤Ó½Ð¤·¤¿¸å¤Ç
-¥¨¥é¡¼¥Á¥§¥Ã¥¯¤ò¹Ô¤¦¤³¤È¡£
+サンプルプログラムでは、システムコールやライブラリ関数を呼び出した後で
+エラーチェックを行うこと。
.TP
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï´°·ë¤·¤Æ¤¤¤Æ¡¢
+サンプルプログラムは完結していて、
\fIcc\ \-Wall\fP
-¤Ç¥³¥ó¥Ñ¥¤¥ë¤·¤¿ºÝ¤Ë·Ù¹ð¤Ê¤·¤Ç¥³¥ó¥Ñ¥¤¥ë¤Ç¤¤ë¤³¤È¡£
+でコンパイルした際に警告なしでコンパイルできること。
.TP
*
-²Äǽ¤«¤ÄŬÀڤʾì¹ç¤Ë¤Ï¡¢¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ç
-ÆþÎϤˤè¤êÆ°ºî¤òÊѲ½¤µ¤»¤ë¤Ê¤É¤Î¼Â¸³¤ò¹Ô¤¦¤È¤è¤¤
-(ÍýÁÛŪ¤Ë¤Ï¡¢¥³¥Þ¥ó¥É¥é¥¤¥ó°ú¤¿ô¤ä¡¢¥×¥í¥°¥é¥à¤¬Æɤ߹þ¤àÆþÎϥǡ¼¥¿
-·Ðͳ¤Ç¡¢Æ°ºî¤òÊѲ½¤µ¤»¤ë¤Î¤¬¤è¤¤)¡£
+可能かつ適切な場合には、サンプルプログラムで
+入力により動作を変化させるなどの実験を行うとよい
+(ç\90\86æ\83³ç\9a\84ã\81«ã\81¯ã\80\81ã\82³ã\83\9eã\83³ã\83\89ã\83©ã\82¤ã\83³å¼\95ã\81\8dæ\95°ã\82\84ã\80\81ã\83\97ã\83ã\82°ã\83©ã\83 ã\81\8cèªã\81¿è¾¼ã\82\80å\85¥å\8a\9bã\83\87ã\83¼ã\82¿
+経由で、動作を変化させるのがよい)。
.TP
*
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤Ï¡¢K&R (Kernighan and Ritchie) ¥¹¥¿¥¤¥ë¤Ç½ñ¤¡¢
-»ú²¼¤²¤Ï¥¹¥Ú¡¼¥¹ 4ʸ»ú¤Ç¹Ô¤¦¡£
-(¥½¡¼¥¹¥³¡¼¥É¤Ç TAB ʸ»ú¤ò»È¤¦¤Î¤ÏÈò¤±¤ë¤³¤È¡£)
+サンプルプログラムは、K&R (Kernighan and Ritchie) スタイルで書き、
+字下げはスペース 4文字で行う。
+(ソースコードで TAB 文字を使うのは避けること。)
.PP
-¥µ¥ó¥×¥ë¥×¥í¥°¥é¥à¤¬¤É¤ó¤ÊÉ÷¤Ë¤Ê¤Ã¤Æ¤¤¤ì¤Ð¤è¤¤¤«¤ÎÎã¤Ë¤Ä¤¤¤Æ¤Ï¡¢
+サンプルプログラムがどんな風になっていればよいかの例については、
.BR wait (2)
-¤È
+と
.BR pipe (2)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
+を参照すること。
-¥×¥í¥°¥é¥à¤Î»È¤¤Êý¤ä¾¤Î¥·¥¹¥Æ¥à¤ÎÆÃħ¤ò¼¨¤¹¤¿¤á¤Ë¥·¥§¥ë¤Î¥»¥Ã¥·¥ç¥óÎã
-¤ò´Þ¤á¤ë¾ì¹ç¡¢¥æ¡¼¥¶¤ÎÆþÎÏʸ¤ò¥Ü¡¼¥ë¥É¤Ë¤·¤Æ¡¢¥·¥¹¥Æ¥à¤¬À¸À®¤¹¤ë
-½ÐÎϤȶèÊ̤Ǥ¤ë¤è¤¦¤Ë¤¹¤ë¤³¤È¡£
-.SS ¹½Â¤ÂΤÎÄêµÁ¡¢¥·¥§¥ë¤Î¥»¥Ã¥·¥ç¥ó¥í¥°¤Ê¤É¤Î»ú²¼¤²
-¹½Â¤ÂΤÎÄêµÁ¤ä¥·¥§¥ë¤Î¥»¥Ã¥·¥ç¥ó¥í¥°¤Ê¤É¤òËÜʸÃæ¤ËµºÜ¤¹¤ëºÝ¤Ï¡¢
-¥¹¥Ú¡¼¥¹ 4¸Äʬ¤Î»ú²¼¤²¤ò¹Ô¤¦ (¤Ä¤Þ¤ê¡¢¥Ö¥í¥Ã¥¯¤ò
+プログラムの使い方や他のシステムの特徴を示すためにシェルのセッション例
+を含める場合、ユーザの入力文をボールドにして、システムが生成する
+出力と区別できるようにすること。
+.SS 構造体の定義、シェルのセッションログなどの字下げ
+構造体の定義やシェルのセッションログなどを本文中に記載する際は、
+スペース 4個分の字下げを行う (つまり、ブロックを
.I ".in\ +4n"
-¤È
+と
.I ".in"
-¤Ç°Ï¤à)¡£
-.SH Îã
+で囲む)。
+.SH 例
.I man-pages
-¥Ñ¥Ã¥±¡¼¥¸¤Ë´Þ¤Þ¤ì¤ë¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤ÎÂκۤÎɸ½àŪ¤ÊÎã¤Ë¤Ä¤¤¤Æ¤Ï¡¢
+パッケージに含まれるマニュアルページの体裁の標準的な例については、
.BR pipe (2)
-¤È
+と
.BR fcntl (2)
-¤ò»²¾È¤¹¤ë¤³¤È¡£
-.SH ´ØÏ¢¹àÌÜ
+を参照すること。
+.SH 関連項目
.BR man (1),
.BR man2html (1),
.BR groff (7),
OSDN Git Service
