编程学习biancheng.45soft.com 本站提供了各种在线教程和资料,供大家学习与参考.
编程学习
当前位置: 主页 > Perl > 简单老式文档POD >

Perl 简单老式文档POD


设计 Perl 的一个原则是简单的事情应该简单,而难的事情应该有可能简单。文档应该简单。


Perl 支持一种叫 pod 的简单文本标记格式,它可以独立存在或者自由地与你的源代码混合在一起形成嵌入的文档。Pod 可以转换成许多其他格式,用于查阅或者打印,或者你也可以直接阅读它,因为它很简单。


Pod 不象 XML,LatEx,troff(1) 那样富于表现力,甚至连 HTML 都不如。这么做是故意的:我们为了简单和方便牺牲了表现力。有些文本标记语言让作者写的标记比文本还多,这样就把写作变得比原来还要复杂,而阅读则几乎是不可能的。一个好的格式应该象好的电影乐曲那样,隐藏在后台而不会让观众的注意力分散。


让程序员写文档几乎和让他们打领带一样困难。Pod 的设计让写文档非常容易,甚至一个程序员都可以写——并且愿意写。我们可没有说 pod 胜任写一本书——尽管它足够写我们这本。

Perl
Perl 简单老式文档POD