perl内置文档的使用——1

perldoc

perldoc 是 Perl 完整的语言参考工具。
【1】perldoc perldoc:用法介绍
【2】perldoc perl:文档概述
【3】perldoc Module:模块文档

利用 perldoc -f 查阅 Perl 函数

$ perldoc -f system

system LIST
system PROGRAM LIST
        Does exactly the same thing as "exec LIST", except that a fork
        is done first and the parent process waits for the child
...

利用 perldoc -v 查阅 Perl 变量

$ perldoc -v '$/'

IO::Handle->input_record_separator( EXPR )
$INPUT_RECORD_SEPARATOR
$RS
$/      The input record separator, newline by default.  This
...

利用 perldoc -q 搜索 Perl FAQ(FAQ为常见问题)

$ perldoc -q database

Found in /usr/share/perl/5.18/pod/perlfaq8.pod
How do I use an SQL database?

    The DBI module provides an abstract interface to most database servers
    and types, including Oracle, DB2, Sybase, mysql, Postgresql, ODBC, and
...

利用 perldoc modulename 查阅 Perl 模块文档

如果模块已经安装到你的系统中,那么你可以通过 perldoc 阅读该模块的文档。阅读模块内嵌帮助文档,只需提供模块名作为参数即可

perldoc Pod::Simple
perldoc B::Depars

查看模块的源代码

perldoc -m Pod::Simple
#不过上面的得到的源代码没有格式和语法高亮,看起来很不方便
#可以转到vim里查看
perldoc -m Pod::Simple > simple.pl
vim simple.pl

对于没有安装的模块,你将需要使用 http://search.cpan.org 或 cpandoc

利用 cpandoc 查阅未安装 Perl 模块的文档

Pod::Cpandoc 模块提供了 cpandoc 工具,利用该工具,即便模块没有安装到 系统上,但你仍然能够查阅该模块的文档。

$ cpandoc Web::Scraper

NAME
    Web::Scraper - Web Scraping Toolkit using HTML and CSS Selectors or
    XPath expressions

SYNOPSIS
    use URI;
    use Web::Scraper;
...

在线文档

一些网站维护有 Perl 的 HTML 文档,最大的两个站点是:

【1】http://perldoc.perl.org:语言、函数及标准库
【2】http://search.cpan.org:模块

编写自己的文档

Perl 具有浓烈的文档文化,我们鼓励你早日养成此习惯。你将使用一种叫做 POD 的格式来编写文档。

参考文献:
【1】https://blog.csdn.net/weixin_34387284/article/details/85976807
【2】http://perl.linuxtoy.org/documentation.html

发布了71 篇原创文章 · 获赞 8 · 访问量 7368

猜你喜欢

转载自blog.csdn.net/qq_43042339/article/details/104605252
今日推荐