これは、Ubuntu Online、Fedora Online、Windows オンライン エミュレーター、MAC OS オンライン エミュレーターなど、複数の無料オンライン ワークステーションのいずれかを使用して、OnWorks 無料ホスティング プロバイダーで実行できるコマンド pafp です。
プログラム：
NAME
paf - Pod 抽象フィルター. コマンドラインから Pod ドキュメントを変換します。
SYNOPSIS
sh$>
paf まとめ /usr/bin/paf
paf add_podcmds SomeModule.pm
paf sort -heading=METHODS Pod/Abstract/Node.pm # METHODS がデフォルト
paf 並べ替えの概要 Pod/Abstract/Node.pm
# Pod::Abstract::Filter::overlay を参照
paf オーバーレイ ソート カット clear_podcmds SomeClass.pm
# -p は、perldoc を生成する代わりに、pod ソースを出力します。
paf -p sort Pod::Abstract::Node
paf -p ホイストを見つける Pod::Abstract::Node
DESCRIPTION
Paf は、小さいながらも強力なモジュラー Pod フィルターおよび変換ツールです。 それは完全に許可します
複数の Pod::Abstract ライブラリを使用した Pod ドキュメントの往復変換
各ステップでドキュメントをシリアライズ/再解析する必要なくチェーンをフィルタリングします。
Paf には便利なフィルターの小さなセットが付属していますが、新しいフィルターを作成するだけで拡張できます
「Pod::Abstract::Filter」名前空間のクラス。
FILTERS
add_podcmds
各カット セクションの最後に明示的な =pod コマンドを追加して、すべてのポッド セクションが
=pod コマンドで開始します。
clear_podcmds
カット ブロックを終了していないすべての =pod コマンドを削除します。 これにより、次のドキュメントがクリーンアップされます。
「カット」フィルターも使用して削減されています。
cut
ポッドのみが残るように、カットされたノードをすべて削除します。
オーバーレイ
paf オーバーレイ Source.pm
オーバーレイを機能させるには、ソースに「begin :overlay/end :overlay」セクションが必要です。
"=overlay SECTION Module" 定義を含むファイル。 正味の効果は、
SECTION で欠落している小見出しは、指定されたモジュールの同じセクションから追加されます。
これにより、CUT NODES を含む小見出し全体がオーバーレイされるため、コードを追加できることに注意してください。
ソース ドキュメントに。 これが必要ない場合は、「カット」を使用してください。
オーバーレイされた各セクションには、「= for overlay from」マーカーが含まれます。
同じファイル/モジュールからの後続のオーバーレイに置き換えられます。 これらのセクションは
インプレースで置き換えられるため、最初にオーバーレイされたセクションの順序が保持されます。
オーバーレイ解除
paf unoverlay Source.pm
ストリップ を オーバーレイとしてマークされ、ソースのオーバーレイ仕様に一致するセクション。
sort
paf sort [-Heading=METHODS] Source.pm
名前付き見出し (指定されていない場合は METHODS) 内のすべての小見出しを並べ替えます。
これにより、カット ノードが見出しとともに移動するため、コードが変更されます。 「切る」を使う
出力にポッドのみが必要な場合。
または、「= for sorting」を含めることで、見出しのソートを発生させることもできます
セクションの開始時 (最初の小見出しの前)。
要約
ドキュメントの要約を提供します。 の本体に verbatim ノードがある場合
見出し名を含む見出し、それは例と見なされ、次のように展開されます
まとめの一部。
find
paf find [-f=]name Source.pm
名前に言及している特定のサブセクションまたはリスト項目を検索します。 より大きなものを制限するために使用されます
興味のあるより小さなセットに文書化します。 -f が指定されていない場合、
find に続く単語が検索語になります。
カットされていない
パフ アンカット Source.pm
ソース内のカット ノードを逐語テキストに変換します。 カットの逆ではありません！
セクション数
paf 番号_セクション Source.pm
単純なマルチパート (3.1.2) セクションの番号付けを head1 から head4 の見出しに適用します。
number_sections は現在、次のようないくつかの巧妙さを詰め込んでいることに注意してください
セクション名が関数名と一致しなくなるためです。
onworks.net サービスを使用して pafp オンラインを使用する
