.\" Copyright (c) 1990, 1993
.\" The Regents of the University of California. All rights reserved.
.\"
+.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
+.\" %%%LICENSE_END
.\"
.\" @(#)mdoc.samples.7 8.2 (Berkeley) 12/30/93
.\" $Id: mdoc.samples.7,v 1.17 1998/12/03 03:38:45 jkoshy Exp $
.\" times and is guaranteed to give a worst case performance
.\" for an already extremely slow package.
.\"
+.\" String \*(Pu was not defined, probably means punctuation
+.ds Pu [ .,:;()[]?! ]
.\"*******************************************************************
.\"
.\" This file was generated with po4a. Translate the source file.
.\"
.\"*******************************************************************
+.\"
+.\" Japanese Version Copyright (c) 1999 FreeBSD jpman project
+.\" all rights reserved.
+.\" Contributed to Linux JM Project.
+.\"
.Dd December 30, 1993
.Os
.Dt MDOC.SAMPLES 7
詳細は個々の作者に任せたページレイアウトベースのものでした。
.Nm \-mdoc
では、ページレイアウトマクロは
-タイトル、セクションのヘッダ、ディスプレイ、リストのマクロからなる
+ã\82¿ã\82¤ã\83\88ã\83«ã\80\81ã\82»ã\82¯ã\82·ã\83§ã\83³ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\80\81ã\83\87ã\82£ã\82¹ã\83\97ã\83¬ã\82¤ã\80\81ã\83ªã\82¹ã\83\88ã\81®ã\83\9eã\82¯ã\83ã\81\8bã\82\89ã\81ªã\82\8b
.Em "ページ構造領域"
を形成しています。これらの項目は整形された
ページでのテキストの物理的な位置に影響を持ちます。
の関連ファイルを記述するための日常使用されるインフォーマルな言葉の
サブセットであるマクロとして定義されています。
マニュアル領域のマクロはコマンド名、コマンド行の引数とオプション、
-関数名、関数のパラメータ、パス名、変数名、他のマニュアルページへの
+é\96¢æ\95°å\90\8dã\80\81é\96¢æ\95°ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\80\81ã\83\91ã\82¹å\90\8dã\80\81å¤\89æ\95°å\90\8dã\80\81ä»\96ã\81®ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\83\9aã\83¼ã\82¸ã\81¸ã\81®
クロスリファレンスなどを扱います。
-これらの領域の項目は作者とマニュアルページの将来のユーザの両者に
+ã\81\93ã\82\8cã\82\89ã\81®é \98å\9f\9fã\81®é \85ç\9b®ã\81¯ä½\9cè\80\85ã\81¨ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\83\9aã\83¼ã\82¸ã\81®å°\86æ\9d¥ã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81®ä¸¡è\80\85ã\81«
とって価値のあるものです。
マニュアル間で一貫性を高めることによって将来のドキュメントツールへの
移行が容易になることが望まれます。
.Pp
-マニュアルのエントリは、実際の長さに関わらず、
+ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\81¯ã\80\81å®\9fé\9a\9bã\81®é\95·ã\81\95ã\81«é\96¢ã\82\8fã\82\89ã\81\9aã\80\81
また男女の区別をするような意図なしで、
.Ux
のマニュアルページを通して、
単純に man ページとして参照されています。
.Sh さあ、始めよう
通常チュートリアルドキュメントは、そこに示された題材をすぐに使いたい時
-に読むものですので、このドキュメントのユーザはせっかちな人だと仮定して
+ã\81«èªã\82\80ã\82\82ã\81®ã\81§ã\81\99ã\81®ã\81§ã\80\81ã\81\93ã\81®ã\83\89ã\82ã\83¥ã\83¡ã\83³ã\83\88ã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81¯ã\81\9bã\81£ã\81\8bã\81¡ã\81ªäººã\81 ã\81¨ä»®å®\9aã\81\97ã\81¦
います。このドキュメントの残りの部分で説明されている題材は以下のような
構成になっています。
.Bl -enum -offset indent
.It
.Tn "ページ構造領域"
.Bl -tag -width flag -compact -offset indent
-.It "セクションヘッダ"
+.It "セクションヘッダー"
.It "段落と行スペース"
.It "キープ"
.It "ディスプレイ"
たとえば、関数マクロ
.Ql \&.Fn
では最初の引数は関数名であり、残りの
-引数が関数のパラメータであることが必要です。
+å¼\95æ\95°ã\81\8cé\96¢æ\95°ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\81\93ã\81¨ã\81\8cå¿\85è¦\81ã\81§ã\81\99ã\80\82
.Tn "ANSI C"
の括弧で
-å\9b²ã\81¾ã\82\8cã\81\9fã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83ªã\82¹ã\83\88ã\81«ã\81\8aã\81\91ã\82\8bé\96¢æ\95°ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿の宣言の規定により、
-各パラメータは最低でも 2 語の文字列となります。
+å\9b²ã\81¾ã\82\8cã\81\9fã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\83ªã\82¹ã\83\88ã\81«ã\81\8aã\81\91ã\82\8bé\96¢æ\95°ã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼の宣言の規定により、
+å\90\84ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81¯æ\9c\80ä½\8eã\81§ã\82\82 2 èª\9eã\81®æ\96\87å\97å\88\97ã\81¨ã\81ªã\82\8aã\81¾ã\81\99ã\80\82
たとえば
.Fa int foo
のようになります。
の
.Xr troff
のすべてのマクロを実装するには処理速度およ
-びメモリ使用量の点でかなり高価な方法となります。
+びメモリー使用量の点でかなり高価な方法となります。
.Xr groff
では高価な処理にはなりませんが、移植性のため、この方法は
空白を含めることが最も必要である以下のマクロだけに限っています。
.Pp
.Dl Fn fetch char *str
.Pp
-パラメータのリストが改行の境界をまたぐ場合に何がおこるかについては、
+ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81®ã\83ªã\82¹ã\83\88ã\81\8cæ\94¹è¡\8cã\81®å¢\83ç\95\8cã\82\92ã\81¾ã\81\9fã\81\90å ´å\90\88ã\81«ä½\95ã\81\8cã\81\8aã\81\93ã\82\8bã\81\8bã\81«ã\81¤ã\81\84ã\81¦ã\81¯ã\80\81
.Sx バグ
のセクションを参照してください。
.Ss 行末の空白文字
.Sx タイトルマクロ
で議論されています。
.Pp
-テンプレート中の残りの項目はセクションのヘッダ
+テンプレート中の残りの項目はセクションのヘッダー
.Pq Li \&.Sh
であり、
それらのうち
と
.Sx DESCRIPTION
は必須項目です。
-これらのヘッダについては
+ã\81\93ã\82\8cã\82\89ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\81«ã\81¤ã\81\84ã\81¦ã\81¯
.Sx マニュアル領域
を説明した後、
.Sx ページ構造領域
.Sh タイトルマクロ
タイトルマクロはページ構造領域の最初の部分ですが、man ページを
前日に書き始めたいという人のために、最初に分けて記述されます。
-3 つのヘッダマクロでドキュメントか man ページのタイトル、
+3 ã\81¤ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\83\9eã\82¯ã\83ã\81§ã\83\89ã\82ã\83¥ã\83¡ã\83³ã\83\88ã\81\8b man ã\83\9aã\83¼ã\82¸ã\81®ã\82¿ã\82¤ã\83\88ã\83«ã\80\81
オペレーティングシステム、および原著の日付を指定します。
これらのマクロはドキュメントの最初に一度だけ呼び出されるもので、
-ヘッダとフッタを構成するためだけに使用されます。
+ã\83\98ã\83\83ã\83\80ã\83¼ã\81¨ã\83\95ã\83\83ã\82¿ã\82\92æ§\8bæ\88\90ã\81\99ã\82\8bã\81\9fã\82\81ã\81 ã\81\91ã\81«ä½¿ç\94¨ã\81\95ã\82\8cã\81¾ã\81\99ã\80\82
.Bl -tag -width 6n
.It Li \&.Dt ドキュメントタイトル セクション番号 [ボリューム]
.\" .Cl
ボリュームタイトルには任意のものか次のいずれかを指定します。
.Pp
.Bl -column SMM -offset indent -compact
-.It Li "AMD UNIX" Ancestral Manual Documents
-.It Li "SMM UNIX" System Manager's Manual
-.It Li "URM UNIX" Reference Manual
-.It Li "PRM UNIX" Programmer's Manual
+.It Li "AMD UNIX Ancestral Manual Documents"
+.It Li "SMM UNIX System Manager's Manual"
+.It Li "URM UNIX Reference Manual"
+.It Li "PRM UNIX Programmer's Manual"
.El
.Pp
.\" .Cl
マクロを用いた
.Ux
コマンドの記述です。
-3 番目はコマンドを通常の言葉の感覚でユーザに示したものです。
+3 ç\95ªç\9b®ã\81¯ã\82³ã\83\9eã\83³ã\83\89ã\82\92é\80\9a常ã\81®è¨\80è\91\89ã\81®æ\84\9fè¦\9aã\81§ã\83¦ã\83¼ã\82¶ã\83¼ã\81«ç¤ºã\81\97ã\81\9fã\82\82ã\81®ã\81§ã\81\99ã\80\82
これはすなわち、man ページのテキスト中でのコマンドの議論となります。
.Pp
最初のケースでは、
アドレスを識別します。
.Pp
.Dl 使い方: .Ad address ... \*(Pu
-.Bl -tag -width ".Ad f1 , f2 , f3 :" -compact -offset 14n
+.Bl -tag -width "\&.Ad f1 , f2 , f3 :" -compact -offset 14n
.It Li \&.Ad addr1
.Ad addr1
.It Li \&.Ad addr1\ .
名前の情報の後のすべての引数は句読点として扱われます。
.Pp
.Dl 使い方: .An author_name \*(Pu
-.Bl -tag -width ".An Joe Author ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.An Joe Author ) ) ," -compact -offset 14n
.It Li \&.An Joe\ Author
.An Joe Author
.It Li \&.An Joe\ Author\ ,
使用することができます。
.Pp
.Dl 使い方: .Ar argument ... \*(Pu
-.Bl -tag -width ".Ar file1 file2" -compact -offset 15n
+.Bl -tag -width "\&.Ar file1 file2" -compact -offset 15n
.It Li \&.Ar
.Ar
.It Li \&.Ar file1
.Pp
.Ql \&.Ar
が引数なしで呼び出されると、
-.Ql Ar
+.Ql \&.Ar
として扱われます。
.Ql \&.Ar
マクロは解析され、呼び出し可能です。
.Ss コンフィギュレーション宣言 (セクション 4 のみ)
.Ql \&.Cd
マクロはセクション 4 のマニュアルにおいて、
-デバイスインタフェースの
+ã\83\87ã\83\90ã\82¤ã\82¹ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81®
.Xr config 8
による宣言の説明に使われます。
このマクロは引用符 (二重引用符のみ) で囲まれた引数を取ることができます。
マクロによって指定します。
.Pp
.Dl 使い方: .Dv defined_variable ... \*(Pu
-.Bl -tag -width ".Dv MAXHOSTNAMELEN" -compact -offset 14n
+.Bl -tag -width "\&.Dv MAXHOSTNAMELEN" -compact -offset 14n
.It Li ".Dv MAXHOSTNAMELEN"
.Dv MAXHOSTNAMELEN
.It Li ".Dv TIOCGPGRP )"
と共に使われています。
.Pp
.Dl 使い方: .Er ERRNOTYPE ... \*(Pu
-.Bl -tag -width ".Bq Er ENOTDIR" -compact -offset 14n
+.Bl -tag -width "\&.Bq Er ENOTDIR" -compact -offset 14n
.It Li \&.Er ENOENT
.Er ENOENT
.It Li \&.Er ENOENT\ )\ ;
マクロは環境変数を指定します。
.Pp
.Dl 使い方: .Ev argument ... \*(Pu
-.Bl -tag -width ".Ev PRINTER ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Ev PRINTER ) ) ," -compact -offset 14n
.It Li \&.Ev DISPLAY
.Ev DISPLAY
.It Li \&.Ev PATH\ .
は解析され、呼び出し可能です。
.Ss 関数の引数
.Ql \&.Fa
-マクロは関数の引数 (パラメータ) を
+マクロは関数の引数 (パラメーター) を
マニュアルの
.Sx SYNOPSIS
のセクション外、
もしくは
.Sx SYNOPSIS
のセクション内で参照する場合に使われます。
-パラメータのリストが
+ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81®ã\83ªã\82¹ã\83\88ã\81\8c
.Ql \&.Fn
マクロでは長すぎる場合は、
囲って使うマクロ
は構造体のメンバを参照する場合にも使われます。
.Pp
.Dl 使い方: .Fa function_argument ... \*(Pu
-.Bl -tag -width ".Fa d_namlen\ )\ )\ ," -compact -offset 14n
+.Bl -tag -width "\&.Fa d_namlen\ )\ )\ ," -compact -offset 14n
.It Li \&.Fa d_namlen\ )\ )\ ,
.Fa d_namlen ) ),
.It Li \&.Fa iov_len
同じ働きをします。
.Pp
.Dl 使い方: .Fl argument ... \*(Pu
-.Bl -tag -width ".Fl \-s \-t \-v" -compact -offset 14n
+.Bl -tag -width "\&.Fl \-s \-t \-v" -compact -offset 14n
.It Li \&.Fl
.Fl
.It Li \&.Fl cfv
.Bd -literal
使い方: .Fn [type] function [[type] parameters ... \*(Pu]
.Ed
-.Bl -tag -width ".Fn _int align_ _const * char *sptrsxx" -compact
+.Bl -tag -width "\&.Fn _int align_ _const * char *sptrsxx" -compact
.It Li "\&.Fn getchar"
.Fn getchar
.It Li "\&.Fn strlen ) ,"
の呼び出しの終了を意味することに
注意して下さい (閉じ括弧がその点で挿入されます)。
.Pp
-9 個以上のパラメータをとる関数 (これは滅多にないことですが) では、
+9 å\80\8b以ä¸\8aã\81®ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\82\92ã\81¨ã\82\8bé\96¢æ\95° (ã\81\93ã\82\8cã\81¯æ»\85å¤\9aã\81«ã\81ªã\81\84ã\81\93ã\81¨ã\81§ã\81\99ã\81\8c) ã\81§ã\81¯ã\80\81
.Ql \&.Fo
マクロ (関数オープン) と
.Ql \&.Fc
マクロは対話的なコマンド、もしくは内部コマンドを指定します。
.Pp
.Dl 使い方: .Ic argument ... \*(Pu
-.Bl -tag -width ".Ic setenv , unsetenvxx" -compact -offset 14n
+.Bl -tag -width "\&.Ic setenv , unsetenvxx" -compact -offset 14n
.It Li \&.Ic :wq
.Ic :wq
.It Li \&.Ic do while {...}
記憶することはできません。
.Pp
.Dl 使い方: .Nm argument ... \*(Pu
-.Bl -tag -width ".Nm mdoc.sample" -compact -offset 14n
+.Bl -tag -width "\&.Nm mdoc.sample" -compact -offset 14n
.It Li \&.Nm mdoc.sample
.Nm mdoc.sample
.It Li \&.Nm \e-mdoc
できます。
.Pp
.Dl 使い方: .Op options ... \*(Pu
-.Bl -tag -width ".Op Fl c Ar objfil Op Ar corfil ," -compact -offset indent
+.Bl -tag -width "\&.Op Fl c Ar objfil Op Ar corfil ," -compact -offset indent
.It Li \&.Op
.Op
.It Li ".Op Fl k"
マクロはパス名もしくはファイル名をフォーマットします。
.Pp
.Dl 使い方: .Pa pathname \*(Pu
-.Bl -tag -width ".Pa /tmp/fooXXXXX ) ." -compact -offset 14n
+.Bl -tag -width "\&.Pa /tmp/fooXXXXX ) ." -compact -offset 14n
.It Li \&.Pa /usr/share
.Pa /usr/share
.It Li \&.Pa /tmp/fooXXXXX\ )\ .
一般的な変数への参照です。
.Pp
.Dl 使い方: .Va variable ... \*(Pu
-.Bl -tag -width ".Va char s ] ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Va char s ] ) ) ," -compact -offset 14n
.It Li \&.Va count
.Va count
.It Li \&.Va settimer ,
すべての残りの引数は句読点と見なされます。
.Pp
.Dl 使い方: .Xr man_page [1,...,8] \*(Pu
-.Bl -tag -width ".Xr mdoc 7 ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Xr mdoc 7 ) ) ," -compact -offset 14n
.It Li \&.Xr mdoc
.Xr mdoc
.It Li \&.Xr mdoc\ ,
.Bd -literal -offset indent -compact
使い方: .At [v6 | v7 | 32v | V.1 | V.4] ... \*(Pu
.Ed
-.Bl -tag -width ".At v6 ) ," -compact -offset 14n
+.Bl -tag -width "\&.At v6 ) ," -compact -offset 14n
.It Li .At
.At
.It Li ".At v6 ."
最大 2 つまでの引数を取ることができます。
.Ss BSD マクロ
.Dl 使い方: .Bx [Version/release] ... \*(Pu
-.Bl -tag -width ".Bx 4.3 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Bx 4.3 ) ," -compact -offset 14n
.It Li .Bx
.Bx
.It Li ".Bx 4.3 ."
.Bd -literal -offset indent -compact
使い方: .Fx Version.release ... \*(Pu
.Ed
-.Bl -tag -width ".Fx 2.2 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Fx 2.2 ) ," -compact -offset 14n
.It Li ".Fx 2.2 ."
.Fx 2.2 .
.El
最大 2 つまでの引数を取ることができます。
.Ss UNIX マクロ
.Dl 使い方: .Ux ... \*(Pu
-.Bl -tag -width ".Ux 4.3 ) ," -compact -offset 14n
+.Bl -tag -width "\&.Ux 4.3 ) ," -compact -offset 14n
.It Li .Ux
.Ux
.El
.Pp
.ne 4
クォートの例:
-.Bl -tag -width ".Aq Pa ctype.h ) ,xxxxxxxx" -compact -offset indent
+.Bl -tag -width "\&.Aq Pa ctype.h ) ,xxxxxxxx" -compact -offset indent
.It Li \&.Aq
.Aq
.It Li \&.Aq \&Ar ctype.h\ )\ ,
マクロはマクロ間での不要な空白を除去します。
これはフラグと引数の間に空白を含まない古いスタイルの引数リストを使う
場合に便利です。
-.Bl -tag -width ".Op Fl I Ns Ar directoryxx" -offset indent
+.Bl -tag -width "\&.Op Fl I Ns Ar directoryxx" -offset indent
.It Li ".Op Fl I Ns Ar directory"
は
.Op Fl I Ns Ar directory
マクロは解析され、呼び出し可能です。
.Ss セクションの相互参照
.Ql \&.Sx
-マクロは同一文書内でのセクションのヘッダへの参照を
+ã\83\9eã\82¯ã\83ã\81¯å\90\8cä¸\80æ\96\87æ\9b¸å\86\85ã\81§ã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³ã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\81¸ã\81®å\8f\82ç\85§ã\82\92
指定します。これは解析され、呼び出し可能です。
.Pp
.Bl -tag -width "Li \&.Sx FILES" -offset 14n
.Ql \&.Rv -std atexit
は以下のテキストを生成します。
.Pp
-.\" fake chapter 3 to avoid error message from Rv
-.ds cH 3
+.\" fake section 3 to avoid error message from Rv
+.\".ds cH 3
+.ds section 3
.\" and back to 7 again
+.\".ds cH 7
.Rv -std atexit
-.ds cH 7
+.ds section 7
.Pp
.Fl std
オプションはセクション 2 と 3 のマニュアルページでのみ有効です。
使われる小さな大文字のマクロです。
.Pp
.Dl 使い方: .Tn symbol ... \*(Pu
-.Bl -tag -width ".Tn ASCII" -compact -offset 14n
+.Bl -tag -width "\&.Tn ASCII" -compact -offset 14n
.It Li \&.Tn DEC
.Tn DEC
.It Li \&.Tn ASCII
.Ql \&.Xo
が使われていません。
.Sh ページ構造のドメイン
-.Ss セクションヘッダ
-以下にリストされている、最初の 3 つのセクションヘッダマクロ
+.Ss セクションヘッダー
+以ä¸\8bã\81«ã\83ªã\82¹ã\83\88ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\80\81æ\9c\80å\88\9dã\81® 3 ã\81¤ã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³ã\83\98ã\83\83ã\83\80ã\83¼ã\83\9eã\82¯ã\83
.Ql \&.Sh
はすべての man ページで必須のものです。
-残りのセクションヘッダはマニュアルページの作者の裁量において、
+æ®\8bã\82\8aã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³ã\83\98ã\83\83ã\83\80ã\83¼ã\81¯ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\83\9aã\83¼ã\82¸ã\81®ä½\9cè\80\85ã\81®è£\81é\87\8fã\81«ã\81\8aã\81\84ã\81¦ã\80\81
推奨されているものです。
.Ql \&.Sh
マクロは 9 つまでの引数を取ることができます。
これは解析されますが、呼び出し不可能です。
-.Bl -tag -width ".Sh SYNOPSIS"
+.Bl -tag -width "\&.Sh SYNOPSIS"
.It \&.Sh 名前
-.Sx 名前
+.Sh 名前
(NAME) マクロは必須のものです。
-これが指定されていないと、ヘッダとフッタ、それにデフォルトの
+ã\81\93ã\82\8cã\81\8cæ\8c\87å®\9aã\81\95ã\82\8cã\81¦ã\81\84ã\81ªã\81\84ã\81¨ã\80\81ã\83\98ã\83\83ã\83\80ã\83¼ã\81¨ã\83\95ã\83\83ã\82¿ã\80\81ã\81\9dã\82\8cã\81«ã\83\87ã\83\95ã\82©ã\83«ã\83\88ã\81®
ページレイアウトが設定されず、結果はかなり好ましくないものになるでしょう。
.Sx NAME
セクションは最低 3 つの項目からなります。
が必要です。
その他のいくつかのマクロが下に示すような書式行を生成するために必要な
ことがあります。
+.El
.Pp
.Bd -filled -offset indent
.Nm cat
解釈します。この他で \*(Ba が使える場合については
.Sx 定義済みの文字列
セクションを参照して下さい。
+.Bl -tag
.It \&.Sh 説明
.Sx 説明
(DESCRIPTION) セクションでの最初のテキストは、
.Pp
以下の
.Ql \&.Sh
-のセクションヘッダはマニュアルページの好ましい
+ã\81®ã\82»ã\82¯ã\82·ã\83§ã\83³ã\83\98ã\83\83ã\83\80ã\83¼ã\81¯ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\83\9aã\83¼ã\82¸ã\81®å¥½ã\81¾ã\81\97ã\81\84
レイアウトの一部であり、一貫性を保つために適切に使われなければ
なりません。これらは使われる順番にリストされています。
.Bl -tag -width SYNOPSIS
あきらかな問題はここで記述します...
.El
.Pp
-ユーザ指定の
+ユーザー指定の
.Ql \&.Sh
セクションを追加することができます。
たとえば、このセクションは以下のように設定されています。
インデント
.Ql \&.Bd
のオフセット値を指定することができます。
+.El
.Pp
.Bl -tag -width "file file_name " -compact
.It Fl ragged
.Xr troff
ではまったくちゃんと動作してくれていません。
.El
-.El
.It .Ed
ディスプレイ終了。
.El
強調の場合、通常イタリック体のフォントが使われます。
.Pp
.Dl 使い方: .Em argument ... \*(Pu
-.Bl -tag -width ".Em vide infra ) ) ," -compact -offset 14n
+.Bl -tag -width "\&.Em vide infra ) ) ," -compact -offset 14n
.It Li ".Em does not"
.Em does not
.It Li ".Em exceed 1024 ."
通りに表示する必要があるものに使用することができます。
.Pp
.Dl 使い方: .Li argument ... \*(Pu
-.Bl -tag -width ".Li cntrl-D ) ," -compact -offset 14n
+.Bl -tag -width "\&.Li cntrl-D ) ," -compact -offset 14n
.It Li \&.Li \een
.Li \en
.It Li \&.Li M1 M2 M3\ ;
通常はボールドマクロとなっています。
.Pp
.Dl 使い方: .Sy symbol ... \*(Pu
-.Bl -tag -width ".Sy Important Noticex" -compact -offset 14n
+.Bl -tag -width "\&.Sy Important Noticex" -compact -offset 14n
.It Li \&.Sy Important Notice
.Sy Important Notice
-.El
.Pp
.Ql \&.Sy
マクロは解析され、呼び出し可能です。
.Ql \&.Sy
の引数は引用符で囲むことができます。
+.El
.It Li \&.Bf
フォントモード開始。
フォントモード
でリストしました。
このリストのタイプは
.Tn TeX
-のユーザに非常に人気のあるものですが、
+ã\81®ã\83¦ã\83¼ã\82¶ã\83¼ã\81«é\9d\9e常ã\81«äººæ°\97ã\81®ã\81\82ã\82\8bã\82\82ã\81®ã\81§ã\81\99ã\81\8cã\80\81
tag リストで構成されたページを何ページも読んだ後には幾分変に見える
でしょう。以下のリストタイプを
.Ql ".Bl"
\&最後にみっつめはここ。
\&.El
.Ed
+.El
.Pp
これらの結果は以下のようになります。
.Pp
これはふたつめの bullet。
.El
.Pp
+.Bl -ohang -compact
.It Fl tag
.It Fl diag
.It Fl hang
ぶら下げ、インデントしません。
.Em tag
では、タグつきテキストの形式にします。ちなみに上のリストは
-.Ql Fl ohang
+.Ql \&Fl ohang
リストタイプで構成されています。
.Ql \&.It
マクロは inset, hang, tag のリストタイプでのみ解析され、
呼び出し不可能です。以下に inset ラベルの例を示します。
+.El
.Bl -inset -offset indent
.It Em Tag
tag リスト (tag 段落とも呼ばれる) は、
.Tn I/O
の回数
.It UID
-プロセスの所有者の数字表記によるユーザID
+プロセスの所有者の数字表記によるユーザーID
.It PPID
親プロセスの数字表記によるID、プロセスの優先度
(割り込み不可のウエイトであるときには非正値)
\&.Tn I/O
\&の回数
\&.It UID
-\&プロセスの所有者の数字表記によるユーザID
+\&プロセスの所有者の数字表記によるユーザーID
\&.It PPID
\&親プロセスの数字表記によるID、プロセスの優先度
\&(割り込み不可のウエイトであるときには非正値)
.It Fl width Ar "\*qint mkfifo\*q"
これも、指定された文字列の固定長に幅をセットします。
.El
-.El
.Pp
タグつきリストタイプで幅が指定されていないと、
.Ql \&.It
.Sh 診断
.Nm \-mdoc
は限られたデバッグ機能しか持っていませんが、
-引数名と内部レジスタやマクロ名との衝突のような
+å¼\95æ\95°å\90\8dã\81¨å\86\85é\83¨ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\82\84ã\83\9eã\82¯ã\83å\90\8dã\81¨ã\81®è¡\9dçª\81ã\81®ã\82\88ã\81\86ã\81ª
潜在的なエラーを検出するのに役立ちます。 (A って何?)
-レジスタは
+ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\81¯
.Xr troff
での演算用記憶クラスであり、
1 文字か 2 文字の名称がついています。
.Xr ditroff
での
.Nm \-mdoc
-のすべての内部レジスタは
+ã\81®ã\81\99ã\81¹ã\81¦ã\81®å\86\85é\83¨ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\81¯
.Ql \&Ar
のように2 文字からなる <大文字><小文字> の形式か、
.Ql \&aR
の形式を取ります。
さらに混乱することに、
.Xr troff
-はそれ自身の内部レジスタを持ち、
+ã\81¯ã\81\9dã\82\8cè\87ªèº«ã\81®å\86\85é\83¨ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\82\92æ\8c\81ã\81¡ã\80\81
それらすべては小文字 2 文字か、ドットに文字もしくはメタ文字が続く形式を取ります。
紹介例の 1 つに、エスケープシーケンス
.Ql \e&
でマクロ名を
-解釈させない方法がありました。これは内部レジスタ名にも有効です。
+解釈させない方法がありました。これは内部レジスター名にも有効です。
.Pp
.\" Every callable macro name has a corresponding register
.\" of the same name (<upper_case><lower_case>).
.\" w[0-9] width tag/label stack
.\" .Ed
.\" .Pp
-エスケープされていないレジスタ名が引数リストに指定されると、
+エスケープされていないレジスター名が引数リストに指定されると、
予期できない振舞いとなります。
一般的には、テキストのかなり大きな部分が出力されるべきところに
出力されないとか、リストのタグのような小さな文字列が消えてしまうとか、
とその長さが
出力されています。引数の長さが 2 文字であれば、
その引数が実行可能
-(ゼロでない値を含むすべてのレジスタは実行可能なように見えます)
+(ã\82¼ã\83ã\81§ã\81ªã\81\84å\80¤ã\82\92å\90«ã\82\80ã\81\99ã\81¹ã\81¦ã\81®ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\81¯å®\9fè¡\8cå\8f¯è\83½ã\81ªã\82\88ã\81\86ã\81«è¦\8bã\81\88ã\81¾ã\81\99)
かどうかテストされます。
3 番目の行ではそのクラスで指定されているスペースとクラスタイプが
出力されています。
は先の例と同様に長さ 2 と表示されています。
しかし、
.Ql \e&aC
-という名称のレジスタが見つからず、
+ã\81¨ã\81\84ã\81\86å\90\8d称ã\81®ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\81\8cè¦\8bã\81¤ã\81\8bã\82\89ã\81\9aã\80\81
タイプは文字列と判断されています。
.Pp
この他の診断は使用方法を報告するものであり、
このパッケージでは改ページと、
.Xr nroff
で改ページ時に通常挿入
-されるヘッダとフッタは禁止されており、マニュアルをオンラインで効率良く
+ã\81\95ã\82\8cã\82\8bã\83\98ã\83\83ã\83\80ã\83¼ã\81¨ã\83\95ã\83\83ã\82¿ã\81¯ç¦\81æ¢ã\81\95ã\82\8cã\81¦ã\81\8aã\82\8aã\80\81ã\83\9eã\83\8bã\83¥ã\82¢ã\83«ã\82\92ã\82ªã\83³ã\83©ã\82¤ã\83³ã\81§å\8a¹ç\8e\87è\89¯ã\81\8f
見ることができるようになっています。現在の所、
.Fl T Ns Ar ascii
が
において 0 にセットする
ことができる
.Ql \&cR
-の名称を持つレジスタが古いスタイルの振る舞い
+ã\81®å\90\8d称ã\82\92æ\8c\81ã\81¤ã\83¬ã\82¸ã\82¹ã\82¿ã\83¼ã\81\8cå\8f¤ã\81\84ã\82¹ã\82¿ã\82¤ã\83«ã\81®æ\8c¯ã\82\8bè\88\9eã\81\84
を実現するために用意されています。
.Sh ファイル
.Bl -tag -width /usr/share/man0/template.doc -compact
.Pp
あらかじめ定義されている文字列は文書において宣言されていません。
.Pp
-セクション 3f はヘッダルーチンには追加されていません。
+ã\82»ã\82¯ã\82·ã\83§ã\83³ 3f ã\81¯ã\83\98ã\83\83ã\83\80ã\83¼ã\83«ã\83¼ã\83\81ã\83³ã\81«ã\81¯è¿½å\8a ã\81\95ã\82\8cã\81¦ã\81\84ã\81¾ã\81\9bã\82\93ã\80\82
.Pp
.Ql \&.Nm
フォントは
ことがあり、行がフィルモードであるときには全くおかしな結果になること
があります。
.Pp
-nroff 使ç\94¨æ\99\82ã\81«ã\80\81(æ\9c\80å\88\9dã\81®ã\83\98ã\83\83ã\83\80ã\81¨ã\83\95ã\83\83ã\82¿ä»¥å¤\96ã\81®) æ\94¹ã\83\9aã\83¼ã\82¸æ\99\82ã\81®ã\83\98ã\83\83ã\83\80と
+nroff 使ç\94¨æ\99\82ã\81«ã\80\81(æ\9c\80å\88\9dã\81®ã\83\98ã\83\83ã\83\80ã\83¼ã\81¨ã\83\95ã\83\83ã\82¿ä»¥å¤\96ã\81®) æ\94¹ã\83\9aã\83¼ã\82¸æ\99\82ã\81®ã\83\98ã\83\83ã\83\80ã\83¼と
フッタの挿入を行わないようにするのに使用される命令によって、
ときどき見るに耐えない部分的な行詰め (や空行) がページの末尾に
発生する場合がある。
.Sh この文書について
この man ページは Linux
.Em man-pages
-プロジェクトのリリース 3.40 の
-一部である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man-pages/ に書かれている。
+プロジェクトのリリース 3.78
+の一部である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man-pages/ に書かれている。