* apparently the pod formatters (i.e. perldoc, pod2man) actually
don't respect the =for directive. They do understand =begin
though.
* I found that I can't rely on =cut to close the =begin, either.
There are 0 messages
albook_brian[533]$ cvs diff -u -d perlfaq7.pod
Index: perlfaq7.pod
===================================================================
RCS file: /cvs/public/perlfaq/perlfaq7.pod,v
retrieving revision 1.18
diff -u -d -r1.18 perlfaq7.pod
--- perlfaq7.pod 3 Nov 2004 22:54:08 -0000 1.18
+++ perlfaq7.pod 18 Dec 2004 18:13:39 -0000
@@ -736,18 +736,22 @@
=head2 How can I comment out a large block of perl code?
You can use embedded POD to discard it. Enclose the blocks you want
-to comment out in POD markers, for example C<=for nobody> and C<=cut>
-(which marks ends of POD blocks).
+to comment out in POD markers. The <=begin> directive marks a section
+for a specific formatter. Use the C<comment> format, which no
formatter
+should claim to understand (by policy). Mark the end of the block
+with <=end>.
# program is here
- =for nobody
+ =begin comment
all of this stuff
here will be ignored
by everyone
+ =end comment
+
=cut
# program continues
--
brian d foy, [EMAIL PROTECTED]
