X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman7%2Fmdoc.samples.7;h=9bac6643418af12a75bd8ca1b961f16cfbf14579;hb=c1dfa2f6ab1bbed84992d3c59ee9925f4d453668;hp=acf4e5630f3a6352cadb727fe930a3a3ae412cc3;hpb=be16a3bc05b85985725ce38dd4898e404559d4b3;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man7/mdoc.samples.7 b/release/man7/mdoc.samples.7 index acf4e563..9bac6643 100644 --- a/release/man7/mdoc.samples.7 +++ b/release/man7/mdoc.samples.7 @@ -1,6 +1,7 @@ .\" 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: @@ -28,6 +29,7 @@ .\" 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 $ @@ -36,6 +38,8 @@ .\" 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. @@ -511,10 +515,10 @@ man ページタイトルをそのページが属するマニュアルの ボリュームタイトルには任意のものか次のいずれかを指定します。 .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 @@ -781,7 +785,7 @@ troff コマンドは一般的に以下のような形式をとります。 アドレスを識別します。 .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\ . @@ -805,7 +809,7 @@ troff コマンドは一般的に以下のような形式をとります。 名前の情報の後のすべての引数は句読点として扱われます。 .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\ , @@ -827,7 +831,7 @@ troff コマンドは一般的に以下のような形式をとります。 使用することができます。 .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 @@ -844,7 +848,7 @@ troff コマンドは一般的に以下のような形式をとります。 .Pp .Ql \&.Ar が引数なしで呼び出されると、 -.Ql Ar +.Ql \&.Ar として扱われます。 .Ql \&.Ar マクロは解析され、呼び出し可能です。 @@ -881,7 +885,7 @@ troff コマンドは一般的に以下のような形式をとります。 マクロによって指定します。 .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 )" @@ -905,7 +909,7 @@ troff コマンドは一般的に以下のような形式をとります。 と共に使われています。 .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\ )\ ; @@ -923,7 +927,7 @@ troff コマンドは一般的に以下のような形式をとります。 マクロは環境変数を指定します。 .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\ . @@ -957,7 +961,7 @@ troff コマンドは一般的に以下のような形式をとります。 は構造体のメンバを参照する場合にも使われます。 .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 @@ -998,7 +1002,7 @@ troff コマンドは一般的に以下のような形式をとります。 同じ働きをします。 .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 @@ -1029,7 +1033,7 @@ troff コマンドは一般的に以下のような形式をとります。 .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 ) ," @@ -1124,7 +1128,7 @@ man ページ中の他の場所でも問題なく使うことができますが マクロは対話的なコマンド、もしくは内部コマンドを指定します。 .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 {...} @@ -1171,7 +1175,7 @@ man ページ中の他の場所でも問題なく使うことができますが 記憶することはできません。 .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 @@ -1195,7 +1199,7 @@ man ページ中の他の場所でも問題なく使うことができますが できます。 .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" @@ -1245,7 +1249,7 @@ man ページ中の他の場所でも問題なく使うことができますが マクロはパス名もしくはファイル名をフォーマットします。 .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\ )\ . @@ -1258,7 +1262,7 @@ man ページ中の他の場所でも問題なく使うことができますが 一般的な変数への参照です。 .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 , @@ -1280,7 +1284,7 @@ man ページ中の他の場所でも問題なく使うことができますが すべての残りの引数は句読点と見なされます。 .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\ , @@ -1300,7 +1304,7 @@ man ページ中の他の場所でも問題なく使うことができますが .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 ." @@ -1316,7 +1320,7 @@ man ページ中の他の場所でも問題なく使うことができますが 最大 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 ." @@ -1329,7 +1333,7 @@ man ページ中の他の場所でも問題なく使うことができますが .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 @@ -1343,7 +1347,7 @@ man ページ中の他の場所でも問題なく使うことができますが 最大 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 @@ -1423,7 +1427,7 @@ man ページ中の他の場所でも問題なく使うことができますが .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\ )\ , @@ -1479,7 +1483,7 @@ man ページ中の他の場所でも問題なく使うことができますが マクロはマクロ間での不要な空白を除去します。 これはフラグと引数の間に空白を含まない古いスタイルの引数リストを使う 場合に便利です。 -.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 @@ -1559,11 +1563,13 @@ man ページ中の他の場所でも問題なく使うことができますが .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 のマニュアルページでのみ有効です。 @@ -1572,7 +1578,7 @@ man ページ中の他の場所でも問題なく使うことができますが 使われる小さな大文字のマクロです。 .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 @@ -1701,9 +1707,9 @@ man ページ中の他の場所でも問題なく使うことができますが .Ql \&.Sh マクロは 9 つまでの引数を取ることができます。 これは解析されますが、呼び出し不可能です。 -.Bl -tag -width ".Sh SYNOPSIS" +.Bl -tag -width "\&.Sh SYNOPSIS" .It \&.Sh 名前 -.Sx 名前 +.Sh 名前 (NAME) マクロは必須のものです。 これが指定されていないと、ヘッダとフッタ、それにデフォルトの ページレイアウトが設定されず、結果はかなり好ましくないものになるでしょう。 @@ -1751,6 +1757,7 @@ man ページ中の他の場所でも問題なく使うことができますが が必要です。 その他のいくつかのマクロが下に示すような書式行を生成するために必要な ことがあります。 +.El .Pp .Bd -filled -offset indent .Nm cat @@ -1784,6 +1791,7 @@ man ページ中の他の場所でも問題なく使うことができますが 解釈します。この他で \*(Ba が使える場合については .Sx 定義済みの文字列 セクションを参照して下さい。 +.Bl -tag .It \&.Sh 説明 .Sx 説明 (DESCRIPTION) セクションでの最初のテキストは、 @@ -2099,6 +2107,7 @@ man ページのサブジェクトによって使用されるか生成される インデント .Ql \&.Bd のオフセット値を指定することができます。 +.El .Pp .Bl -tag -width "file file_name " -compact .It Fl ragged @@ -2150,7 +2159,6 @@ man ページのサブジェクトによって使用されるか生成される .Xr troff ではまったくちゃんと動作してくれていません。 .El -.El .It .Ed ディスプレイ終了。 .El @@ -2164,7 +2172,7 @@ man ページのサブジェクトによって使用されるか生成される 強調の場合、通常イタリック体のフォントが使われます。 .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 ." @@ -2184,7 +2192,7 @@ man ページのサブジェクトによって使用されるか生成される 通りに表示する必要があるものに使用することができます。 .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\ ; @@ -2203,15 +2211,15 @@ man ページのサブジェクトによって使用されるか生成される 通常はボールドマクロとなっています。 .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 フォントモード開始。 フォントモード @@ -2297,6 +2305,7 @@ tag リストで構成されたページを何ページも読んだ後には幾 \&最後にみっつめはここ。 \&.El .Ed +.El .Pp これらの結果は以下のようになります。 .Pp @@ -2327,6 +2336,7 @@ tag リストで構成されたページを何ページも読んだ後には幾 これはふたつめの bullet。 .El .Pp +.Bl -ohang -compact .It Fl tag .It Fl diag .It Fl hang @@ -2346,11 +2356,12 @@ tag リストで構成されたページを何ページも読んだ後には幾 ぶら下げ、インデントしません。 .Em tag では、タグつきテキストの形式にします。ちなみに上のリストは -.Ql Fl ohang +.Ql \&Fl ohang リストタイプで構成されています。 .Ql \&.It マクロは inset, hang, tag のリストタイプでのみ解析され、 呼び出し不可能です。以下に inset ラベルの例を示します。 +.El .Bl -inset -offset indent .It Em Tag tag リスト (tag 段落とも呼ばれる) は、 @@ -2463,7 +2474,6 @@ The raw text: .It Fl width Ar "\*qint mkfifo\*q" これも、指定された文字列の固定長に幅をセットします。 .El -.El .Pp タグつきリストタイプで幅が指定されていないと、 .Ql \&.It @@ -2783,8 +2793,8 @@ nroff 使用時に、(最初のヘッダとフッタ以外の) 改ページ時 .Xr groff_mdoc 7 , .Xr mdoc 7 .Sh この文書について -この man ページは Linux +This page is part of release 3.53 of the Linux .Em man-pages -プロジェクトのリリース 3.40 の -一部である。プロジェクトの説明とバグ報告に関する情報は -http://www.kernel.org/doc/man-pages/ に書かれている。 +project. A +description of the project, and information about reporting bugs, can be +found at \%http://www.kernel.org/doc/man\-pages/.