[lang] uses the first. [collections] uses the second.
I prefer the second as IMHO it is more readable when you are browsing the source code. And I definitely read the javadoc in source code form more than I read it in html form.
Stephen
----- Original Message ----- From: "Simon Kitching" <[EMAIL PROTECTED]>
I have seen two basic approaches to applying formatting to javadoc text in source files:
(a) XHTML-style /** *<p>This is the first paragraph.</p> * *<p>And this is the second.</p> */
(b) HTML-style /** * This is the first paragraph. * <p> * And this is the second. */
I would certainly like to pick one or the other for Digester2. What conventions have other commons projects adopted? Are there any good reasons to pick one over the other?
Thanks,
Simon
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]