这是 pafp 命令,可以使用我们的多个免费在线工作站之一(例如 Ubuntu Online、Fedora Online、Windows 在线模拟器或 MAC OS 在线模拟器)在 OnWorks 免费托管提供商中运行
程序:
您的姓名
paf -Pod 抽象过滤器。 从命令行转换 Pod 文档。
概要
嘘$>
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 覆盖排序 cut clear_podcmds SomeClass.pm
# -p 将发出 pod 源,而不是生成 perldoc。
paf -p 排序 Pod::Abstract::Node
paf -p 查找吊机 Pod::Abstract::Node
商品描述
Paf 是一个小而强大的模块化 Pod 过滤器和转换工具。 它允许充分
使用 Pod::Abstract 库对 Pod 文档进行往返转换,具有多个
过滤器链无需在每一步序列化/重新解析文档。
Paf 附带一小组有用的过滤器,但可以通过简单地编写新的过滤器来扩展
“Pod::Abstract::Filter”命名空间中的类。
滤波器
添加podcmds
在每个剪切部分的末尾添加显式 =pod 命令,以便所有 pod 部分都
以 =pod 命令开始。
清除podcmds
删除所有不结束切割块的 =pod 命令。 这将清理以下文件
也使用“剪切”过滤器减少了。
切
删除所有被剪切的节点,以便仅保留 pod。
覆盖
paf 覆盖 Source.pm
为了使覆盖生效,源代码中必须有一个“begin :overlay/end :overlay”部分
文件,其中包含“=overlay SECTION Module”定义。 最终效果是任何
章节中缺少的副标题是从指定模块中的同一章节添加的。
请注意,这将覆盖整个子标题,包括剪切节点,因此它可以添加代码
到源文档。 如果你不想要这个,请使用“剪切”。
每个重叠部分将包含一个“=for override from”标记,以便可以
由同一文件/模块中的后续覆盖替换。 这些部分将
就地替换,因此第一次覆盖后的部分顺序将被保留。
取消覆盖
paf unoverlay Source.pm
带 所有 标记为覆盖的部分并与源中的覆盖规范相匹配。
分类
paf sort [-heading=METHODS] Source.pm
对指定标题中的所有副标题进行排序(如果未提供,则为方法)。
这将移动剪切节点及其标题,因此您的代码将会发生变化。 使用“切”
如果您只想在输出中添加 pod。
或者,您也可以通过包含“=for sorting”来对标题进行排序
在该部分的开头(第一个小标题之前)。
摘要
提供文档的简短摘要。 如果正文中有一个逐字节点
包含标题名称的标题,它将被视为示例并扩展为
摘要的一部分。
发现
paf 查找 [-f=]名称 Source.pm
查找提及名称的特定子部分或列表项。 用于限制较大的
将文档缩小到您感兴趣的较小集合。如果未指定 -f,则
find 后面的单词将是搜索项。
完整无缺
paf 未切割 Source.pm
将源中的剪切节点转换为逐字文本。 不是切的逆!
number_sections
paf number_sections Source.pm
将简单的多部分 (3.1.2) 节编号应用于 head1 到 head4 标题。
请注意,number_sections 目前会塞满一些聪明的东西,例如
摘要,因为部分名称将不再与函数名称匹配。
使用 onworks.net 服务在线使用 pafp