内容

名称

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:[email protected] 邮件列表。向 mailto:[email protected] 发送一封空电子邮件以订阅。

此模块在开放的 GitHub 存储库 https://github.com/theory/pod-simple/ 中进行管理。随时进行分叉和贡献，或克隆 git://github.com/theory/pod-simple.git 并发送补丁！

欢迎针对 Pod::Simple 的补丁。请将错误报告发送至 mailto:<[email protected].

版权和免责声明

版权所有 (c) 2002 Sean M. Burke。

此库是免费软件；你可以在与 Perl 相同的条款下重新发布和/或修改它。

此程序发布的目的是希望它有用，但没有任何保证；甚至没有适销性或针对特定目的的适用性的默示保证。

作者

Pod::Simple 由 Sean M. Burke <[email protected]> 创建。但不要打扰他，他已经退休了。

Pod::Simple 由以下人员维护

Pod::Simple::JustPod 由 John SJ Anderson [email protected] 开发，并得到了 Karl Williamson [email protected] 的贡献。