for your comments:
some clarifications on POD commenting:
localhost_brian[2969]$ cvs diff -u -d perlfaq7.pod
Index: perlfaq7.pod
===================================================================
RCS file: /cvs/public/perlfaq/perlfaq7.pod,v
retrieving revision 1.7
diff -u -d -r1.7 perlfaq7.pod
--- perlfaq7.pod 31 Jan 2002 04:27:55 -0000 1.7
+++ perlfaq7.pod 25 Mar 2002 17:49:31 -0000
@@ -741,7 +741,8 @@
=head2 How can I comment out a large block of perl code?
-Use embedded POD to discard it:
+You can use embedded POD to discard it. The =for directive
+lasts until the next paragraph (two consecutive newlines).
# program is here
@@ -750,6 +751,9 @@
# program continues
+The =begin and =end directives can contain multiple
+paragraphs.
+
=begin comment text
all of this stuff
@@ -759,11 +763,12 @@
=end comment text
- =cut
+The pod directives cannot go just anywhere. You must put a
+pod directive where the parser is expecting a new statement,
+not just in the middle of an expression or some other
+arbitrary yacc grammar production.
-This can't go just anywhere. You have to put a pod directive where
-the parser is expecting a new statement, not just in the middle
-of an expression or some other arbitrary yacc grammar production.
+See L<perlpod> for more details.
=head2 How do I clear a package?
