3 ms·
From the JavaDoc docs[0] under the heading “Write comments in HTML”: > The text must be written in HTML with HTML entities and HTML tags. You can use whichever
by jonhohle 3y ago
From the JavaDoc docs[0] under the heading “Write comments in HTML”:
> The text must be written in HTML with HTML entities and HTML tags. You can use whichever version of HTML your browser supports.
0 - https://docs.oracle.com/javase/8/docs/technotes/tools/windows/javadoc.html https://docs.oracle.com/javase/8/docs/technotes/tools/window...
- brabel 3y agoOk, I admit I probably read this a long time ago and didn't bother to ever check as I never see anything very advanced in HTML used in Javadocs... But if you're going to link to the docs, at least link to the modern Java Documentation, not some ancient Java 8 version of the javadoc tool: https://www.oracle.com/technical-resources/articles/java/javadoc-tool.html https://www.oracle.com/technical-resources/articles/java/jav...
- jonhohle 3y agoThat was the first Oracle link that appeared in search results for me. I think it’s probably more relevant to go backwards however. Javadoc 1.2, for example, has the same quote I originally included - https://web.archive.org/web/20010129031800/http://java.sun.com/products/jdk/1.2/docs/tooldocs/solaris/javadoc.html#examples https://web.archive.org/web/20010129031800/http://java.sun.c...
- brabel 3y agoI think I "learned" that from StackOverflow... the top answer does say the same thing I was saying: "Javadoc permits only a subset of HTML tags." https://stackoverflow.com/questions/16481230/allowed-html-tags-in-javadoc https://stackoverflow.com/questions/16481230/allowed-html-ta...