title: need to put code comments inside a heredoc
body: <p>Well I can't seem to add comments inside a <code>heredoc</code> block in my <code>foo.php</code> file:</p>
  
  <pre><code>echo &lt;&lt;&lt;_HEREDOC_FOO
  
         // okay this comment was intended to explain the code below but it
         // is showing up on the web page HTML sent to the browser
  
        &lt;form action="foo.php" method="post"&gt;
        &lt;input type="submit" value="DELETE RECORD" /&gt;&lt;/form&gt;
  
  _HEREDOC_FOO;
  </code></pre>
  
  <p>Does the form work, sure (btw the form code above is <em>highly</em> truncated for 
  the sake of my question here).</p>
  
  <p>But the dang comment (<code>okay this comment was..blah blah blah</code>)
   appears in the browser too. It shows up in the
  browser just as written above:</p>
  
  <pre><code>// okay this comment was intended to explain the code below but it
  // is showing up on the web page HTML sent to the browser
  </code></pre>
  
  <p>Permutations on the commenting demarcation I've tried:</p>
  
  <pre><code>// &lt;--  
  // --&gt;
  </code></pre>
  
  <p>and....</p>
  
  <pre><code>&lt;-- //
  --&gt; //
  </code></pre>
  
  <p>FAIL in both cases to allow me to comment inside <code>heredoc</code>.</p>
  
  <p>So how the heck can I comment up my code within my <code>heredoc</code>s?</p>