從Perl code裡直接產生文檔的方法

Perl支援把你的pod格式文字塊產生文檔，這個pod格式文字塊可以是植入在代碼裡的標記語言，也可以是單獨的一個檔案。
有了pod，只要在寫指令碼的時候，隨手記下想法、說明，就不用再另外編寫文檔了，非常方便。
建議先仔細讀一讀perldoc perlpod裡面的內容，文檔詳細介紹了pod標記語言的文法。
$ perldoc perlpod

盡量保證一個比較好的書寫習慣，例如：
=pod
=head1 NAME
Water::Test – The great new Water::Test!
=head1 VERSION
Version 0.01
=cut

開始和結束都應該要空一行。當你用如上形式寫到你的代碼檔案裡後，你只要用pod2html, pod2man之類的命令，就可以把它轉為文檔。
例如，如果你把上面的代碼儲存為test.txt檔案，則用如下命令可以把它轉為html文檔：
$ pod2html –infile test.txt –outfile text.html