問題タブ [perl-pod]

と の Pod ファイルを 1 つ書きたいと思いperlopますperlopref。私の本能は、次のようなことを言うことです

そして生成させます (perlopref)

と (perlop)

getopt::long で使用した次のポッドがあります。

-h を指定すると、次のように生成されます。

私の質問は: -h と -i の間の空の行を削除するにはどうすればよいですか?

多くの Pod には次のような行の間に空白行があることに気付きました

これらの空白行は厳密に必要ですか? 特定のパーサーが行方不明になった場合、動揺しますか?

perlpodのcutの説明は少し役に立ちますが、他の構成について疑問に思っていました:

Pod ブロックを終了するには、空白行を使用し、次に "=cut" で始まる行を使用し、その後に空白行を使用します。これにより、Perl (および Pod フォーマッター) は、ここで Perl コードが再開されていることを認識できます。(「=cut」の前の空白行は技術的には必要ありませんが、多くの古い Pod プロセッサでは必要です。)

私は最近、Dist::Zillaを維持するために使用しようとし始めましたPath::Class。[PodCoverageTests]プラグインを追加しましたPath::Class::Entityが、との抽象基本クラスであるクラスでいくつかの失敗が報告されPath::Class::FileていPath::Class::Dirます。

私が欲しいのEntityは、ドキュメントを必要としないテストコードを伝える方法ですが、メソッドが親クラスでのみ定義されている場合でも、その2つの派生クラスはドキュメントを必要とします。誰かがそれを行う方法を知っていますか？

私は長い間 Perl プログラマーですが、POD のドキュメントには常に問題があります。

コードで POD コメントを使用すると、コードが読みにくくなります。ファイルの最後に POD コメントを使用すると、ドキュメントがコードと同期されない危険性があります。

Java に似たドキュメント スタイルが恋しいです。

私は、より簡単で直感的なドキュメンテーション スタイルを探しています。そのようなことはありますか？

スクリプトでGetopt::Longを使用する方法について、perlのドキュメントにあるチュートリアルを使用していました。そこでは、サブルーチンなどにすべてを入力するのではなく、Pod::Usageを使用してドキュメントを追加する方法を示しています。とにかく、例では彼らはこれを持っています。

私は自分の議論のいくつかを追加しました。

ドキュメントの最初のセクションを参照する方法を学びます。しかし、どのように私はによって述べられているように2番目のセクションを参照するのpod2usage(2)ですか？

セクション1の最後の後に新しいセクションを追加すると、=cutそれを表示しようとすると、セクションを表示せずに出入りするように、コマンドプロンプトが表示されます。私は何か間違ったことをしていますか？

POD プレビューアがあった「公式」サイト (perl.org または cpan.org) を覚えているようです。ファイルをアップロードすると、含まれている POD が CPAN に表示されるのと同じように表示されます。誰かがこのリンクを持っていますか。私はそれを見つけることができないようです。

Pod::Usageに依存して呼び出しスクリプトの POD を解析し、使用法、ヘルプ、およびマニュアル テキストをスカラー変数に送信するモジュールに取り組んでいます。そのテキストから最後の空白を削除する必要があったため、機能すると思われる単純な正規表現を使用しました。そしてそれは...しかし断続的に。

これが問題のデモンストレーションです。任意の洞察をいただければ幸いです。

Perl 5.10.1 を搭載した Solaris マシンで、予期しない動作 (つまり、正規表現が最後の改行を削除できない) が一貫して発生します。Windows で Perl 5.12.1 を使用すると、動作が不安定になります (以下に出力を示します)。

私のWindowsボックスでの出力：

ポッドをHTMLに変換する必要があります。Pod::HTMLモジュールとPod::Simple::*モジュールがいくつかあります。どちらを使うべきですか？

そのため、プラグイン自体に何かを渡すにweaver.iniは Moose 属性が必要なようです。だから私はこのようなものを持っている場合weaver.ini

プラグインに対応する属性が必要です。

ただし、エラーが発生します

どこが間違っているのかわかりません。構文を上に変更しようとしましたweaver.iniが、そうではないようです。