Advanced Perl Programming: From Advanced to Expert

© William "Bo" Rothwell of One Course Source, Inc. 2020

W. ". RothwellAdvanced Perl Programminghttps://doi.org/10.1007/978-1-4842-5863-7_10

10. POD

William “Bo” Rothwell¹ 

(1)

El Cajon, CA, USA

 

POD (Plain Old Documentation) is the method you want to use to document your Perl modules. While simple comments work well for pointing out tricky code, they are cumbersome when you want to give a detailed explanation of your module.

POD was designed so you can create formatted comments. POD uses tags to specify text formats such as fonts as well as text positions.

POD can be embedded within your code or placed in a separate file. When embedded within your code, there are methods of telling the Perl interpreter when to execute code and when to skip over lines. ...