title: What's the correct way to include an email within Javadoc?
body: <p>I like to put my email address within <code>@author</code> tags and would like them to be clickable <code>mailto:</code> links in the generated Javadoc.</p>
  
  <p>How should I go about doing this correctly?</p>
  
  <pre><code>/**
   * I currently do the following, but would like to have my name 
   * displayed as the link rather than the email itself.
   *
   * @author {@link "mailto:my_email@email.example.com"}
   */
  public class Useless { }
  </code></pre>
  
  <hr>
  
  <pre><code>/**
   * I've tried this, but get warnings about unexpexted text where my name is.
   *
   * @author {@link "mailto:my_email@email.example.com" "Benoit St-Pierre"}
   */
  public class Useless { }
  </code></pre>