title: Special HTML characters in phpDocumentor in the NetBeans IDE
body: <p>As you know the NetBeans IDE will pop you inline documentation in your PHP sources based on the phpDocumentor syntax.</p>
  
  <p>What I found out is that when I use special HTML characters in my phpDocumentor documentation they are treated as HTML in NetBeans but as text in the HTMl doc generated by phpDocumentor.</p>
  
  <p>For example:</p>
  
  <pre><code>/**
   * Add a new &amp;lt;link&amp;gt; to the &amp;lt;head&amp;gt; of the document.
   */
  </code></pre>
  
  <p>In the HTML generated by phpDocumentor, will be shown as:</p>
  
  <pre><code>Add a new &amp;lt;link&amp;gt; to the &amp;lt;head&amp;gt; of the document.
  </code></pre>
  
  <p>But in the NetBeans IDE it will be shown as:</p>
  
  <pre><code>Add a new &lt;link&gt; to the &lt;head&gt; of the document.
  </code></pre>
  
  <p>Which one is right? What is the correct way to embed special HTML characters in your phpDocumentor comments?</p>