title: Is there really no better way to document perl code than POD?
body: <p>I'm a Perl programmer for a long time, but I always have problems with documentation in POD. </p>
  
  <p>When I use POD comments in the code, the code is difficult to read. When I use POD comments at the end of file, there is the danger that the documentation is not in sync with the code.</p>
  
  <p>I miss a documentation style similar to Java.</p>
  
  <pre><code>/**
   * @description
   * ...
   */
  </code></pre>
  
  <p>I look for an easier and more intuitive documentation style. Is there such a thing?</p>