manual/util-linux/po4a/man1/hexdump-ja.patch

   1 --- hexdump.1.orig      2020-04-15 16:45:05.718041544 +0900
   2 +++ hexdump.1   2020-04-15 16:49:05.601964559 +0900
   3 @@ -36,11 +36,38 @@
   4  .\" This file was generated with po4a. Translate the source file.
   5  .\"
   6  .\"*******************************************************************
   7 +.\"
   8 +.\" The original version of this translation was contributed
   9 +.\" to Linux JM project from NetBSD jman proj.
  10 +.\"
  11 +.\" The copyright for the modified parts of the translation blongs to us
  12 +.\" with Linux JM project.
  13 +.\"
  14 +.\" Japanese Version Copyright for the modified parts (c) 2001-2020 Yuichi SATO
  15 +.\"   and 2020 Yoichi Chonan,
  16 +.\"         all rights reserved.
  17 +.\" Translated Tue 11 Jan 1994
  18 +.\"         by NetBSD jman proj. <jman@spa.is.uec.ac.jp>
  19 +.\" Updated Sun Jan 14 00:49:38 JST 2001
  20 +.\"         by Yuichi SATO <sato@complex.eng.hokudai.ac.jp>
  21 +.\" Updated Sun Mar 24 11:54:42 JST 2002
  22 +.\"         by Yuichi SATO <ysato@h4.dion.ne.jp>
  23 +.\" Updated & Modified (util-linux 2.34) Wed Apr 15 16:47:56 JST 2020
  24 +.\"         by Yuichi SATO <ysato444@ybb.ne.jp>
  25 +.\"         and Yoichi Chonan <cyoichi@maple.ocn.ne.jp>
  26 +.\"
  27  .TH HEXDUMP 1 "April 2013" util\-linux "User Commands"
  28  .SH 名前
  29  hexdump \- ファイルの内容を 16 進数、10 進数、8 進数、ASCII 文字で表示する
  30  .SH 書式
  31  \fBhexdump\fP [options]\fI file\fP...
  32 +.SH 読者へのご注意
  33 +これは、util-linux 版の \fBhexdump\fP コマンドのマニュアルである。\fBhexdump\fP
  34 +コマンドの実装には、いくつかの系統がある。御使用のディストリビューションが
  35 +util-linux 版以外の \fBhexdump\fP コマンドを採用している場合は、
  36 +動作やオプションがここで説明しているものとかなり違っているかもしれない。
  37 +そういうときは、英語版しかないかもしれないが、お手元の \fBhexdump\fP
  38 +コマンドに付属するマニュアルに当たってみていただきたい。
  39  .SH 説明
  40  \fBhexdump\fP ユーティリティは、指定されたファイルをユーザーが指定したフォーマットで表示するフィルタである。
  41  ファイルが指定されていない場合は、標準入力を処理の対象にする。
  42 @@ -133,6 +160,19 @@
  43  で区切られた任意の数のフォーマット単位から構成される。1 つのフォーマット単位は、最大で
  44  3 個の要素、すなわち、繰り返し回数、バイト数、フォーマットを含んでいる。
  45  .PP
  46 +.IP "[\fB訳注\fP]"
  47 +各フォーマット文字列は 1 行からなる。フォーマット文字列を複数個指定すると、
  48 +その各々が、同じ 1 つの処理単位
  49 +(後述の\fIブロック\fRである。「\fB処理されるバイト数\fR」セクションを参照)
  50 +に対して、重ねて適用されることになる
  51 +(すなわち、どのフォーマット文字列もブロックの先頭から適用される)。
  52 +複数のフォーマット文字列を指定するには、\fB\-e\fR
  53 +オプションでは、\fB\-e\fR を複数回使えばよい。\fB\-f\fR
  54 +オプションでは、改行で区切って複数行にする。
  55 +.sp
  56 +フォーマット単位は、「繰り返し回数 / バイト数 "フォーマット"」という書式になる。"フォーマット"
  57 +以外は省略できる。
  58 +.PP
  59  繰り返し回数は、指定が任意の (訳注: すなわち、省略可能な)
  60  正の整数であり、デフォルトは 1 である。各フォーマットは繰り返し回数だけ適用される。
  61  .PP
  62 @@ -234,18 +274,28 @@
  63  (訳注: カラー指定の実例については、「\fB用例\fP」セクションの
  64  3 番目の例をご覧になっていただきたい)。
  65  .PP
  66 -\fB\&_L[color_unit_1,\:color_unit_2,\:...,\:color_unit_n]\fP
  67 +.nf
  68 +\fB\&_L[color_unit_1,color_unit_2,...,color_unit_n]\fP
  69 +.fi
  70  .PP
  71  カラー指定単位 (color unit) の完全な書式は以下のとおりである:
  72  .PP
  73 -\fB[!]COLOR\:[:VALUE]\:[@OFFSET_START[\-END]]\fP
  74 +.nf
  75 +\fB[!]COLOR[:VALUE][@OFFSET_START[\-END]]\fP
  76 +.fi
  77  .TP
  78  \fB!\fP
  79  条件を否定する。
  80  注意していただきたいが、あるカラー指定単位について否定することに意味があるのは、
  81 -値/\:文字列と、オフセットの両方を指定したときだけである。
  82 -その場合は、値/\:文字列がそのオフセットにあるものとマッチしなかったときにのみ、
  83 +値/文字列と、オフセットの両方を指定したときだけである。
  84 +その場合は、値/文字列がそのオフセットにあるものとマッチしなかったときにのみ、
  85  対応する出力文字列がハイライトされることになる。
  86 +.RS
  87 +.IP "[\fB訳注\fP]"
  88 +上で言っているのは、否定は、あるオフセット、または比較的狭いオフセットの範囲に、
  89 +ある値が存在しないことを調べるためのものだということだろう。
  90 +広範囲についてそれをやるのは、色彩を反転させるだけで、否定しないときと事実上同じことになる。
  91 +.RE
  92  .TP
  93  \fBCOLOR\fP
  94  シェルで使われる 8 種の基本色の 1 つ。
  95 @@ -354,3 +404,69 @@
  96  Linux Kernel Archive
  97  .UE
  98  から入手できる。
  99 +.SH 翻訳者謝辞
 100 +この man ページの翻訳の最初のバージョンは、NetBSD jman proj
 101 +から寄贈していただいたものだった。また、翻訳にあたっては、FreeBSD
 102 +jpman project <http://www.jp.freebsd.org/man-jp/>
 103 +による翻訳を参考にさせていただいた。両プロジェクトの翻訳者の方々にお礼を申し上げる。
 104 +.SH "おまけ"
 105 +説明がわかりにくかったと思うので、翻訳者の判断で、用例をもう一つ追加して、説明を補足してみる。
 106 +却って混乱が増すようなら、読み飛ばしていただきたい。\fBhexdump -C\fP
 107 +のエミュレーションをしてみよう。次のような内容のファイルを
 108 +hexchar.fmt という名前で作成する。
 109 +.PP
 110 +.nf
 111 +   "%08.8_Ax\en"
 112 +   "%08.8_ax  " 8/1 "%02x " "  " 8/1 "%02x "
 113 +   "  |" "%_p"
 114 +   "|\en"
 115 +.fi
 116 +.PP
 117 +各行がフォーマット文字列であり、「"%08.8_ax\ \ "」 「8/1\ "%02x\ "」
 118 +「"\ \ "」 「"\ \ |"」 「"%_p"」 といった部分がフォーマット単位、
 119 +ダブルクォート (" ") で囲まれた部分がフォーマットである。
 120 +フォーマット単位には、繰り返し回数やバイト数の指定がなく、
 121 +フォーマットしか含まれていないこともある。
 122 +.sp
 123 +入力データは、一定の量ごとに分割されて処理される。その一定の量がブロックだが、
 124 +ブロックの大きさは、フォーマット文字列の中で最大のデータを要求しているものによって決まる。
 125 +上の場合なら、最大のデータを要求しているのは、2 行目であり
 126 +(ほかの行はデータの量を指定していない)、1 バイトが 8 回、さらに 1 バイトが
 127 +8 回繰り返し処理されるわけだから、合計で 16 バイトが要求されていることになる。
 128 +従って、ブロックの大きさは 16 バイトである。言い換えれば、この例では、入力データは
 129 +16 バイトずつ処理されるということだ。
 130 +.sp
 131 +.sp
 132 +各フォーマット文字列は、同一のブロックに対して順番に適用される。
 133 +しかも、それぞれが、そのブロックの先頭に戻って、適用されていく。
 134 +.sp
 135 +1 行目は、「すべての入力データの処理が終わったときに、最後から
 136 +1 つ先のオフセットを表示せよ」ということだから、ブロックのデータの処理とは関係がない。
 137 +.sp
 138 +2 行目の「"%08.8_ax\ \ " 8/1 "%02x\ " "\ \ " 8/1 "%02x\ "」の意味はこうである。
 139 +「まず、次に表示するバイトのオフセットを 8 桁の
 140 +16 進数で、先頭を 0 で埋めて表示し、空白を 2 個続ける。それから、1 バイトずつ
 141 +8 個 のデータを、2 桁の 16 進数で後ろに空白を付けて
 142 +(つまり、空白で区切って) 表示し、空白を 2 個置いて、さらに 1 バイトずつ
 143 +8 個のデータを、2 桁の 16 進数で空白で区切って表示せよ」。
 144 +.sp
 145 +3 行目の「"\ \ |" "%_p"」が指示しているのは、「2
 146 +行目による出力にすぐ続けて、同じ出力行にまず '\ \ |'
 147 +という文字列を表示し、それから、2 行目が処理したのと同じブロックに対して
 148 +1 バイトずつ '_p' 変換をして (つまり、ASCII 文字で) 出力せよ」ということだ。
 149 +3 行目は、「最後のフォーマット単位が、何バイトかを解釈・変換するものであり、
 150 +しかも繰り返し回数が指定されていない」ので、ブロック全体の処理が済むまで、
 151 +最後のフォーマット単位 "%_p" による処理が繰り返されることになる。
 152 +.sp
 153 +仮に、3 行目と 4 行目を 1 つにし、3 行目を「"\ \ |" "%_p" "|\en"」という形にすると、
 154 +フォーマット文字列の「最後のフォーマット単位が、
 155 +何バイトかを解釈・変換するもの」ではなくなるので、
 156 +自動的な繰り返しの増加が行われないことになる。それ故、両者は別の行になっている。
 157 +.sp
 158 +4 行目は、データに対する処理は何も指定せず、「3 行目による出力のすぐ後ろに '|'
 159 +という文字を書き出してから改行せよ」とだけ指示している。
 160 +.sp
 161 +このすべてが終わると、次のブロックに移って、同じ処理を繰り返していく。
 162 +.sp
 163 +結果として、\fBhexdump -f hexchar.fmt sample.txt\fP を実行すれば、
 164 +\fBhexdump -C sample.txt\fP と同じ結果が得られるはずである。