|
|
Win32 FAQ |
perlwin32faq3 - ドキュメントとサポート
Perl for Win32 ドキュメントとサポート
Perl for Win32のドキュメントは、perlディレクトリ内のHtml及びHtmlHelpディレクトリにHTML及びHTMLHelpフォーマットで格納されています。 標準のperlディストリビューションのドキュメントの他に、Win32特有のエクステンション用ドキュメントがあります。 Win32特有のエクステンション用ドキュメントの詳細については、 Perl for Win32ディストリビューションにはどのようなモジュールが付属していますか？ を参照してください。
標準のperlディストリビューションのドキュメント(perl*.htm) には、いくつかのUNIX特有の情報の他に、Perl for Win32では動かない機能や関数のリストが入っています。 perlwin32とperlportのページには、Win32プラットフォーム上でのポータビリティの問題が掲載されています。
また、perldocコマンドでもPerlドキュメントを読むことができます。 コマンドプロンプトから、次のようにperldocに続けて読みたいドキュメント名を入力します。：
perldoc perlwin32
perldoc perlfaq
ドキュメントはバイナリディストリビューションに含まれていて、インストール時に自動的に作成されます。ソースディストリビューションからでも、``make installhtml''とすれば作成することができます。
Perl for Win32には標準Perlのドキュメントの他にWin32特有のドキュメントが付属しています。 コアモジュールについても、それぞれドキュメントが揃っています。
O'Reilly社から出ているPerl Resource Kit for Win32には、また別のドキュメントが入っています。 これには、Perl及びモジュール、ユーティリティの全ドキュメントが（Netscapeや他のブラウザのユーザ向けに）HTMLと（MSIE4.0ユーザ向けに）マイクロソフト社の新しいヘルプフォーマットであるHMMLHelpの形で利用できるようになっています。 また、PerlのドキュメントフォーマットであるPOD(Plain Old Documentation)の形でも用意されています。
Perl Package Manager や Visual Package Manager でモジュールパッケージを追加する際には、そのモジュールのドキュメントも一緒にシステムにインストールされます。 このドキュメントは、HTMLHelp、HTML、PODフォーマット（ドキュメントがモジュールに埋め込まれている場合）で提供されます。
ActiveState社が主催するPerl関連のメーリングリストでメンバ間のサポートを受けることができます。 メーリングリストの詳細については、 http://www.ActiveState.com/support/ に掲示されています。
ミッションクリティカルなさぽーとについては、http://www.PerlClinic.comのPerl Clinicに相談してください。
Perl Clinicは、Perlに関するすべての悩み事に対して有料でサポートを行っています。
Perl for Win32に貢献しているWebページがいくつかあります。 以下は主要なもののリストです。：
http://www.ActiveState.com/ - Perl for Win32 のホームページ。
http://www.ActiveState.com/support - 入門的な情報、FAQ、メーリングリスト等。
http://www.divinf.it/dada/perl - Aldo Calpiniのページ。たくさんのリンク、Win32用モジュール等があります。
http://www.geocities.com/SiliconValley/Park/8312/ - Robin ChatterjeeのPerl for Win32のページ。FAQ、リンク、その他。
http://www.netaxs.com/~joc/perlwin32.html - JoeのPerl for Win32 のページ。一般的な情報、ポインタ、モジュール、その他があります。
ActiveState社が Perl for Win32 コミュニティ向けにさまざまなメーリングリストを解説しています。詳しい情報は、 http://www.activestate.com/support/mailing_lists.htm に掲示されています。
メーリングリストのアーカイブもActiveState社のWebサイトに掲示されています。
メーリングリストに質問を投稿する前に、まずFAQ（Perl for Win32用のFAQはありますか？参照）やアーカイブを確認するようにしましょう。 リストのメンバは、多くが残業続きのプログラマや管理者です。 ですから、最良の回答を得るには、礼儀正しく、明確に、そして、自分で問題を解決しようとしたことをきちんと示すことが求められます。
まだありません。全般的なPerlの質問に対しては、comp.lang.perl.misc（訳注：日本ではfj.comp.lang.perl）を利用するとよいでしょう。 しかし、UsenetのPerlニュースグループの大半のメンバはUNIXプラットフォームの話題に集中する傾向があり、多くの回答は望めないかもしれません。 Win32特有の情報については、 perl-win32-usersメーリングリスト(Perl for Win32 や PerlIS用のメーリングリストはありますか？参照)に参加するとよいでしょう。（訳注：日本語用はperl-win32-j）
Webサーバの設定やCGIプログラミングについては、次の３つのニュースグループが好適です。：
comp.infosystems.www.servers.ms-windows
comp.infosystems.www.authoring.cgi
comp.infosystems.www.authoring.misc
（訳注：日本では下記等があります。：）
fj.net.www.servers
fj.net.www.browsers
fj.net.www.authors
今読んでいるのもその１つです。 また、Perlではヘルプシステム内に主要なPerlFAQが組み込まれています。 このPerlFAQは100ページ以上もあるので、数部に分割されています。
Robin Chatterjeeの Perl for Win32 のページには、perl-win32-usersメーリングリストに寄せられるFAQとその回答が転載されています。：
http://www.geocities.com/SiliconValley/Park/8312/
ActiveState社のバグ報告システムが http://www.ActiveState.com/bugsにあります。
ここにバグを報告する前に、確認しておくべき項目がいくつかあります。：
プログラム中のロジックエラーではなく、本当のバグであることを確認します。
Perlの動作についての誤解ではなく、本当のバグであることを確認します。 そして、誰か他の人がその問題に遭遇していないか、メーリングリストのアーカイブやFAQを調べます。 たとえ本当のバグであると確信していも、常にこの手順を踏んでください。 ActiveState社に寄せられるバグ報告の大半はバグではなく、メーリングリストのアーカイブやFAQに目を通すことで解決できたはずのものなのです。
comp.lang.perl.miscを検索するには、www.dejanews.com を利用するとよいでしょう。 問題がニュースグループで議論されたものであれば、回答があるはずです。 以上の手を尽くしてもわからなかった場合は、メーリングリストに投稿して、誰か答えを知っている人がいないか確認するのもよいでしょう。 その場合は、質問しても構いませんか？ あるいは、どのように質問すればよいのでしょうか？を参照してください。
バグが既に報告されているか、対処されているかどうか、バグリストを調べます。
バグが再現するか確認します。１度しか発生しない場合、それはバグではありません。この点ははっきりとさせておく必要があります。繰り返して起こすことができない場合はバグではないのです。
バグのサンプルとして、短い、簡単なスクリプトを作成します。 元のソースコードをそのままサンプルとして送ってはなりません。 サンプルは可能な限り短くまとめます。 これは、バグを装ったエラーを洗い出すプロセスとして知られています。
ActiveState社のバグテスタがバグを再現する際に手のかからないようにしてください。 事前準備やサンプルデータファイルが必要な場合は、簡単な指示書を付けてください。
以上が完了したら、ActiveState社にバグ報告を送ってください。 報告には、バグの性質、再現方法、問題が生じているプラットフォーム、オペレーティングシステム、Perlのバージョンを明確に記述しておきます。 バグを再現するのに十分な情報をActiveState社に伝えることが主目的であることを忘れてはなりません。 再現できなければバグとはみなされないのです。
検証と対策のプロセスが終了すると、そのバグの状況についてEメールが送られます。
同じバグを何度も連絡してはなりません。
HtmlHelpはMicrosoft社の新しいヘルプフォーマットです。 .CHMファイルが古い.HLPファイルに取って替わりました。 変わったところは、HtmlHelpはより連携しやすくなっている点（RTFコンバータ等は不要）と、スクリプトやアプレット、スタイル、クールなHTMLを含め、シンプルなHTMLドキュメントが持っているものをすべて取り込むことができようになったことです。
ActiveState社は Perl for Win32 のオンラインドキュメントに HtmlHelp フォーマットを採用しました。 つまり、Win32用のPerlのドキュメントは丁年に達し、別物になったのです。 Perlのヘルプは、キーワード検索ができるようになりました。そして、それはPackage Manager ツールでパッケージを追加する度に簡単に拡張されるようになっています。
質問の際のエチケットは、メーリングリスト、ニュースグループ、チャット、IRCチャンネルを問わず同じです。 参考までに質問の助けとなるポイントを挙げておきます。
質問をする前に自分自身で調べましょう。 本（１冊と言わず複数冊。オライリー社はお買い得）を買ったり、オンラインヘルプに目を通したり、Webで検索したりすることです。 自力で答えを見つけようとする手間を惜しむ人に、時間を割いて答えてくれる人はいないでしょう。
まず、FAQをチェックします。 質問の答えが既にFAQに出ている場合、公的なフォーラムで尋ねても答えは得られないかもしれません。
「質問してもかまいませんか」などと尋ねてはなりません。 そんな質問をする人は初心者という看板を背負っているようなものです。 IRCやニュースグループの住人は、初心者にはうんざりしています。 初心者は、いつも質問ばかりして自分では決して調べようとしないと思われているのです。
質問する前に、しばらくはメーリングリストやニュースグループを読むだけにしておきます。 すぐに質問せざるをえない場合や、ネットニュースやメーリングリストを購読したことがない場合は、www.dejanews.comを使ってメーリングリストのアーカイブやニュースグループに投稿された古い記事に目を通します。 そうすれば、特定のニュースグループや投稿しようとしているメーリングリストの質問方法に慣れることができます。 同じ質問が以前に出ていたら、その回答も出ている可能性は高いはずです。 注意深く探せば、ネットニュースやメーリングリストのアーカイブからその答が出てくることでしょう。
直接的に質問します。 質問内容をよく練っておき、端的に尋ねます。 出し抜けにそのような質問をするのは無礼な感じがするかもしれませんが、それがお決まりのやり方なのです。
Win32 Perl向けのライブチャット/ヘルプについては、IRCのUnderNetの#perl_win32チャンネルがお薦めです。
比較的新しいチャンネルですが、成長を続けており、オープンなディスカッションポリシーを取っています（Perlに関することなら何を話してもかまいません）。
このチャンネルは、David Grove (pete@dave-world.net)が所有、運営しています。
UNIXやさらに一般的なPerlプログラミングについては、EFnet（大規模局）及びUnderNetの#perlを試してみるとよいでしょう。
但し、EFnetの#perlには注意が必要です。
受け入れられないディスカッショントピックスがかなりあるのです。
具体的には、Win32特有のPerlの問題、非プログラマの質問（たとえば、「いいスクリプトをダウンロードしたのですが、どうやって動かしたらいいのでしょうか」）、CGI/WWWプログラミングなどです。
しかし、EFnetの#perlでは、Tom Christiansen (tchrist) や Randall Schwartz (q[merlyn])などのPerlの鉄人に出会うこともできます。
私はそこではまだLarryには会っていませんが、時々行っていると彼は言っていました。
これらのIRCチャンネルでは、自分自身で作業を行い、自分自身で問題を解決しようとすることが求められます。 自分がダウンロードしたスクリプトについて、誰かが一々調べてくれるとか、「動かしたいが自分でPerlを勉強する時間はない」のに誰かが動くようにしてくれるなどと期待して入ってはなりません。 このような態度は、直ちにチャンネルへの出入り禁止を招きます。 これらのチャンネルのメンバは、自分の仕事を他人に押しつけるようなタイプには容赦しない、オーバワークのプログラマ達なのです。
質問が終わってもしばらくはそのまま留まり、チャットした方がよいでしょう。 それが礼儀というものであり、「Perlスタイル」やPerlプログラマが日々どのようなことを考えているのかを学ぶよい方法でもあります。
この FAQ は、元々Evangelo Prodromou evangelo@endcontsw.comが作成し、保守していたものです。 現在、この文書は、O'Reilly社のBrian Jepson及びActiveState社のDavid GroveとDavid Dmytryshynが改訂・更新しています。
このFAQはパブリックドメインですが、使用する場合はオリジナルの作者について明示してください。
|
Win32 FAQ |