--- tar.1.orig	2020-10-14 09:43:37.887215780 +0900
+++ tar.1	2020-10-14 09:44:32.047414932 +0900
@@ -18,6 +18,15 @@
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
+.\"
+.\" Japanese Version Copyright (c) 1997 Atsushi Yamagata,
+.\"   and 2020 Yuichi Sato and Yoichi Chonan,
+.\"         all rights reserved.
+.\" 1997/09/17 Atsushi Yamagata <yamagata@jwu.ac.jp>
+.\" Updated and modified (tar-1.32) Wed Feb 26 18:15:15 JST 2020
+.\"         by Yuichi SATO <ysato444@ybb.ne.jp>
+.\"         and Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
+.\"
 .TH TAR 1 "February 4, 2019" TAR "GNU TAR Manual"
 .SH 名前
 tar \- アーカイブユーティリティ
@@ -126,11 +135,13 @@
 .PP
 上で例示したコマンドは、 \fB短いオプション形式\fPで書けば、以下のようになるだろう。
 .PP
-.EX
+.\" .EX
+.nf
 \fBtar \-cvf etc.tar /etc\fP
 または、
 \fBtar \-c \-v \-f etc.tar /etc\fP
-.EE
+.fi
+.\" .EE
 .PP
 \fBGNU スタイル\fP、すなわち\fB長いオプション形式\fPでは、 各オプションは、2 個のダッシュに続く意味を持った名前であり、
 小文字とダッシュから構成されている。使用に当たって、長いオプションは、
@@ -140,19 +151,28 @@
 .PP
 上記のコマンド例をこの形式で書くには、次のようないくつかの方法がある。
 .PP
-.EX
+.\" .EX
+.nf
 \fBtar \-\-create \-\-file etc.tar \-\-verbose /etc\fP
-.EE
+.\" .EE
 または (オプションをいくつか短縮して)、
-.EX
+.\" .EX
 \fBtar \-\-cre \-\-file=etc.tar \-\-verb /etc\fP
-.EE
+.fi
+.\" .EE
+.IP "[\fB訳注\fP]:" 8
+二番目の用例は、失敗すると思う。現在では、\fB\-\-verbose\fP のほかに 
+\fB\-\-verbatim\-files\-from\fP というオプションもあるので、
+\fB\-\-verb\fP では曖昧になってしまうのだ。
 .PP
 オプションは、3 種の形式すべてを混ぜて使うことができるが、 伝統的なオプションを混ぜて使うのはお勧めできない。
 .SS 操作モード
 以下に列挙したオプションは、GNU \fBtar\fP にかくかくしかじかの操作をせよと命ずるものだ。
 指定するのは、この内のただ 1 つでなければならない。
 オプションの引き数ではない引き数がどんな意味になるかは、要求した操作モード次第である。
+.IP "[\fB訳注\fP]" 8
+以下、この「\fB操作モード\fP」セクションの中で、単に「引き数」とだけ言ったときは、
+オプションの引き数ではない引き数のことである。
 .TP 
 \fB\-A\fP, \fB\-\-catenate\fP, \fB\-\-concatenate\fP
 アーカイブを別のアーカイブの末尾に追加する。
@@ -250,6 +270,23 @@
 \fB\-\-listed\-incremental\fP は引き数を取ることになっているので、\fIFILE\fP
 の指定が必要なだけなのだ。それ故、\fIFILE\fP として \fB/dev/null\fP
 を使うのは、常套手段である。
+.RS
+.IP "[\fB訳注\fP]" 8
+\fBlevel\fP の利用法については、すこし説明が足りないと思う。
+たとえば、最初にインクリメンタルアーカイブを作成したときに
+(すなわち level 0 のダンプをしたときに)
+作ったスナップショットファイルが ./snap だったとしよう。これを snap0
+としてバックアップしておく。そして、インクリメンタルバックアップを行うたびに、この
+snap0 をコピーしてスナップショットファイルとして使用する。そうすると、常に
+level 1 のインクリメンタルアーカイブが出来るわけだ。
+こうしておけば、最初のアーカイブと最後のアーカイブを抽出
+(この場合、「展開」の方がピッタリした表現だが)
+するだけで、最後のインクリメンタルアーカイブを作成したときの状態が復元できることになる。
+もし復元したいのが、最後の 1 つ前の状態なら、最初と最後の
+1 つ前のアーカイブを使用すればよい。
+\fBinfo tar\fP の "Incremental Dumps" と "Backup Levels"
+を参照していただきたい。
+.RE
 .TP 
 \fB\-\-hole\-detection\fP=\fIMETHOD\fP
 スパースファイル (sparse file) の穴 (hole) の検出に
@@ -359,7 +396,6 @@
 .SS 出力ストリームに関する選択
 .TP 
 \fB\-\-ignore\-command\-error\fP
-.TP 
 サブプロセスの終了コードを無視する。
 .TP 
 \fB\-\-no\-ignore\-command\-error\fP
@@ -444,9 +480,10 @@
 .TP 
 \fBTAR_FORMAT\fP
 処理しているアーカイブのフォーマット。\fBgnu\fP, \fBoldgnu\fP, \fBposix\fP,
-\fBustar\fP, \fBv7\fP の内の 1 つ。\fBTAR_SUBCOMMAND\fP
-\fBtar\fP が実行中の操作を表す短いオプション
-(前に 1 個のダッシュが付いたもの)。
+\fBustar\fP, \fBv7\fP の内の 1 つ。
+.TP
+\fBTAR_SUBCOMMAND\fP
+\fBtar\fP が実行中の操作を表す短いオプション (前に 1 個のダッシュが付いたもの)。
 .RE
 .SS ファイル属性の操作
 .TP 
@@ -498,6 +535,11 @@
 .TP 
 \fB\-\-no\-same\-owner\fP
 実行ユーザ自身の資格でファイルを抽出する (一般ユーザのデフォルト)。
+.RS
+.IP "[\fB訳注\fP]:" 8
+抽出したファイルは、自分の資格でディスクに書き込むわけだから、
+一般ユーザのデフォルトでは、その所有者属性は当然自分のものになる。
+.RE
 .TP 
 \fB\-\-no\-same\-permissions\fP
 アーカイブから許可属性を抽出する際、実行ユーザの umask を適用する (一般ユーザのデフォルト)。
@@ -573,6 +615,15 @@
 について、格納や抽出から除外するパターンを指定する。\fIPATTERN\fP は POSIX
 の正規表現である。たとえば、\fB\-\-xattrs\-exclude='^user.'\fP
 と指定すれば、名前空間 user の属性を除外することになる。
+.RS
+.IP "[\fB訳注\fP]"
+次の項目についても言えることだが、訳者の手元の tar-1.32 では
+\fB\-\-xattrs\-exclude\fP と \fB\-\-xattrs\-include\fP
+の働きが、説明とは逆になっているようだ。
+つまり、exclude で採用するパターンを指定し、include
+で除外するパターンを指定するようになっている。
+ご自分のところではどうなるか、確かめていただきたい。
+.RE
 .TP 
 \fB\-\-xattrs\-include=\fP\fIPATTERN\fP
 xattr のキーについて、格納や抽出時にインクルードするパターンを指定する。
@@ -640,6 +691,7 @@
 新しいボリューム名を \fBtar\fP
 に伝えるために使うことができるファイルディスクリプタ。
 .RE
+.PP
 .RS
 
 指定された info script が失敗した場合、\fBtar\fP
@@ -731,6 +783,12 @@
 を付けて、アーカイブを作成する。
 内容表示や抽出をする際にこのオプションを指定した場合は、\fITEXT\fP
 をボリューム名の glob パターンとして使用する。
+.RS
+.IP "[\fB訳注\fP]" 8
+内容表示や抽出をする際に \fB\-f\fP オプションの代わりに使えるわけではない。
+そういうボリューム名を持つアーカイブに対してのみ、内容表示や抽出を行うということであって、
+\fB\-f\fP \fIARCHIVE\fP はやはり必要である。
+.RE
 .SS 圧縮オプション
 .TP 
 \fB\-a\fP, \fB\-\-auto\-compress\fP
@@ -740,6 +798,12 @@
 データを \fICOMMAND\fP でフィルタする。コマンドは、伸長するための
 \fB\-d\fP オプションを解するものでなければならない。
 引き数にはコマンドラインオプションも含めることができる。
+.RS
+.IP "[\fB訳注\fP]" 8
+圧縮・伸長プログラムが \fB\-d\fP
+オプションを解しさえすればよいのであって、抽出・内容表示時に
+\fICOMMAND\fP 中で \fB\-d\fP を指定する必要があるということではない。
+.RE
 .TP 
 \fB\-j\fP, \fB\-\-bzip2\fP
 アーカイブを \fBbzip2\fP(1)  でフィルタする。
@@ -792,9 +856,9 @@
 .TP 
 \fBnever\fP, \fBsimple\fP
 常に単純形式のバックアップを行う。
-.RS
 .RE
-
+.PP
+.RS
 \fICONTROL\fP が指定されない場合、環境変数 \fBVERSION_CONTROL\fP
 から値を取得する。それも指定されていない場合は、\fBexisting\fP
 が指定されているものと見なされる。
@@ -827,6 +891,13 @@
 ディレクトリをダンプする前に、\fIFILE\fP というファイルがそこに含まれているかを調べる。
 含まれている場合は、そのファイルから除外パターンを読み込む。
 このパターンは、そのディレクトリにのみ影響する。
+.RS
+.IP "[\fB訳注\fP]" 8
+訳者の手元の tar-1.32 では、このオプションの動作は、次の項目の
+\fB\-\-exclude\-ignore\-recursive\fP と同じであるようだ。
+すなわち、そのディレクトリ以下のサブディレクトリにも影響する。
+ご自分のところではどうなるか、確かめていただきたい。
+.RE
 .TP 
 \fB\-\-exclude\-ignore\-recursive=\fP\fIFILE\fP
 \fB\-\-exclude\-ignore\fP と同様であるが、\fIFILE\fP
@@ -870,6 +941,20 @@
 .TP 
 \fB\-\-no\-recursion\fP
 ディレクトリにおいて自動的な下降をしないようにする。
+.RS
+.IP "[\fB訳注\fP]:" 8
+わかりにくいと思うので、もう少し説明する。\fB\-\-create\fP 
+でこのオプションを使用すると、アーカイブする対象としてディレクトリを指定した場合、
+そのディレクトリ自体はアーカイブに入れられるが、
+そのディレクトリにあるファイルやサブディレクトリは、自動的にはアーカイブに格納されなくなる。
+ファイルも一緒に格納したいのなら、それもアーカイブする対象として指定しなければならないのだ。
+従って、このオプションは、たとえば find コマンドと \fB\-\-files\-from='\-\'\fP 
+オプションを使って、アーカイブする対象のリストを厳密に指定するときなどに、役に立つ。
+\fB\-\-extract\fP と組み合わせ、抽出対象にディレクトリを指定した場合は、
+そのディレクトリだけが抽出され、ディレクトリの中身は抽出されない。
+なお、このオプションはコマンドラインにおける順番を意識する。
+詳しいことは \fBinfo tar recurse\fP を参照していただきたい。
+.RE
 .TP 
 \fB\-\-no\-unquote\fP
 指定された入力ファイル名やメンバー名中の、バックスラッシュでクォートされたシーケンスを解釈・変換しない
@@ -894,6 +979,15 @@
 (つまり、\fB\-T\fP オプションでダッシュで始まる名前の特別扱いをしなくなる)。
 
 \fB\-\-verbatim\-files\-from\fP も参照すること。
+.RS
+.IP "[\fB訳注\fP]"
+\fB\-\-null\fP オプションの第一の働きは、それ以後に現れる \fB\-T\fP
+オプションに対して、ファイルリストの各項目が、改行ではなく、
+ASCII NUL で区切られていると知らせることである。
+上の説明で述べているようなことは、二次的な働きというか、むしろ、
+このオプションによって自動的に設定される
+\fB\-\-verbatim\-files\-from\fP の働きだと言える。
+.RE
 .TP 
 \fB\-N\fP, \fB\-\-newer\fP=\fIDATE\fP, \fB\-\-after\-date\fP=\fIDATE\fP
 DATE より新しいファイルのみを格納する。 \fIDATE\fP が \fB/\fP または \fB.\fP で始まっている場合は、
@@ -919,11 +1013,23 @@
 別の指定がないかぎり、\fIFILE\fP の内容は、ASCII \fBLF\fP で区切られた名前のリストでなければならない (つまり、1 行に 1
 個の名前だ)。 読み込まれた名前は、コマンドラインの引き数と同じやり方で処理される。 すなわち、引用符が除去され、単語に分割され、そして、ダッシュ
 (\fB\-\fP)  で始まる文字列があれば、\fBtar\fP のコマンドラインオプションとして処理される。
+.RS
+.IP "[\fB訳注\fP]:" 8
+上のパラグラフの後半で説明しているのは、オプションを指定した行が \fIFILE\fP
+中にあるかどうかを知るために \fBtar\fP
+が取る手続きであって、ファイル名を指定した行の扱いには関係がないようだ。
+そうした行は、あるがままに、すなわち、引用符に囲まれていれば、
+引用符が付いたものとして、先頭に空白があれば、空白に始まるファイル名として、扱われる。また、手元の
+\fBtar\fP 1.32 では、オプションの行でも、引用符の除去はやっていないようである。
+.RE
 
+.PP
+.RS
 この動作が望ましくない場合は、 \fB\-\-verbatim\-files\-from\fP オプションでやめさせることができる。
 
 \fB\-\-null\fP オプションを指定すると、\fBtar\fP は \fIFILE\fP 中の名前の区切りを \fBLF\fP ではなく、ASCII \fBNUL\fP
 文字にする。 これはリストが \fBfind\fP(1)  の \fB\-print0\fP アクションで生成されている場合に役に立つ。
+.RE
 .TP 
 \fB\-\-unquote\fP
 指定された入力ファイル名やメンバー名中の、バックスラッシュでクォートされたシーケンスを解釈・変換する
@@ -1022,7 +1128,7 @@
 内容表示や抽出をする際、検索の基準にマッチしないディレクトリに出会うごとに、その旨表示する
 (訳注: 要するに、何らかの理由で、内容表示や抽出をスキップするディレクトリがあれば、
 それを知らせるということ。\fBinfo tar verbose\fP
-を実行すると、そのセクションにこのオプションのかなり詳しい説明がある)。
+を実行すると、そのセクション中にこのオプションのかなり詳しい説明がある)。
 .TP 
 \fB\-\-show\-transformed\-names\fP, \fB\-\-show\-stored\-names\fP
 ファイル名やアーカイブ名を表示する際、\fB\-\-strip\fP や \fB\-\-transform\fP オプションで変更した後の名前を使う (訳注:
@@ -1137,6 +1243,7 @@
 .EX
 $ tar \-\-warning=decompress\-program \-x \-f archive.Z
 tar (child): cannot run compress: No such file or directory
+.br
 tar (child): trying gzip
 .EE
 
@@ -1232,9 +1339,18 @@
 .ad
 This is free software: you are free to change and redistribute it.  There is
 NO WARRANTY, to the extent permitted by law.
+.SH 訳者謝辞
+\fBtar\fP の出す警告文は、Masahito Yamaga さんによる tar-1.32 
+のメッセージカタログの翻訳を利用させていただきました。お礼を申し上げます。
+ただし、このマニュアル内で読みやすいように、すこし手を加えたところもあります。
+ご了承ください。
+.PP
+なお、翻訳に当たっては、できるだけ実際に動かして確認していますが、
+テープドライブは使ったことがありません。そのため、そのへんの翻訳については、
+間違いがあるかもしれません。お気づきの点がありましたら、ご教示いただけるとありがたく思います。
 .\" Local variables:
 .\" eval: (add-hook 'write-file-hooks 'time-stamp)
-.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\-]* [0-9] \""
+.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \""
 .\" time-stamp-format: "%:B %:d, %:y"
 .\" time-stamp-end: "\""
 .\" time-stamp-line-limit: 20
