Reformat a segment of JavaDoc text as either a CDATA section (if it
contains embedded HTML tags) or a simple text node. This also replaces
line breaks with single spaces, so that the output format will not use
indenting based on the original supplied text.
Parameters: jdoc - raw JavaDoc text formatted text