Comments are often an important part of source documents, they should be preserved by doxia transformations.
Handle SSI in xdoc
AbstractXmlParser should recognize CDATA, entities and comments
I updated the javadoc so do you think that the doc for sink api is enough?
What I meant is to add a method like
void comment( String text )
to the Sink interface that allows you to translate eg an apt comment
~~ a comment
into an xml comment:
<!-- a comment -->
This sounds like a good addition to the API. At least some of the generated formats supports comments, the others can just do nothing.
Done in r583267. Comments are implemented in Xdoc, Xhtml and Docbook parsers and sinks, and in AptSink. AptParser is still to do.