目錄

名稱

Pod::Simple::JustPod -- 只有 Pod、完整的 Pod，以及沒有任何 Pod 的部分

語法

my $infile  = "mixed_code_and_pod.pm";
my $outfile = "just_the_pod.pod";
open my $fh, ">$outfile" or die "Can't write to $outfile: $!";

my $parser = Pod::Simple::JustPod->new();
$parser->output_fh($fh);
$parser->parse_file($infile);
close $fh or die "Can't close $outfile: $!";

說明

此類別會傳回其輸入的副本，轉換為 Perl 的內部編碼 (UTF-8)，並移除所有非 Pod 行。

這是 Pod::Simple::Methody 的子類別，並繼承其所有方法。而由於它本身是 Pod::Simple 的子類別，因此您可以使用它的任何方法。這表示您可以輸出到字串而不是檔案，或者您可以從陣列中進行剖析。

此類別力求將輸入的 Pod 行完全不變地傳回，除了必要的轉換為 Perl 的內部編碼之外，而且它不會嘗試傳回行上的尾隨空白；這些空白可能會被移除。如果輸入的 pod 格式良好，沒有產生任何警告或錯誤，則提取的 pod 應該會在由 Pod 格式化程式格式化時產生與原始檔案相同的文件。

預設情況下，警告會輸出到 STDERR

請參閱

Pod::Simple, Pod::Simple::Methody

支援

有關 POD 和 Pod::Simple 的問題或討論應傳送至 mailto:pod-people@perl.org 郵件清單。傳送一封空白電子郵件至 mailto:pod-people-subscribe@perl.org 以訂閱。

此模組在開放的 GitHub 儲存庫 https://github.com/theory/pod-simple/ 中進行管理。歡迎分岔和貢獻，或複製 git://github.com/theory/pod-simple.git 並傳送補丁程式！

歡迎提供 Pod::Simple 的修補程式。請將錯誤報告寄送至 mailto:<bug-pod-simple@rt.cpan.org。

著作權和免責聲明

著作權 (c) 2002 Sean M. Burke。

此函式庫為免費軟體；您可以根據與 Perl 相同的條款重新散布或修改它。

本程式散布的用意在於希望它能有所幫助，但沒有任何保證；甚至沒有對適銷性或特定用途適用性的默示保證。

作者

Pod::Simple 由 Sean M. Burke <sburke@cpan.org> 建立。但他已經退休，所以別去煩他了。

Pod::Simple 由下列人員維護：

Pod::Simple::JustPod 由 John SJ Anderson genehack@genehack.org 開發，並由 Karl Williamson khw@cpan.org 協助。