title: Is there a way to avoid documentation duplication when documenting setters/getters, properties and constructors in JavaDoc?
body: <p>I really like well documented code. But there are lots of duplications in the documentation, since the basic information and examples should be available for the properties, the setters/getters and in constructors (also see <a href="https://stackoverflow.com/questions/1028967/simple-getter-setter-comments">Simple Getter/Setter comments</a>).</p>
  
  <p>Is there a way to avoid duplication of JavaDocs? The only idea I had is using <code>{@link #function()}</code> and link to a part in the JavaDocs that contains more information.</p>
  
  <p>Here is an imaginary example:</p>
  
  <pre><code>package com.stackoverflow.tests;
  
  /**
   * An Event ...
   */
  public class Event {
  
    /**
     * The date the event takes place.
     * Needs to be in &lt;a href="https://en.wikipedia.org/wiki/ISO_8601"&gt;ISO 8601&lt;/a&gt; format.
     * 
     * &lt;h2&gt;Examples:&lt;/h2&gt;
     * &lt;ul&gt;
     *   &lt;li&gt;{@code 2016-03-19}&lt;/li&gt;
     *   &lt;li&gt;{@code 2016-03-19T05:54:01+00:00}&lt;/li&gt;
     *   &lt;li&gt;{@code 2016-W11} - i.e. week 11 of 2016&lt;/li&gt;
     * &lt;/ul&gt;
     */
    private String date;
  
    /**
     * Creates an event initializing it with the date and location the event takes place.
     * @param date
     *   Date in &lt;a href="https://en.wikipedia.org/wiki/ISO_8601"&gt;ISO 8601&lt;/a&gt; format. Examples:
     *   &lt;ul&gt;
     *     &lt;li&gt;{@code 2016-03-19}&lt;/li&gt;
     *     &lt;li&gt;{@code 2016-03-19T05:54:01+00:00}&lt;/li&gt;
     *     &lt;li&gt;{@code 2016-W11} - i.e. week 11 of 2016&lt;/li&gt;
     *   &lt;/ul&gt;
     * @param location
     *   Location ...
     */
    public Event(final String date, final String location) {
      this.date = date;
    }
  
    /**
     * The date the event takes place.
     * @return
     *   Date in &lt;a href="https://en.wikipedia.org/wiki/ISO_8601"&gt;ISO 8601&lt;/a&gt; format.
     */
    public String getDate() {
      return date;
    }
  
    /**
     * Updates the date the event takes place using an ISO 8601 formatted String.
     * @param date
     *   Date in &lt;a href="https://en.wikipedia.org/wiki/ISO_8601"&gt;ISO 8601&lt;/a&gt; format. Examples:
     *   &lt;ul&gt;
     *     &lt;li&gt;{@code 2016-03-19}&lt;/li&gt;
     *     &lt;li&gt;{@code 2016-03-19T05:54:01+00:00}&lt;/li&gt;
     *     &lt;li&gt;{@code 2016-W11} - i.e. week 11 of 2016&lt;/li&gt;
     *   &lt;/ul&gt;
     */
    public void setDate(String date) {
      this.date = date;
    }
  
  }
  </code></pre>