首页 > 其他好文 > 详细

Perl 中 Pod 的基本用法。

时间：2016-11-02 14:32:26 阅读：348 评论：0 收藏：0 [点我收藏+]

标签：命令 details source for strong pac copyto php arc

1. Pod 语法

pod中用段分可以分为三种，普通段落，字面段落（Verbatim Paragraph）和命令段落。
三者的区分非常简单，以=pod|head1|cut|over等指示字开始的段落为命令段落，以空格或制表符（\t）等缩进开始的段落为字面段落，其余的就是普通段落。

[php] view plain copy

=head1
=head2
=head3
=head4
此四个指示字生产指定级别的标题。pod2html时用其对应的<h1> .. </h4>包围此段落，并且自动生成a的命名/name和索引/index.

[plain] view plain copy

=pod
=cut
=pod 只告诉编译器pod文档开始了，而=cut则是pod文档的结束。

[plain] view plain copy

=over NUMBER 缩近多少
=item SYMBOL 产生bullet
=back
这三者是连上一起的。=over后面必须要跟一个=back，而这两者之间最少要有一个=item，同时不能有=head1..4。

[plain] view plain copy

格式代码
格式代码可以用于除字面段落外的所有段落，包括命令段落。
I<text>
用斜体表示text, 效果如text
B<text>
用粗体表示text, 效果如text
C<code>
pod2html时用<code>包围。
L<text|name/sec>
超链接。

2. pod2usage 在package中的使用。

如果想显示 perl module中的pod，那么采用如下

[plain] view plain copy

use Pod::Find qw(pod_where);
pod2usage( -input => pod_where({-inc => 1}, __PACKAGE__) );
其中：-inc=>1 表示 Search @INC for the pod and also the scriptdir __PACKAGE__ 表示包文件，如果是A::B 则表示 A/B
pod_where 返回文件句柄的引用， pod2usage 中default值是 $0, 当前文件而不是包本身

Perl 中 Pod 的基本用法。

标签：命令 details source for strong pac copyto php arc

原文地址：http://www.cnblogs.com/nkwy2012/p/6022579.html

踩

(0)

赞

(0)

举报

评论一句话评论（0）

分享档案

更多>

2021年07月29日 (22)
2021年07月28日 (40)
2021年07月27日 (32)
2021年07月26日 (79)
2021年07月23日 (29)
2021年07月22日 (30)
2021年07月21日 (42)
2021年07月20日 (16)
2021年07月19日 (90)
2021年07月16日 (35)

周排行

更多

友情链接

兰亭集智国之画百度统计站长统计阿里云 chrome插件新版天听网

关于我们 - 联系我们 - 留言反馈

© 2014 mamicode.com 版权所有联系我们:gaon5@hotmail.com

迷上了代码！