問題タブ [perl-pod]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票する
1 に答える
143 参照

perl - 1 つのマスター Pod ファイルを複数のビューに分割できる Perl モジュールはありますか?

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

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

と (perlop)

0 投票する
1 に答える
248 参照

perl - Pod::Usage で表示されないように、Perl の Pod の空行を取り除くにはどうすればよいですか?

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

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

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

0 投票する
2 に答える
585 参照

perl - Perl POD ドキュメントで空白行が必要な場合

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

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

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

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

0 投票する
1 に答える
228 参照

perl - 抽象クラスとポッド::カバレッジ

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

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

0 投票する
6 に答える
1870 参照

perl - POD よりも perl コードを文書化するための良い方法はありませんか?

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

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

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

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

0 投票する
1 に答える
374 参照

perl - Perlスクリプトの最後に複数のPODを追加するにはどうすればよいですか?

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

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

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

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

0 投票する
3 に答える
1509 参照

perl - オンライン Perl POD レンダラー

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

0 投票する
2 に答える
183 参照

regex - この正規表現が Pod::Usage テキストから最後の空白を削除しないのはなぜですか?

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

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

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

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

0 投票する
1 に答える
1297 参照

html - PodをHTMLに変換するためにどのPerlモジュールを使用しますか?

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

0 投票する
1 に答える
156 参照

perl - weaver.ini から Pod::Weaver プラグインに配列を渡すにはどうすればよいですか

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

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

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

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