title: alternative for Javadoc?
body: <p>I have been using Java for years I really like the language except javadoc.
  The document generated by javadoc makes me feel I am browsing web in 1990s. To make some beauty doc you have to insert obscure html tags which make your comments almost unreadable before generating html file.</p>
  
  <p>I am seeking some alternative for javadoc, reStructuredText is my first choice but there is no doclet for it. Another choice is markdown, but it mainly aims to html so I treat it as my last resort if I can't figure out any other way.</p>
  
  <p>I am also considering split comment from java file, but it bothers developers who browse code in IDE.</p>
  
  <p>Any good ideas?</p>