argra****@users*****
argra****@users*****
2010年 10月 19日 (火) 06:16:32 JST
Index: docs/modules/libwww-perl-5.813/LWP/Debug.pod
diff -u /dev/null docs/modules/libwww-perl-5.813/LWP/Debug.pod:1.1
--- /dev/null Tue Oct 19 06:16:32 2010
+++ docs/modules/libwww-perl-5.813/LWP/Debug.pod Tue Oct 19 06:16:32 2010
@@ -0,0 +1,139 @@
+
+=encoding euc-jp
+
+=head1 NAME
+
+=begin original
+
+LWP::Debug - debug routines for the libwww-perl library
+
+=end original
+
+LWP::Debug - libwww-perl ライブラリのためのデバッグルーチン
+
+=head1 SYNOPSIS
+
+ use LWP::Debug qw(+ -conns);
+
+ # Used internally in the library
+ LWP::Debug::trace('send()');
+ LWP::Debug::debug('url ok');
+ LWP::Debug::conns("read $n bytes: $data");
+
+=head1 DESCRIPTION
+
+=begin original
+
+LWP::Debug provides tracing facilities. The trace(), debug() and
+conns() function are called within the library and they log
+information at increasing levels of detail. Which level of detail is
+actually printed is controlled with the C<level()> function.
+
+=end original
+
+LWP::Debug はトレース機能を提供します。
+trace(), debug(), conns() 関数はライブラリの中で呼ばれ、そして、
+この順に増加する詳細レベルで情報をログに出力します。
+どの詳細レベルが実際に出力されるかは C<level()> 関数により制御されます。
+
+=begin original
+
+The following functions are available:
+
+=end original
+
+以下の関数を使うことができます:
+
+=over 4
+
+=item level(...)
+
+=begin original
+
+The C<level()> function controls the level of detail being
+logged. Passing '+' or '-' indicates full and no logging
+respectively. Individual levels can switched on and of by passing the
+name of the level with a '+' or '-' prepended. The levels are:
+
+=end original
+
+C<level()> 関数はログに出力される詳細レベルを制御します。
+'+' を渡すとすべてをログに出力、'-' を渡すとログ出力無しになります。
+個々のレベルは、レベルの名前に '+' または '-' をつけて
+切り替えることができます。
+そのレベルには以下のものがあります:
+
+ trace : trace function calls
+ debug : print debug messages
+ conns : show all data transfered over the connections
+
+=begin original
+
+The LWP::Debug module provide a special import() method that allows
+you to pass the level() arguments with initial use statement. If a
+use argument start with '+' or '-' then it is passed to the level
+function, else the name is exported as usual. The following two
+statements are thus equivalent (if you ignore that the second pollutes
+your namespace):
+
+=end original
+
+LWP::Debug モジュールは、初期の use ステートメントで level() 引数を
+渡すことを出来るようにする特別な import() メソッドを提供します。
+use引数が '+' や '-' で始まっていれば、level 関数に渡されます。
+そうでなければその名前は通常通りにエクスポートされます。
+このため以下の 2 つのステートメントは同じです
+(もし 2 番目が名前空間を汚すということを無視すればですが):
+
+ use LWP::Debug qw(+);
+ use LWP::Debug qw(level); level('+');
+
+=item trace($msg)
+
+=begin original
+
+The C<trace()> function is used for tracing function
+calls. The package and calling subroutine name is
+printed along with the passed argument. This should
+be called at the start of every major function.
+
+=end original
+
+C<trace()> 関数はトレースする関数を呼び出すために使われます。
+パッケージと呼び出しサブルーチン名が渡された引数とともに出力されます。
+これはすべての大きな関数が開始するたびに呼ばれるべきです。
+
+=item debug($msg)
+
+=begin original
+
+The C<debug()> function is used for high-granularity
+reporting of state in functions.
+
+=end original
+
+C<debug()> 関数は関数での状態の粒度の高い (high-granularity) 報告のために
+使われます。
+
+=item conns($msg)
+
+=begin original
+
+The C<conns()> function is used to show data being
+transferred over the connections. This may generate
+considerable output.
+
+=end original
+
+C<conns()> 関数は接続で転送されたデータを表示するために使われます。
+これはかなり大量の出力を生成するかもしれません。
+
+=back
+
+=begin meta
+
+Translated: Hippo2000 <GCD00****@nifty*****> (5.48)
+Updated: Kentaro SHIRAKATA <argra****@ub32*****> (5.813)
+
+=end meta
+
Index: docs/modules/libwww-perl-5.813/LWP/Simple.pod
diff -u /dev/null docs/modules/libwww-perl-5.813/LWP/Simple.pod:1.1
--- /dev/null Tue Oct 19 06:16:32 2010
+++ docs/modules/libwww-perl-5.813/LWP/Simple.pod Tue Oct 19 06:16:32 2010
@@ -0,0 +1,310 @@
+
+=encoding euc-jp
+
+=head1 NAME
+
+=begin original
+
+LWP::Simple - simple procedural interface to LWP
+
+=end original
+
+LWP::Simple - LWP への簡単な手続き的インターフェース
+
+=head1 SYNOPSIS
+
+ perl -MLWP::Simple -e 'getprint "http://www.sn.no"'
+
+ use LWP::Simple;
+ $content = get("http://www.sn.no/");
+ die "Couldn't get it!" unless defined $content;
+
+ if (mirror("http://www.sn.no/", "foo") == RC_NOT_MODIFIED) {
+ ...
+ }
+
+ if (is_success(getprint("http://www.sn.no/"))) {
+ ...
+ }
+
+=head1 DESCRIPTION
+
+=begin original
+
+This module is meant for people who want a simplified view of the
+libwww-perl library. It should also be suitable for one-liners. If
+you need more control or access to the header fields in the requests
+sent and responses received, then you should use the full object-oriented
+interface provided by the C<LWP::UserAgent> module.
+
+=end original
+
+このモジュールは、libwww-perl ライブラリの簡略化されたビューが欲しい人々に
+向いています。
+これはワンライナーにも適しています。
+もしより多くの制御や送信するリクエストや受信したレスポンスのヘッダに
+アクセスする必要があれば、C<LWP::UserAgent> モジュールによって提供される
+フルにオブジェクト指向なインターフェースを使わなければなりません。
+
+=begin original
+
+The following functions are provided (and exported) by this module:
+
+=end original
+
+このモジュールにより以下の関数が提供 (そしてエクスポート) されます:
+
+=over 3
+
+=item get($url)
+
+=begin original
+
+The get() function will fetch the document identified by the given URL
+and return it. It returns C<undef> if it fails. The $url argument can
+be either a simple string or a reference to a URI object.
+
+=end original
+
+get() 関数は与えられた URL により示されるドキュメントを取り出し、それを
+返します。
+失敗すれば C<undef> を返します。
+引数 $url は単純な文字列にも URI オブジェクトへのリファレンスにも
+することができます。
+
+=begin original
+
+You will not be able to examine the response code or response headers
+(like 'Content-Type') when you are accessing the web using this
+function. If you need that information you should use the full OO
+interface (see L<LWP::UserAgent>).
+
+=end original
+
+この関数を使って Web にアクセスすると、応答コードや ('Content-Type' のような)
+レスポンスヘッダを検査することは出来ません。
+もしその情報が必要であれば、フル OO インターフェースを使わなければなりません
+(LWP::UserAgentをご覧下さい)。
+
+=item head($url)
+
+=begin original
+
+Get document headers. Returns the following 5 values if successful:
+($content_type, $document_length, $modified_time, $expires, $server)
+
+=end original
+
+ドキュメントヘッダを取得します。
+正常ならば以下の 5 つの変数を返します:
+($content_type, $document_length, $modified_time, $expires, $server)
+
+=begin original
+
+Returns an empty list if it fails. In scalar context returns TRUE if
+successful.
+
+=end original
+
+失敗すると空リストを返します。
+スカラコンテキストでは成功すると真を返します。
+
+=item getprint($url)
+
+=begin original
+
+Get and print a document identified by a URL. The document is printed
+to the selected default filehandle for output (normally STDOUT) as
+data is received from the network. If the request fails, then the
+status code and message are printed on STDERR. The return value is
+the HTTP response code.
+
+=end original
+
+URL により識別されるドキュメントを取得し出力します。
+ネットワークからデータが受信されると、ドキュメントは選択されたデフォルトの
+出力ファイルハンドル(通常は STDOUT) に出力されます。
+もしリクエストが失敗すると、ステータス・コードとメッセージが STDERR に
+出力されます。
+戻り値は HTTP 応答コードです。
+
+=item getstore($url, $file)
+
+=begin original
+
+Gets a document identified by a URL and stores it in the file. The
+return value is the HTTP response code.
+
+=end original
+
+URL により識別されるドキュメントを取得し、ファイルに格納します。
+戻り値は HTTP 応答コードです。
+
+=item mirror($url, $file)
+
+=begin original
+
+Get and store a document identified by a URL, using
+I<If-modified-since>, and checking the I<Content-Length>. Returns
+the HTTP response code.
+
+=end original
+
+I<If-modified-since> を使い、I<Content-Length> を使いながら、URL により
+識別されるドキュメントを取得し、ファイルに格納します。
+戻り値は HTTP 応答コードです。
+
+=back
+
+=begin original
+
+This module also exports the HTTP::Status constants and procedures.
+You can use them when you check the response code from getprint(),
+getstore() or mirror(). The constants are:
+
+=end original
+
+このモジュールは HTTP::Status 定数とプロシージャもエクスポートします。
+getprint(), getstore(), mirror() からの応答コードをチェックするときに
+使うことが出来ます。
+定数には以下のものがあります:
+
+ RC_CONTINUE
+ RC_SWITCHING_PROTOCOLS
+ RC_OK
+ RC_CREATED
+ RC_ACCEPTED
+ RC_NON_AUTHORITATIVE_INFORMATION
+ RC_NO_CONTENT
+ RC_RESET_CONTENT
+ RC_PARTIAL_CONTENT
+ RC_MULTIPLE_CHOICES
+ RC_MOVED_PERMANENTLY
+ RC_MOVED_TEMPORARILY
+ RC_SEE_OTHER
+ RC_NOT_MODIFIED
+ RC_USE_PROXY
+ RC_BAD_REQUEST
+ RC_UNAUTHORIZED
+ RC_PAYMENT_REQUIRED
+ RC_FORBIDDEN
+ RC_NOT_FOUND
+ RC_METHOD_NOT_ALLOWED
+ RC_NOT_ACCEPTABLE
+ RC_PROXY_AUTHENTICATION_REQUIRED
+ RC_REQUEST_TIMEOUT
+ RC_CONFLICT
+ RC_GONE
+ RC_LENGTH_REQUIRED
+ RC_PRECONDITION_FAILED
+ RC_REQUEST_ENTITY_TOO_LARGE
+ RC_REQUEST_URI_TOO_LARGE
+ RC_UNSUPPORTED_MEDIA_TYPE
+ RC_INTERNAL_SERVER_ERROR
+ RC_NOT_IMPLEMENTED
+ RC_BAD_GATEWAY
+ RC_SERVICE_UNAVAILABLE
+ RC_GATEWAY_TIMEOUT
+ RC_HTTP_VERSION_NOT_SUPPORTED
+
+=begin original
+
+The HTTP::Status classification functions are:
+
+=end original
+
+HTTP::Status 分類関数には以下のものがあります:
+
+=over 3
+
+=item is_success($rc)
+
+=begin original
+
+True if response code indicated a successful request.
+
+=end original
+
+応答コードが成功であることを示せばであれば真。
+
+=item is_error($rc)
+
+=begin original
+
+True if response code indicated that an error occurred.
+
+=end original
+
+応答コードがエラーが発生したことを示せば真。
+
+=back
+
+=begin original
+
+The module will also export the LWP::UserAgent object as C<$ua> if you
+ask for it explicitly.
+
+=end original
+
+明示的に指定すれば、このモジュールは LWP::UserAgent オブジェクトも
+C<$ua> としてエクスポートします。
+
+=begin original
+
+The user agent created by this module will identify itself as
+"LWP::Simple/#.##" (where "#.##" is the libwww-perl version number)
+and will initialize its proxy defaults from the environment (by
+calling $ua->env_proxy).
+
+=end original
+
+このモジュールによって作成されるユーザ・エージェントは、
+"LWP::Simple/#.##" ("#.##" は libwww-perl のバージョン番号) で識別され、
+($ua->env_proxy を呼ぶことにより) 環境変数によってプロキシーが
+初期化されます。
+
+=head1 CAVEAT
+
+=begin original
+
+Note that if you are using both LWP::Simple and the very popular CGI.pm
+module, you may be importing a C<head> function from each module,
+producing a warning like "Prototype mismatch: sub main::head ($) vs
+none". Get around this problem by just not importing LWP::Simple's
+C<head> function, like so:
+
+=end original
+
+Note that if you are using both LWP::Simple and the very popular CGI.pm
+module, you may be importing a C<head> function from each module,
+producing a warning like "Prototype mismatch: sub main::head ($) vs
+none". Get around this problem by just not importing LWP::Simple's
+C<head> function, like so:
+(TBT)
+
+ use LWP::Simple qw(!head);
+ use CGI qw(:standard); # then only CGI.pm defines a head()
+
+=begin original
+
+Then if you do need LWP::Simple's C<head> function, you can just call
+it as C<LWP::Simple::head($url)>.
+
+=end original
+
+Then if you do need LWP::Simple's C<head> function, you can just call
+it as C<LWP::Simple::head($url)>.
+(TBT)
+
+=head1 SEE ALSO
+
+L<LWP>, L<lwpcook>, L<LWP::UserAgent>, L<HTTP::Status>, L<lwp-request>,
+L<lwp-mirror>
+
+=begin meta
+
+Translated: Hippo2000 <GCD00****@nifty*****> (5.48)
+Updated: Kentaro SHIRAKATA <argra****@ub32*****> (5.813)
+
+=end meta
+