cvs commit: perlfaq perlfaq7.pod

cvsuser     02/03/26 07:48:32

  Modified:    .        perlfaq7.pod
  Log:
  * clarified 'How can I comment out a large block of perl code?' examples
  
  * referred reader to perlpod for more details
  
  Revision  Changes    Path
  1.8       +11 -6     perlfaq/perlfaq7.pod
  
  Index: perlfaq7.pod
  ===================================================================
  RCS file: /cvs/public/perlfaq/perlfaq7.pod,v
  retrieving revision 1.7
  retrieving revision 1.8
  diff -u -w -r1.7 -r1.8
  --- perlfaq7.pod	31 Jan 2002 04:27:55 -0000	1.7
  +++ perlfaq7.pod	26 Mar 2002 15:48:32 -0000	1.8
  @@ -1,6 +1,6 @@
   =head1 NAME
   
  -perlfaq7 - General Perl Language Issues ($Revision: 1.7 $, $Date: 2002/01/31 04:27:55 $)
  +perlfaq7 - General Perl Language Issues ($Revision: 1.8 $, $Date: 2002/03/26 15:48:32 $)
   
   =head1 DESCRIPTION
   
  @@ -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 s 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?