問題タブ [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.
perl - 1 つのマスター Pod ファイルを複数のビューに分割できる Perl モジュールはありますか?
と の Pod ファイルを 1 つ書きたいと思いperlop
ますperlopref
。私の本能は、次のようなことを言うことです
そして生成させます (perlopref)
と (perlop)
perl - Pod::Usage で表示されないように、Perl の Pod の空行を取り除くにはどうすればよいですか?
getopt::long で使用した次のポッドがあります。
-h を指定すると、次のように生成されます。
私の質問は: -h と -i の間の空の行を削除するにはどうすればよいですか?
perl - Perl POD ドキュメントで空白行が必要な場合
多くの Pod には次のような行の間に空白行があることに気付きました
これらの空白行は厳密に必要ですか? 特定のパーサーが行方不明になった場合、動揺しますか?
perlpodのcutの説明は少し役に立ちますが、他の構成について疑問に思っていました:
Pod ブロックを終了するには、空白行を使用し、次に "=cut" で始まる行を使用し、その後に空白行を使用します。これにより、Perl (および Pod フォーマッター) は、ここで Perl コードが再開されていることを認識できます。(「=cut」の前の空白行は技術的には必要ありませんが、多くの古い Pod プロセッサでは必要です。)
perl - 抽象クラスとポッド::カバレッジ
私は最近、Dist::Zilla
を維持するために使用しようとし始めましたPath::Class
。[PodCoverageTests]
プラグインを追加しましたPath::Class::Entity
が、との抽象基本クラスであるクラスでいくつかの失敗が報告されPath::Class::File
ていPath::Class::Dir
ます。
私が欲しいのEntity
は、ドキュメントを必要としないテストコードを伝える方法ですが、メソッドが親クラスでのみ定義されている場合でも、その2つの派生クラスはドキュメントを必要とします。誰かがそれを行う方法を知っていますか?
perl - POD よりも perl コードを文書化するための良い方法はありませんか?
私は長い間 Perl プログラマーですが、POD のドキュメントには常に問題があります。
コードで POD コメントを使用すると、コードが読みにくくなります。ファイルの最後に POD コメントを使用すると、ドキュメントがコードと同期されない危険性があります。
Java に似たドキュメント スタイルが恋しいです。
私は、より簡単で直感的なドキュメンテーション スタイルを探しています。そのようなことはありますか?
perl - Perlスクリプトの最後に複数のPODを追加するにはどうすればよいですか?
スクリプトでGetopt::Longを使用する方法について、perlのドキュメントにあるチュートリアルを使用していました。そこでは、サブルーチンなどにすべてを入力するのではなく、Pod::Usageを使用してドキュメントを追加する方法を示しています。とにかく、例では彼らはこれを持っています。
私は自分の議論のいくつかを追加しました。
ドキュメントの最初のセクションを参照する方法を学びます。しかし、どのように私はによって述べられているように2番目のセクションを参照するのpod2usage(2)
ですか?
セクション1の最後の後に新しいセクションを追加すると、=cut
それを表示しようとすると、セクションを表示せずに出入りするように、コマンドプロンプトが表示されます。私は何か間違ったことをしていますか?
perl - オンライン Perl POD レンダラー
POD プレビューアがあった「公式」サイト (perl.org または cpan.org) を覚えているようです。ファイルをアップロードすると、含まれている POD が CPAN に表示されるのと同じように表示されます。誰かがこのリンクを持っていますか。私はそれを見つけることができないようです。
regex - この正規表現が Pod::Usage テキストから最後の空白を削除しないのはなぜですか?
Pod::Usageに依存して呼び出しスクリプトの POD を解析し、使用法、ヘルプ、およびマニュアル テキストをスカラー変数に送信するモジュールに取り組んでいます。そのテキストから最後の空白を削除する必要があったため、機能すると思われる単純な正規表現を使用しました。そしてそれは...しかし断続的に。
これが問題のデモンストレーションです。任意の洞察をいただければ幸いです。
Perl 5.10.1 を搭載した Solaris マシンで、予期しない動作 (つまり、正規表現が最後の改行を削除できない) が一貫して発生します。Windows で Perl 5.12.1 を使用すると、動作が不安定になります (以下に出力を示します)。
私のWindowsボックスでの出力:
html - PodをHTMLに変換するためにどのPerlモジュールを使用しますか?
ポッドをHTMLに変換する必要があります。Pod::HTMLモジュールとPod::Simple::*モジュールがいくつかあります。どちらを使うべきですか?
perl - weaver.ini から Pod::Weaver プラグインに配列を渡すにはどうすればよいですか
そのため、プラグイン自体に何かを渡すにweaver.ini
は Moose 属性が必要なようです。だから私はこのようなものを持っている場合weaver.ini
プラグインに対応する属性が必要です。
ただし、エラーが発生します
どこが間違っているのかわかりません。構文を上に変更しようとしましたweaver.ini
が、そうではないようです。