title: How to write Javadoc of properties?
body: <p>I often find myself with a dilemma when writing javadoc for properties/members of a "simple" POJO class holding only properties and getters and setters (DTO-style)....</p>
  
  <p>1) Write javadoc for the property<br>
  or...<br>
  2) Write javadoc for the getter  </p>
  
  <p>If I write javadoc for the property, my IDE (Eclipse) will (naturally) not be able to display this when I later access the POJO via code completion. And there is no standard javadoc tag that lets me link the getter-javadoc to the actual property javadoc.</p>
  
  <p>An example:</p>
  
  <pre><code>public class SomeDomainClass {
  
    /**
     * The name of bla bla bla
     */
    private String name;
  
    /**
     * @return INSERT SOME SMART JAVADOC TAG LINKING TO name's javadoc
     */
    public String getName() {  
      return name;  
    }  
  </code></pre>
  
  <p>So, basically it would be interesting to hear how others go about for having your Eclipse IDE display the javadoc property description for your getters - without having to duplicate the javadoc comment.</p>
  
  <p>As of now I'm considering making my practise to only document the getters and not the properties. But it doesn't seem like the best solution...</p>