=encoding utf8 =head1 NAME =begin original perlutil - utilities packaged with the Perl distribution =end original perlutil - Perl 配布と共にパッケージされているユーティリティ =head1 DESCRIPTION =begin original Along with the Perl interpreter itself, the Perl distribution installs a range of utilities on your system. There are also several utilities which are used by the Perl distribution itself as part of the install process. This document exists to list all of these utilities, explain what they are for and provide pointers to each module's documentation, if appropriate. =end original Perl 配布は、Perl インタプリタ自身と共に、様々なユーティリティをシステムに インストールします。 また、Perl 配布自身がインストール処理の一部として使うユーティリティも あります。 この文書はこれらのユーティリティの一覧を示し、何をするものかを説明し、 もしあれば各モジュールの文書へのポインタを提供するために存在しています。 =head1 LIST OF UTILITIES (ユーティリティの一覧) =head2 Documentation (文書) =over 3 =item L =begin original The main interface to Perl's documentation is F, although if you're reading this, it's more than likely that you've already found it. F will extract and format the documentation from any file in the current directory, any Perl module installed on the system, or any of the standard documentation pages, such as this one. Use CnameE> to get information on any of the utilities described in this document. =end original Perl 文書のメインのインターフェースは F ですが、これを読めていると いうことは、おそらくこれをすでに発見していることでしょう。 F は、現在のディレクトリにあるファイル、システムに インストールされた Perl モジュール、(この文書のような) 標準文書ページを 抽出およびフォーマットします。 この文書に記述されているユーティリティに関する情報を得るには、 CnameE> を使ってください。 =item L =item L =begin original If it's run from a terminal, F will usually call F to translate POD (Plain Old Documentation - see L for an explanation) into a manpage, and then run F to display it; if F isn't available, F will be used instead and the output piped through your favourite pager. =end original 端末から実行すると、F は普通は POD (Plain Old Documentation - 説明については L を参照) を man ページに変換するのに F を使い、それからこれを表示するために F を使います; もし F が利用できない場合は、代わりに F が使われて出力は 好みのページャにパイプされます。 =item L =begin original As well as these two, there is another converter: F will produce HTML pages from POD. =end original 上述の二つと共に、もう一つのコンバータがあります: F は POD から HTML ページを生成します。 =item L =begin original If you just want to know how to use the utilities described here, F will just extract the "USAGE" section; some of the utilities will automatically call F on themselves when you call them with C<-help>. =end original 単にここに記述されているユーティリティの使い方が知りたいだけなら、 F は "USAGE" の節のみを抽出します; 一部のユーティリティは C<-help> 付きで呼び出されたときに自動的に自分自身に対して F を 呼び出します。 =item L =begin original If you're writing your own documentation in POD, the F utility will look for errors in your markup. =end original 自身の文書を POD で書いたなら、F ユーティリティは マークアップのエラーを探します。 =item L =begin original F is an interface to L - paste in your error message to it, and it'll explain it for you. =end original F は L へのインターフェースです - エラーメッセージを ペースとして、あなたのために説明します。 =item F =begin original The F utility is not installed on your system but lives in the F directory of your Perl source kit; it converts all the documentation from the distribution to F<*roff> format, and produces a typeset PostScript or text file of the whole lot. =end original F ユーティリティはシステムにはインストールされませんが、 Perl そースキットの F ディレクトリにいます; これは 配布の全ての文書を F<*roff> 形式に変換して、 全体のタイプセット PostScript かテキストファイルを生成します。 =back =head2 Converters (コンバータ) =over 3 =item L =begin original To help you convert legacy programs to more modern Perl, the F utility will help you convert old-style Perl 4 libraries to new-style Perl5 modules. =end original レガシープログラムをよりモダンな Perl に変換するのを助けるために、 F ユーティリティは古いスタイルの Perl 4 ライブラリを新しい スタイルの Perl5 モジュールに変換するのを助けます。 =back =head2 Administration (管理) =over 3 =item L =begin original To display and change the libnet configuration run the libnetcfg command. =end original libnet 設定の表示と変更をするには libnetcfg コマンドを実行します。 =item L =begin original The F program is set up at Perl source code build time to test the Perl version it was built under. It can be used after running C (or your platform's equivalent procedure) to verify that perl and its libraries have been installed correctly. =end original F プログラムはビルドされた Perl バージョンをテストするために Perl ソースコードをビルド時に設定します。 これは、perl やライブラリが正しくインストールされているかを検証するために、 C (あるいはプラットフォームによる等価な手続き) の 後に実行されます。 =back =head2 Development (開発) =begin original There are a set of utilities which help you in developing Perl programs, and in particular, extending Perl with C. =end original Perl プログラムの開発、特に Perl を C で拡張するのを助ける一群の ユーティリティがあります。 =over 3 =item L =begin original F used to be the recommended way to report bugs in the perl interpreter itself or any of the standard library modules back to the developers; bug reports and patches should now be submitted to L. =end original F は、perl インタプリタ自身や標準ライブラリモジュールのバグを 開発者に報告するための推奨の方法でした; 現在はバグ報告やパッチは L に 登録するべきです。 =item L =begin original This program provides an easy way to send a thank-you message back to the authors and maintainers of perl. It's just F installed under another name. =end original このプログラムは perl の作者とメンテナに感謝のメッセージを送るための 簡単な方法です。 単に F を別の名前でインストールしたものです。 =item L =begin original Back before Perl had the XS system for connecting with C libraries, programmers used to get library constants by reading through the C header files. You may still see C or similar around - the F<.ph> file should be created by running F on the corresponding F<.h> file. See the F documentation for more on how to convert a whole bunch of header files at once. =end original Perl に C ライブラリと接続するための XS システムができる前、 プログラマは C ヘッダファイルを読み込むことでライブラリの定数を 読み込んでいました。 今でも C のようなこともできます - F<.ph> ファイルは 対応する F<.h> ファイルに対して F を実行して作成されるべきです。 ヘッダ全体を一度に変換する方法については F の文書を 参照してください。 =item L =begin original F converts C header files into XS modules, and will try and write as much glue between C libraries and Perl modules as it can. It's also very useful for creating skeletons of pure Perl modules. =end original F は C ヘッダファイルを XS モジュールに変換し、C と Perl モジュールとの 間をくっつけるコードを出来るだけ作成しようとします。 これはまた、ピュア Perl モジュールのスケルトンを作成するのにも 便利です。 =item L =begin original F builds a Perl extension for use by Encode from either Unicode Character Mapping files (.ucm) or Tcl Encoding Files (.enc). Besides being used internally during the build process of the Encode module, you can use F to add your own encoding to perl. No knowledge of XS is necessary. =end original F は Unicode Character Mapping ファイル (.ucm) か Tcl Encoding Files (.enc) のどちらかから Encode で使うための Perl エクステンションを構築します。 F は、Encode モジュールのビルドプロセス中での内部での使用の他に 独自のエンコーディングを perl に追加するのにも使えます。 XS の知識は不要です。 =item L =begin original F is a compiler to convert Perl XS code into C code. It is typically run by the makefiles created by L. =end original F は Perl XS コードを C コードに変換するコンパイラです。 これは典型的には L によって作成された makefile によって 実行されます。 =begin original F will compile XS code into C code by embedding the constructs necessary to let C functions manipulate Perl values and creates the glue necessary to let Perl access those functions. =end original F は、C の関数が Perl の値を操作するために必要な構造を 組み込むことで XS コードを C コードにコンパイルし、Perl がそれらの 関数にアクセスするために必要な糊コードを作成します。 =item L =begin original F is a command-line interface to the test-running functionality of L. It's an alternative to C. =end original F は L のテスト実行機能へのコマンドライン インターフェースです。 これは C の代替です。 =item L =begin original A command-line front-end to L, to query what modules were shipped with given versions of perl. =end original L へのコマンドラインインターフェースで、あるバージョンの perl にどのモジュールが出荷されたかを問い合わせます。 =back =head2 General tools (一般的なツール) =begin original A few general-purpose tools are shipped with perl, mostly because they came along modules included in the perl distribution. =end original いくつかの一般的な用途のツールが perl と共に出荷されています; ほとんどの 場合は perl 配布に含まれているモジュールに付いているものです。 =over 3 =item L =begin original F will attempt to guess the character encoding of files. =end original F はファイルの文字エンコーディングを推測しようとします。 =item L =begin original F is a pure Perl JSON converter and formatter. =end original F はピュア Perl の JSON コンバータとフォーマッタです。 =item L =begin original F is a Perl version of L, a character encoding converter widely available for various Unixen today. This script was primarily a technology demonstrator for Perl v5.8.0, but you can use piconv in the place of iconv for virtually any case. =end original F は Perl 版の L で、最近の様々な Unix 系で幅広く 利用可能な文字エンコーディングコンバータです。 このスクリプトは元々は Perl v5.8.0 の機能デモでしたが、ほぼどのような 場合でも iconv を使う場面で piconv を使えます。 =item L =begin original F is a tar-like program, written in pure Perl. =end original F は tar 風のプログラムで、ピュア Perl で書かれています。 =item L =begin original F is a small utility that produces a diff between an extracted archive and an unextracted one. (Note that this utility requires the L module to function properly; this module isn't distributed with perl, but is available from the CPAN.) =end original F は、展開されたアーカイブと展開されていないアーカイブの 差分を生成する小さいユーティリティです。 (このユーティリティは L モジュールが正しく動作することが 必要であることに注意してください; このモジュールは perl と共に配布は されていませんが、CPAN から利用可能です。) =item L =begin original F is a utility to apply pattern matching to the contents of files in a tar archive. =end original F は、tar アーカイブ内のファイルの内容にパターンマッチングを 適用するユーティリティです。 =item L =begin original This utility, that comes with the L module, is used to print or verify SHA checksums. =end original L モジュールと共に配布されているこのユーティリティは、 SHA チェックサムを表示または検証するために使われます。 =item L =begin original F compresses data streamed to STDIN into a streamed zip container. =end original F は STDIN のデータを、ストリーム zip コンテナに圧縮します。 =item L =begin original F displays information about the internal record structure of the zip file. It is not concerned with displaying any details of the compressed data stored in the zip file. =end original F は zip ファイルの内部記録構造に関する情報を表示します。 これは zip ファイルに保管されている圧縮データの詳細について表示することは 考慮されていません。 =back =head2 Installation (インストール) =begin original These utilities help manage extra Perl modules that don't come with the perl distribution. =end original これらのユーティリティは perl 配布に含まれていない追加の Perl モジュールの 管理を助けます。 =over 3 =item L =begin original F is a command-line interface to CPAN.pm. It allows you to install modules or distributions from CPAN, or just get information about them, and a lot more. It is similar to the command line mode of the L module, =end original F は CPAN.pm へのコマンドラインインターフェースです。 CPAN からモジュールやディストリビューションをインストールしたり、 単にこれらの情報を入手したり、その他にも多くの機能があります。 これは L モジュールのコマンドラインモードと似ています。 perl -MCPAN -e shell =item L =begin original A little interface to L to examine installed modules, validate your packlists and even create a tarball from an installed module. =end original インストールしたモジュールの検査、packlists の検証、さらに インストールしたモジュールから tarball の作成まで出来る、 L への簡単なインターフェースです。 =back =head1 SEE ALSO L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L, L =cut =begin meta Translate: SHIRAKATA Kentaro Status: completed =end meta