argra****@users*****
argra****@users*****
2012年 11月 29日 (木) 19:42:20 JST
Index: docs/modules/PerlIO-gzip-0.17/Gzip.pod
diff -u docs/modules/PerlIO-gzip-0.17/Gzip.pod:1.2 docs/modules/PerlIO-gzip-0.17/Gzip.pod:1.3
--- docs/modules/PerlIO-gzip-0.17/Gzip.pod:1.2 Thu Jan 27 22:15:00 2011
+++ docs/modules/PerlIO-gzip-0.17/Gzip.pod Thu Nov 29 19:42:20 2012
@@ -3,8 +3,12 @@
=head1 NAME
+=begin original
+
PerlIO::gzip - Perl extension to provide a PerlIO layer to gzip/gunzip
+=end original
+
PerlIO::gzip - PerlIOレイヤーをgzip/gunzipに提供するPerl拡張
=head1 SYNOPSIS
@@ -17,25 +21,37 @@
=head1 DESCRIPTION
+=begin original
+
PerlIO::gzip provides a PerlIO layer that manipulates files in the format used
by the C<gzip> program. Compression and Decompression are implemented, but
not together. If you attempt to open a file for reading and writing the open
will fail.
+=end original
+
PerlIO::gzipはC<gzip>プログラムで使用される形式でファイルを操作するPerlIOレイヤーを提供します.
圧縮と解凍が実装されますが一緒に実装されるというわけではありません.
=head1 EXPORT
+=begin original
+
PerlIO::gzip exports no subroutines or symbols, just a perl layer C<gzip>
+=end original
+
PerlIO::gzipはどんなサブルーチンもシンボルもこのperlレイヤーC<gzip>ですらexportしません
=head1 LAYER ARGUMENTS
+=begin original
+
The C<gzip> layer takes a comma separated list of arguments. 4 exclusive
options choose the header checking mode:
+=end original
+
C<gzip>レイヤーはカンマでくぎられたリストの引数を取得します.
４つの排他的なオプションはモードをチェックするヘッダーを選択します.
@@ -43,31 +59,45 @@
=item gzip
+=begin original
+
The default. Expects a standard gzip file header for reading, writes a
standard gzip file header.
+=end original
+
デフォルトです. 読み込む為の標準のgzipファイルヘッダーを予想し,標準gzipファイルヘッダに書き込みます.
=item none
+=begin original
+
Expects or writes no file header; assumes the file handle is immediately a
deflate stream (eg as would be found inside a C<zip> file)
+=end original
+
どのようなヘッダファイルでも予想または書き込みをしません;ファイルハンドルは即座に
圧縮されたストリームと仮定します(例えば zipファイルで見つけられるように)
=item auto
+=begin original
+
Potentially dangerous. If the first two bytes match the C<gzip> header
"\x1f\x8b" then a gzip header is assumed (and checked) else a deflate stream
is assumed. No different from gzip on writing.
+=end original
+
潜在的に危険を含んでいます.最初の２バイトがgzipヘッダ"\x1f\x8b"に一致するならば
gzipヘッダと想定され（チェックされ）その他に圧縮されたストリームが想定される.
gzipでの書き込みと異なりません.
=item autopop
+=begin original
+
Potentially dangerous. If the first two bytes match the C<gzip> header
"\x1f\x8b" then a gzip header is assumed (and checked) else the layer is
silently popped. This results in gzip files being transparently
@@ -75,36 +105,52 @@
effects such as File::Copy becoming gunzip, and File::Compare comparing
the uncompressed contents of files.
+=end original
+
潜在的に危険を含んでいます.最初の２バイトがgzipヘッダ"\x1f\x8b"に一致するならば
gzipヘッダと想定され（チェックされ）その他にレイヤーは黙って取り出されます.
他のファイルが通常扱われるように結果としてgzipファイルは透過的に圧縮される.
もちろん,これはgunzipにふさわしいFile::Copyのようにまた,
ファイルの解凍されたコンテンツを比較するFile::Compareでは副作用を起こします.
+=begin original
+
In autopop mode Opening a handle for writing (or reading and writing) will
cause the gzip layer to automatically be popped.
+=end original
+
autopopモードで書き込みハンドルをオープンする(または読込と書き込みで)のは
gzipレイヤーを自動的に取り出すでしょう.
=back
+=begin original
+
Optionally you can add this flag:
+=end original
+
任意でこのフラグを追加することができます:
=over 4
=item lazy
+=begin original
+
For reading, defer header checking until the first read. For writing, don't
write a header until the first buffer empty of compressed data to disk.
(and don't write anything at all if no data was written to the handle)
+=end original
+
読み込むには,始めの読込までヘッダをチェックするのを延期してください。
書き込むには,ディスクに圧縮されたデータを最初のバッファまで,ヘッダを書き込まないで下さい
(そしてデータが全くハンドルに書かれなかったなら何も書き込まないで下さい)
+=begin original
+
By default, gzip header checking is done before the C<open> (or C<binmode>)
returns, so if an error is detected in the gzip header the C<open> or
C<binmode> will fail. However, this will require reading some data, or writing
@@ -112,6 +158,8 @@
until the first read so the C<open> should always succeed, but any problems
with the header will cause an error on read.
+=end original
+
デフォルトで,gzipヘッダのチェックはC<open> (または C<binmode>)の前に実施され返される,
したがって誤りがgzipヘッダに検出されるとC<open>またはC<binmode>は失敗するでしょう.
しかしながら,これはいくらかのデータを読み込むまたは書き込むことを必要とするでしょう.
@@ -123,13 +171,21 @@
print;
} # ワオ.駄目ですね. あなたはエラーとEOFを見分けていません.
+=begin original
+
If you're not careful you won't spot the errors - like the example above
you'll think you got end of file.
+=end original
+
慎重で無いのならば上の例でファイルの終わりを見つけたと思ったようにあなたはエラーを見つけないでしょう
+=begin original
+
lazy is ignored if you are in autopop mode.
+=end original
+
autopopモードであれば怠惰は無視される.
=back