Re: API documentation - Please don't use illegal HTML in commentslike "L&F"

[Dalibor Topic <robilad at kaffe dot org>]

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