From: Gurusamy Sarathy <gsar@cpan.org>
Date: Thu, 25 Mar 1999 10:39:02 +0000 (+0000)
Subject: clarify what a "comment" means (due to Mark-Jason Dominus
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=f00f6914c1324e1033f4c97376db36a06ca8a53b;p=p5sagit%2Fp5-mst-13.2.git

clarify what a "comment" means (due to Mark-Jason Dominus
<mjd@plover.com>)

p4raw-id: //depot/perl@3167
---

diff --git a/pod/perlsyn.pod b/pod/perlsyn.pod
index 8321235..a3bc5ab 100644
--- a/pod/perlsyn.pod
+++ b/pod/perlsyn.pod
@@ -21,13 +21,13 @@ mandatory default like it is in B<sed> and B<awk>.)
 
 =head2 Declarations
 
-Perl is, for the most part, a free-form language.  (The only
-exception to this is format declarations, for obvious reasons.) Comments
-are indicated by the C<"#"> character, and extend to the end of the line.  If
-you attempt to use C</* */> C-style comments, it will be interpreted
-either as division or pattern matching, depending on the context, and C++
-C<//> comments just look like a null regular expression, so don't do
-that.
+Perl is, for the most part, a free-form language.  (The only exception
+to this is format declarations, for obvious reasons.)  Text from a
+C<"#"> character until the end of the line is a comment, and is
+ignored.  If you attempt to use C</* */> C-style comments, it will be
+interpreted either as division or pattern matching, depending on the
+context, and C++ C<//> comments just look like a null regular
+expression, so don't do that.
 
 A declaration can be put anywhere a statement can, but has no effect on
 the execution of the primary sequence of statements--declarations all