perlutil > 5.36.0 との差分

perlutil 5.36.0 と 5.26.1 の差分

11
2=encoding utf8
2=encoding euc-jp
33
44=head1 NAME
55
66=begin original
77
88perlutil - utilities packaged with the Perl distribution
99
1010=end original
1111
1212perlutil - Perl 配布と共にパッケージされているユーティリティ
1313
1414=head1 DESCRIPTION
1515
1616=begin original
1717
1818Along with the Perl interpreter itself, the Perl distribution installs a
1919range of utilities on your system. There are also several utilities
2020which are used by the Perl distribution itself as part of the install
2121process. This document exists to list all of these utilities, explain
2222what they are for and provide pointers to each module's documentation,
2323if appropriate.
2424
2525=end original
2626
2727Perl 配布は、Perl インタプリタ自身と共に、様々なユーティリティをシステムに
2828インストールします。
2929また、Perl 配布自身がインストール処理の一部として使うユーティリティも
3030あります。
3131この文書はこれらのユーティリティの一覧を示し、何をするものかを説明し、
3232もしあれば各モジュールの文書へのポインタを提供するために存在しています。
3333
3434=head1 LIST OF UTILITIES
3535
3636(ユーティリティの一覧)
3737
3838=head2 Documentation
3939
4040(文書)
4141
4242=over 3
4343
44=item L<perldoc>
44=item L<perldoc|perldoc>
4545
4646=begin original
4747
48The main interface to Perl's documentation is F<perldoc>, although
48The main interface to Perl's documentation is C<perldoc>, although
4949if you're reading this, it's more than likely that you've already found
5050it. F<perldoc> will extract and format the documentation from any file
5151in the current directory, any Perl module installed on the system, or
5252any of the standard documentation pages, such as this one. Use
5353C<perldoc E<lt>nameE<gt>> to get information on any of the utilities
5454described in this document.
5555
5656=end original
5757
58Perl 文書のメインのインターフェースは F<perldoc> ですが、これを読めていると
58Perl 文書のメインのインターフェースは C<perldoc> ですが、これを読めていると
5959いうことは、おそらくこれをすでに発見していることでしょう。
6060F<perldoc> は、現在のディレクトリにあるファイル、システムに
6161インストールされた Perl モジュール、(この文書のような) 標準文書ページを
6262抽出およびフォーマットします。
6363この文書に記述されているユーティリティに関する情報を得るには、
6464C<perldoc E<lt>nameE<gt>> を使ってください。
6565
66=item L<pod2man>
66=item L<pod2man|pod2man> and L<pod2text|pod2text>
6767
68=item L<pod2text>
68(L<pod2man|pod2man> と L<pod2text|pod2text>)
6969
7070=begin original
7171
7272If it's run from a terminal, F<perldoc> will usually call F<pod2man> to
7373translate POD (Plain Old Documentation - see L<perlpod> for an
7474explanation) into a manpage, and then run F<man> to display it; if
7575F<man> isn't available, F<pod2text> will be used instead and the output
7676piped through your favourite pager.
7777
7878=end original
7979
8080端末から実行すると、F<perldoc> は普通は POD (Plain Old Documentation -
8181説明については L<perlpod> を参照) を man ページに変換するのに
8282F<pod2man> を使い、それからこれを表示するために F<man> を使います;
8383もし F<man> が利用できない場合は、代わりに F<pod2text> が使われて出力は
8484好みのページャにパイプされます。
8585
86=item L<pod2html>
86=item L<pod2html|pod2html>
8787
8888=begin original
8989
9090As well as these two, there is another converter: F<pod2html> will
9191produce HTML pages from POD.
9292
9393=end original
9494
9595上述の二つと共に、もう一つのコンバータがあります: F<pod2html> は
9696POD から HTML ページを生成します。
9797
98=item L<pod2usage>
98=item L<pod2usage|pod2usage>
9999
100100=begin original
101101
102102If you just want to know how to use the utilities described here,
103103F<pod2usage> will just extract the "USAGE" section; some of
104104the utilities will automatically call F<pod2usage> on themselves when
105105you call them with C<-help>.
106106
107107=end original
108108
109109単にここに記述されているユーティリティの使い方が知りたいだけなら、
110110F<pod2usage> は "USAGE" の節のみを抽出します; 一部のユーティリティは
111111C<-help> 付きで呼び出されたときに自動的に自分自身に対して F<pod2usage> を
112112呼び出します。
113113
114=item L<podchecker>
114=item L<podselect|podselect>
115115
116116=begin original
117117
118F<pod2usage> is a special case of F<podselect>, a utility to extract
119named sections from documents written in POD. For instance, while
120utilities have "USAGE" sections, Perl modules usually have "SYNOPSIS"
121sections: C<podselect -s "SYNOPSIS" ...> will extract this section for
122a given file.
123
124=end original
125
126F<pod2usage> は F<podselect> の特殊ケースで、POD で書かれている文書から
127特定の名前の節を抽出するためのユーティリティです。
128例えば、ユーティリティには "USAGE" 節がありますが、Perl モジュールには
129普通 "SYNOPSIS" 節があります: C<podselect -s "SYNOPSIS" ...> は指定された
130ファイルからこの節を抽出します。
131
132=item L<podchecker|podchecker>
133
134=begin original
135
118136If you're writing your own documentation in POD, the F<podchecker>
119137utility will look for errors in your markup.
120138
121139=end original
122140
123141自身の文書を POD で書いたなら、F<podchecker> ユーティリティは
124142マークアップのエラーを探します。
125143
126=item L<splain>
144=item L<splain|splain>
127145
128146=begin original
129147
130148F<splain> is an interface to L<perldiag> - paste in your error message
131149to it, and it'll explain it for you.
132150
133151=end original
134152
135153F<splain> は L<perldiag> へのインターフェースです - エラーメッセージを
136154ペースとして、あなたのために説明します。
137155
138=item F<roffitall>
156=item C<roffitall>
139157
140158=begin original
141159
142The F<roffitall> utility is not installed on your system but lives in
160The C<roffitall> utility is not installed on your system but lives in
143161the F<pod/> directory of your Perl source kit; it converts all the
144162documentation from the distribution to F<*roff> format, and produces a
145163typeset PostScript or text file of the whole lot.
146164
147165=end original
148166
149F<roffitall> ユーティリティはシステムにはインストールされませんが、
167C<roffitall> ユーティリティはシステムにはインストールされませんが、
150168Perl そースキットの F<pod/> ディレクトリにいます; これは
151169配布の全ての文書を F<*roff> 形式に変換して、
152170全体のタイプセット PostScript かテキストファイルを生成します。
153171
154172=back
155173
156174=head2 Converters
157175
158176(コンバータ)
159177
160=over 3
161
162=item L<pl2pm>
163
164178=begin original
165179
166180To help you convert legacy programs to more modern Perl, the
167F<pl2pm> utility will help you convert old-style Perl 4 libraries
181L<pl2pm|pl2pm> utility will help you convert old-style Perl 4 libraries
168182to new-style Perl5 modules.
169183
170184=end original
171185
172186レガシープログラムをよりモダンな Perl に変換するのを助けるために、
173F<pl2pm> ユーティリティは古いスタイルの Perl 4 ライブラリを新しい
187L<pl2pm|pl2pm> ユーティリティは古いスタイルの Perl 4 ライブラリを新しい
174188スタイルの Perl5 モジュールに変換するのを助けます。
175189
176=back
177
178190=head2 Administration
179191
180192(管理)
181193
182194=over 3
183195
184=item L<libnetcfg>
196=item L<libnetcfg|libnetcfg>
185197
186198=begin original
187199
188200To display and change the libnet configuration run the libnetcfg command.
189201
190202=end original
191203
192204libnet 設定の表示と変更をするには libnetcfg コマンドを実行します。
193205
194206=item L<perlivp>
195207
196208=begin original
197209
198210The F<perlivp> program is set up at Perl source code build time to test
199211the Perl version it was built under. It can be used after running C<make
200212install> (or your platform's equivalent procedure) to verify that perl
201213and its libraries have been installed correctly.
202214
203215=end original
204216
205217F<perlivp> プログラムはビルドされた Perl バージョンをテストするために
206218Perl ソースコードをビルド時に設定します。
207219これは、perl やライブラリが正しくインストールされているかを検証するために、
208220C<make install> (あるいはプラットフォームによる等価な手続き) の
209221後に実行されます。
210222
211223=back
212224
213225=head2 Development
214226
215227(開発)
216228
217229=begin original
218230
219231There are a set of utilities which help you in developing Perl programs,
220232and in particular, extending Perl with C.
221233
222234=end original
223235
224236Perl プログラムの開発、特に Perl を C で拡張するのを助ける一群の
225237ユーティリティがあります。
226238
227239=over 3
228240
229=item L<perlbug>
241=item L<perlbug|perlbug>
230242
231243=begin original
232244
233F<perlbug> used to be the recommended way to report bugs in the perl
245F<perlbug> is the recommended way to report bugs in the perl interpreter
234interpreter itself or any of the standard library modules back to the
246itself or any of the standard library modules back to the developers;
235developers; bug reports and patches should now be submitted to
247please read through the documentation for F<perlbug> thoroughly before
236L<https://github.com/Perl/perl5/issues>.
248using it to submit a bug report.
237249
238250=end original
239251
240252F<perlbug> は、perl インタプリタ自身や標準ライブラリモジュールのバグを
241開発者に報告するための推奨の方法でした;
253開発者に報告するための推奨の方法です;
242現在はバグ報告やパッチは L<https://github.com/Perl/perl5/issues> に
254バグ報告を投稿するために使う前に、F<perlbug> の文書全体をよく
243登録するべきです。
255読んでください。
244256
245257=item L<perlthanks|perlbug>
246258
247259=begin original
248260
249261This program provides an easy way to send a thank-you message back to the
250262authors and maintainers of perl. It's just F<perlbug> installed under
251263another name.
252264
253265=end original
254266
255267このプログラムは perl の作者とメンテナに感謝のメッセージを送るための
256268簡単な方法です。
257269単に F<perlbug> を別の名前でインストールしたものです。
258270
259=item L<h2ph>
271=item L<h2ph|h2ph>
260272
261273=begin original
262274
263275Back before Perl had the XS system for connecting with C libraries,
264276programmers used to get library constants by reading through the C
265277header files. You may still see C<require 'syscall.ph'> or similar
266278around - the F<.ph> file should be created by running F<h2ph> on the
267279corresponding F<.h> file. See the F<h2ph> documentation for more on how
268280to convert a whole bunch of header files at once.
269281
270282=end original
271283
272284Perl に C ライブラリと接続するための XS システムができる前、
273285プログラマは C ヘッダファイルを読み込むことでライブラリの定数を
274286読み込んでいました。
275287今でも C<require 'syscall.ph'> のようなこともできます - F<.ph> ファイルは
276288対応する F<.h> ファイルに対して F<h2ph> を実行して作成されるべきです。
277289ヘッダ全体を一度に変換する方法については F<h2ph> の文書を
278290参照してください。
279291
280=item L<h2xs>
292=item L<h2xs|h2xs>
281293
282294=begin original
283295
284296F<h2xs> converts C header files into XS modules, and will try and write
285297as much glue between C libraries and Perl modules as it can. It's also
286298very useful for creating skeletons of pure Perl modules.
287299
288300=end original
289301
290302F<h2xs> は C ヘッダファイルを XS モジュールに変換し、C と Perl モジュールとの
291303間をくっつけるコードを出来るだけ作成しようとします。
292304これはまた、ピュア Perl モジュールのスケルトンを作成するのにも
293305便利です。
294306
295307=item L<enc2xs>
296308
297309=begin original
298310
299311F<enc2xs> builds a Perl extension for use by Encode from either
300312Unicode Character Mapping files (.ucm) or Tcl Encoding Files (.enc).
301313Besides being used internally during the build process of the Encode
302314module, you can use F<enc2xs> to add your own encoding to perl.
303315No knowledge of XS is necessary.
304316
305317=end original
306318
307319F<enc2xs> は Unicode Character Mapping ファイル (.ucm) か
308320Tcl Encoding Files (.enc) のどちらかから Encode で使うための
309321Perl エクステンションを構築します。
310322F<enc2xs> は、Encode モジュールのビルドプロセス中での内部での使用の他に
311323独自のエンコーディングを perl に追加するのにも使えます。
312324XS の知識は不要です。
313325
314326=item L<xsubpp>
315327
316328=begin original
317329
318330F<xsubpp> is a compiler to convert Perl XS code into C code.
319331It is typically run by the makefiles created by L<ExtUtils::MakeMaker>.
320332
321333=end original
322334
323335F<xsubpp> は Perl XS コードを C コードに変換するコンパイラです。
324336これは典型的には L<ExtUtils::MakeMaker> によって作成された makefile によって
325337実行されます。
326338
327339=begin original
328340
329341F<xsubpp> will compile XS code into C code by embedding the constructs
330342necessary to let C functions manipulate Perl values and creates the glue
331343necessary to let Perl access those functions.
332344
333345=end original
334346
335347F<xsubpp> は、C の関数が Perl の値を操作するために必要な構造を
336348組み込むことで XS コードを C コードにコンパイルし、Perl がそれらの
337349関数にアクセスするために必要な糊コードを作成します。
338350
339351=item L<prove>
340352
341353=begin original
342354
343355F<prove> is a command-line interface to the test-running functionality
344of L<Test::Harness>. It's an alternative to C<make test>.
356of F<Test::Harness>. It's an alternative to C<make test>.
345357
346358=end original
347359
348F<prove> は L<Test::Harness> のテスト実行機能へのコマンドライン
360F<prove> は F<Test::Harness> のテスト実行機能へのコマンドライン
349361インターフェースです。
350362これは C<make test> の代替です。
351363
352364=item L<corelist>
353365
354366=begin original
355367
356A command-line front-end to L<Module::CoreList>, to query what modules
368A command-line front-end to C<Module::CoreList>, to query what modules
357369were shipped with given versions of perl.
358370
359371=end original
360372
361L<Module::CoreList> へのコマンドラインインターフェースで、あるバージョンの
373C<Module::CoreList> へのコマンドラインインターフェースで、あるバージョンの
362374perl にどのモジュールが出荷されたかを問い合わせます。
363375
364376=back
365377
366378=head2 General tools
367379
368380(一般的なツール)
369381
370382=begin original
371383
372384A few general-purpose tools are shipped with perl, mostly because they
373385came along modules included in the perl distribution.
374386
375387=end original
376388
377389いくつかの一般的な用途のツールが perl と共に出荷されています; ほとんどの
378390場合は perl 配布に含まれているモジュールに付いているものです。
379391
380392=over 3
381393
382=item L<encguess>
383
384=begin original
385
386F<encguess> will attempt to guess the character encoding of files.
387
388=end original
389
390F<encguess> はファイルの文字エンコーディングを推測しようとします。
391
392=item L<json_pp>
393
394=begin original
395
396F<json_pp> is a pure Perl JSON converter and formatter.
397
398=end original
399
400F<json_pp> はピュア Perl の JSON コンバータとフォーマッタです。
401
402394=item L<piconv>
403395
404396=begin original
405397
406F<piconv> is a Perl version of L<iconv(1)>, a character encoding converter
398B<piconv> is a Perl version of B<iconv>, a character encoding converter
407399widely available for various Unixen today. This script was primarily a
408400technology demonstrator for Perl v5.8.0, but you can use piconv in the
409401place of iconv for virtually any case.
410402
411403=end original
412404
413F<piconv> は Perl 版の L<iconv(1)> で、最近の様々な Unix 系で幅広く
405B<piconv> は Perl 版の B<iconv> で、最近の様々な Unix 系で幅広く
414406利用可能な文字エンコーディングコンバータです。
415407このスクリプトは元々は Perl v5.8.0 の機能デモでしたが、ほぼどのような
416408場合でも iconv を使う場面で piconv を使えます。
417409
418410=item L<ptar>
419411
420412=begin original
421413
422414F<ptar> is a tar-like program, written in pure Perl.
423415
424416=end original
425417
426418F<ptar> は tar 風のプログラムで、ピュア Perl で書かれています。
427419
428420=item L<ptardiff>
429421
430422=begin original
431423
432424F<ptardiff> is a small utility that produces a diff between an extracted
433425archive and an unextracted one. (Note that this utility requires the
434L<Text::Diff> module to function properly; this module isn't distributed
426C<Text::Diff> module to function properly; this module isn't distributed
435427with perl, but is available from the CPAN.)
436428
437429=end original
438430
439431F<ptardiff> は、展開されたアーカイブと展開されていないアーカイブの
440432差分を生成する小さいユーティリティです。
441(このユーティリティは L<Text::Diff> モジュールが正しく動作することが
433(このユーティリティは C<Text::Diff> モジュールが正しく動作することが
442434必要であることに注意してください; このモジュールは perl と共に配布は
443435されていませんが、CPAN から利用可能です。)
444436
445437=item L<ptargrep>
446438
447439=begin original
448440
449441F<ptargrep> is a utility to apply pattern matching to the contents of files
450442in a tar archive.
451443
452444=end original
453445
454446F<ptargrep> は、tar アーカイブ内のファイルの内容にパターンマッチングを
455447適用するユーティリティです。
456448
457449=item L<shasum>
458450
459451=begin original
460452
461This utility, that comes with the L<Digest::SHA> module, is used to print
453This utility, that comes with the C<Digest::SHA> module, is used to print
462454or verify SHA checksums.
463455
464456=end original
465457
466L<Digest::SHA> モジュールと共に配布されているこのユーティリティは、
458C<Digest::SHA> モジュールと共に配布されているこのユーティリティは、
467459SHA チェックサムを表示または検証するために使われます。
468460
469=item L<streamzip>
470
471=begin original
472
473F<streamzip> compresses data streamed to STDIN into a streamed zip container.
474
475=end original
476
477F<streamzip> は STDIN のデータを、ストリーム zip コンテナに圧縮します。
478
479461=item L<zipdetails>
480462
481463=begin original
482464
483F<zipdetails> displays information about the internal record structure of the zip file.
465L<zipdetails> displays information about the internal record structure of the zip file.
484466It is not concerned with displaying any details of the compressed data stored in the zip file.
485467
486468=end original
487469
488F<zipdetails> は zip ファイルの内部記録構造に関する情報を表示します。
470L<zipdetails> は zip ファイルの内部記録構造に関する情報を表示します。
489471これは zip ファイルに保管されている圧縮データの詳細について表示することは
490472考慮されていません。
491473
492474=back
493475
494476=head2 Installation
495477
496478(インストール)
497479
498480=begin original
499481
500482These utilities help manage extra Perl modules that don't come with the perl
501483distribution.
502484
503485=end original
504486
505487これらのユーティリティは perl 配布に含まれていない追加の Perl モジュールの
506488管理を助けます。
507489
508490=over 3
509491
510492=item L<cpan>
511493
512494=begin original
513495
514496F<cpan> is a command-line interface to CPAN.pm. It allows you to install
515497modules or distributions from CPAN, or just get information about them, and
516498a lot more. It is similar to the command line mode of the L<CPAN> module,
517499
518500=end original
519501
520502F<cpan> は CPAN.pm へのコマンドラインインターフェースです。
521503CPAN からモジュールやディストリビューションをインストールしたり、
522504単にこれらの情報を入手したり、その他にも多くの機能があります。
523505これは L<CPAN> モジュールのコマンドラインモードと似ています。
524506
525507 perl -MCPAN -e shell
526508
527509=item L<instmodsh>
528510
529511=begin original
530512
531A little interface to L<ExtUtils::Installed> to examine installed modules,
513A little interface to ExtUtils::Installed to examine installed modules,
532514validate your packlists and even create a tarball from an installed module.
533515
534516=end original
535517
536518インストールしたモジュールの検査、packlists の検証、さらに
537519インストールしたモジュールから tarball の作成まで出来る、
538L<ExtUtils::Installed> への簡単なインターフェースです。
520ExtUtils::Installed への簡単なインターフェースです。
539521
540522=back
541523
542524=head1 SEE ALSO
543525
544L<perldoc>, L<pod2man>, L<pod2text>, L<pod2html>, L<pod2usage>,
526L<perldoc|perldoc>, L<pod2man|pod2man>, L<perlpod>,
545L<podchecker>, L<splain>, L<pl2pm>,
527L<pod2html|pod2html>, L<pod2usage|pod2usage>, L<podselect|podselect>,
546L<perlbug>, L<h2ph>, L<h2xs>, L<enc2xs>,
528L<podchecker|podchecker>, L<splain|splain>, L<perldiag>,
547L<xsubpp>, L<cpan>, L<encguess>, L<instmodsh>, L<json_pp>,
529C<roffitall|roffitall>, L<File::Find|File::Find>, L<pl2pm|pl2pm>,
548L<piconv>, L<prove>, L<corelist>, L<ptar>,
530L<perlbug|perlbug>, L<h2ph|h2ph>, L<h2xs|h2xs>, L<enc2xs>,
549L<ptardiff>, L<shasum>, L<streamzip>, L<zipdetails>
531L<xsubpp>, L<cpan>, L<instmodsh>, L<piconv>, L<prove>, L<corelist>, L<ptar>,
532L<ptardiff>, L<shasum>, L<zipdetails>
550533
551534=cut
552535
553536=begin meta
554537
555538Translate: SHIRAKATA Kentaro <argrath@ub32.org>
556539Status: completed
557540
558541=end meta
Powered by Amon2, 翻訳, サイト. Operated by Japan Perl Association