in reply to POD: For Beginners

I created a simple script called hello.pl. I use the perldoc command-line utility to render the POD as a manpage, as follows:
$ cat hello.pl =head1 NAME hello.pl - say hello =head1 DESCRIPTION Example: perl hello.pl =cut use warnings; use strict; print "hello\n"; $ $ $ perldoc hello.pl HELLO(1) User Contributed Perl Documentation +HELLO(1) NAME hello.pl - say hello DESCRIPTION Example: perl hello.pl perl v5.8.9 2011-07-22 +HELLO(1)
You may see NAME and DESCRIPTION in bold in your shell.

In the CB, someone also pointed to Documenting Code -> POD in 5 minutes