API documentation - Please don't use illegal HTML in comments like "L&F"

[Dalibor Topic]

Chris Burdess wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> Mark Wielaard wrote:
> 
>> Please avoid using illegal HTML in comments.
>> gjdoc currently doesn't handle that very well.
>>
>> Obviously we should fix gjdoc (or actually libxmlj it seems) but in the
>> meantime please avoid using non-XHTML in comments.
> 
> 
> Regarding "fixing" libxmlj: I've considered adding HTML parsing support 
> with implementations for the HTML DOM, however there is absolutely no 
> facility in JAXP as far as I can see to declare that an input source is 
> intended to be HTML (or anything other than XML). I haven't seen support 
> for parsing HTML in any other JAXP parser either.

I think XHTML is fine, I believe Mark was just having trouble with gjdoc 
crashing because of occurences of 'L&F' in javadocs :)

cheers,
dalibor topic