問題タブ [perldoc]

コマンドを使用して Linux コマンド ラインから Perl モジュールをインストールすると、cpan次のように正常に動作します。

終了後、次の方法でモジュールのドキュメントを確認できます。

しかし、コマンドcfengineのスクリプトを自動化するだけのを介してこれを行うと ( shellcommands:リストで)、モジュールはインストールされますが、それに対しては機能しません:cpanperldoc

ただし、次のように呼び出します。

うまくいきます。

ファイルが非常に多様な場所に配置されていることを確認しているため、これに一般的な環境変数を設定することは ( perldocman ページで提案されているように) 実行可能ではないようです。.pm

これについてのヒントはありますか？

例でこれに出くわしたとき、私はperldocsを閲覧していました（http://perldoc.perl.org/perlre.html#Regular-Expressions - Capture Groups example を参照）

その構文の意味に関するドキュメントは見つかりませんでした。

では、このコンテキストで正規表現 /${a}/ は何を意味するのでしょうか?

foo.pmWeb サービスからデータを収集するクラスを作成しました。内部foo.pmには、機能を説明するための perldoc と、使用法に関する簡単なガイドを追加しました。すべてのメソッドのリファレンスがあります。

cachedFoo.pmまた、基本クラスとして使用するサブクラスを作成しfoo.pm、独自のコンストラクターをfooのnewメソッドにラップし、データベース接続でアップグレードfooして結果をキャッシュします。私はすでに追加cachedFoo.pmのもののために perldoc を追加しました。

今は同僚だけに を使ってもらいたいですcachedFoo.pm。から継承されたすべてのメソッドの perldoc をコピーする必要がありますかfoo.pm、cachedFoo.pmそれとも単に「アクセサについては基本クラスのドキュメントを参照してください」と言うべきですか? それとも別の方法がありますか？

私は、POD コメントが文書化されたコードの横にある、一種のリテラル プログラミング スタイルを好みます。残念ながら、これはコードを肥大化させますが、これはあまり Perlish ではありません ;-) 今のところ私が見つけることができる最良の方法は、次のようにPod::WeaverでDist::Zillaを使用することです:

空行を削除することを主張することもできますが、これは可読性も低下させます。次のような繰り返し不要な構文を使用せずに、より簡潔に記述する方法はありませんか。

そして、これを完全な POD に拡張します。

おそらく Pod::Weaver プラグインを使用する必要があると思いますが、Pod::Weaver と Dist::Zilla および PPI を組み合わせたアーキテクチャを理解しようとすると、頭が痛くなりました :-(

多分私はこれを正しく行っていませんが、多くのPOD リンクの例では、コードはpod2htmlで機能しません。

例えば：

C:\perldoc filenameとで動作するようC:\pod2text filenameですが、C:\pod2html --title=SomeText --outfile=filename.html filename出力は次のとおりです。

私のインストールまたは私のコードに問題があると思いますか? どうすれば修正できますか？

アップデート：

モジュールのバージョンは次のとおりです。

POD ドキュメントに次の行があります。

これを次のようにフォーマットしたい：

ただし、 を実行するpod2htmlと、次のエラーが発生します。

Perlpodのドキュメントと Perlpodspec のドキュメントによると、これは正しいはずです。または、少なくとも私にはそのように見えます。

私は何を間違っていますか？

ちなみに、リンクはpod2markdown.

私はこれがばかげた質問であることを知っています。Perl を使い始めて約 2 か月になりますが、興味がありperldocます。私はそれを使用する方法を見つけ、変数man perldocに関するドキュメントを見つけようとしました。@ISA

しかし、私がするとき：

それは言う

私はperldoc権利を使用していますか？または、何かをインストールする必要がありますか？

Perl ドキュメントでアポストロフィを正しく表示する方法がわかりません。たとえば、テキストは のように'test'表示されâtestâます。

• E<39>としてもレンダリングされますâ
  • またI<'>
  • またS<'>
  • またE<apos>
• C<'>としてレンダリングします"'"（明らかに端末は問題ではありません）
• F<'>下線付きでレンダリングâ

で実行perldocしてみましたが-T、違いは-n nroffあり-n troffませんでした。-tアポストロフィの問題を修正して実行すると、他のすべてのテキスト属性も削除されます。

私はしばらくこれを我慢してきましたが、本当にイライラし始めています。それらを正しく表示するにはどうすればよいですか？

私は最近、Perl コードに少し触れるようになりましたが、そのいくつかの側面はまだわかりません。これです：

collectionat-symbolが配列として定義されていることを理解しています。また、少し調べてみたところ、特にI/O Operatorsに関する部分で perldoc にたどり着きました。null ファイルハンドルが特に興味深いことがわかりました。コードは続きます。

同じトピックで、この構文も有効であることにも気付きました。

globperldoc によると、実際には、次のコードと同様の方法で呼び出す内部関数を呼び出しています。

質問

最初の行で言及されている小なり、アスタリスク、大なり ( <*> ) 記号は実際には何をしますか? 内部で開いて参照されているグロブへの参照ですか? null ファイルハンドルなどの特殊なケースでしょうか? それとも、従来の実装のように、まったく異なるものにすることができますか?