文檔

perldoc

perldoc?是 Perl 完整的語(yǔ)言參考工具。

• perldoc perldoc：用法介紹
• perldoc perl：文檔概述
• perldoc Module：模塊文檔

利用?perldoc -f?查閱 Perl 函數(shù)

$ 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

$ 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 模塊文檔

如果模塊已經(jīng)安裝到你的系統(tǒng)中，那么你可以通過(guò)?perldoc?閱讀該模塊的文檔。

$ perldoc WWW::Mechanize

NAME
    WWW::Mechanize - Handy web browsing in a Perl object

VERSION
    Version 1.73

SYNOPSIS
    "WWW::Mechanize", or Mech for short, is a Perl module for stateful
    programmatic web browsing, used for automating interaction with
    websites.
...

對(duì)于沒(méi)有安裝的模塊，你將需要使用?http://search.cpan.org?或?cpandoc。

利用?cpandoc?查閱未安裝 Perl 模塊的文檔

Pod::Cpandoc?模塊提供了?cpandoc?工具，利用該工具，即便模塊沒(méi)有安裝到 系統(tǒng)上，但你仍然能夠查閱該模塊的文檔。

$ cpandoc Web::Scraper

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

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

在線文檔

一些網(wǎng)站維護(hù)有 Perl 的 HTML 文檔，最大的兩個(gè)站點(diǎn)是：

1. http://perldoc.perl.org：語(yǔ)言、函數(shù)及標(biāo)準(zhǔn)庫(kù)
2. http://search.cpan.org：模塊

編寫自己的文檔

Perl 具有濃烈的文檔文化，我們鼓勵(lì)你早日養(yǎng)成此習(xí)慣。你將使用一種叫做 POD 的格式來(lái)編寫文檔。