[PHP-DOC] cvs: phpdoc /en/language basic-syntax.xml

[Rasmus Lerdorf]

rasmus          Sat Nov  5 03:08:35 2005 EDT

  Modified files:              
    /phpdoc/en/language basic-syntax.xml 
  Log:
  Fix up the wording a bit here
  
  
http://cvs.php.net/diff.php/phpdoc/en/language/basic-syntax.xml?r1=1.47&r2=1.48&ty=u
Index: phpdoc/en/language/basic-syntax.xml
diff -u phpdoc/en/language/basic-syntax.xml:1.47 
phpdoc/en/language/basic-syntax.xml:1.48
--- phpdoc/en/language/basic-syntax.xml:1.47    Tue Sep 27 14:22:19 2005
+++ phpdoc/en/language/basic-syntax.xml Sat Nov  5 03:08:34 2005
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.47 $ -->
+<!-- $Revision: 1.48 $ -->
  <chapter id="language.basic-syntax">
   <title>Basic syntax</title>
   <sect1 id="language.basic-syntax.phpmode">
@@ -183,15 +183,15 @@
     </informalexample>
    </para>
    <simpara>
-    The "one-line" comment styles only comment to the end of
+    The "one-line" comment styles only comments to the end of
     the line or the current block of PHP code, whichever comes first.
     This means that HTML code after <literal>// ?&gt;</literal> WILL be 
printed:
-    ?&gt; skips out of the PHP mode and returns to HTML mode, and
+    ?&gt; breaks out of PHP mode and returns to HTML mode, and
     <literal>//</literal> cannot influence that.
-    If <link linkend="ini.asp-tags">asp_tags</link> configuration directive
+    If the <link linkend="ini.asp-tags">asp_tags</link> configuration directive
     is enabled, it behaves the same with <literal>// %&gt;</literal>.
-    However, <literal>&lt;/script&gt;</literal> tag doesn't escape PHP mode in
-    one-line comment.
+    However, the <literal>&lt;/script&gt;</literal> tag doesn't break out of 
PHP mode in
+    a one-line comment.
    </simpara>
    <para>
     <informalexample>
@@ -204,9 +204,9 @@
     </informalexample> 
    </para>
    <simpara>
-    'C' style comments end by the first encountered <literal>*/</literal>.
-    You should be careful not to nest 'C' style comments, which can
-    happen when commenting out large blocks.
+    'C' style comments end at the first <literal>*/</literal> encountered.
+    Make sure you don't nest 'C' style comments.  It is easy to make this
+    mistake if you are trying to comment out a large block of code.
    </simpara>
    <para>
     <informalexample>