Hi Ryan, all,
> What does "but on output they MAY be changed into normal escaped content" mean?
> Can it mean using inline tags? E.g.
> <source>no text <![CDATA[this is <pc dataRefEnd="d2" dataRefStart="d1"
> id="tag1">my cdata</pc>]]></source>
No. Not at all.
> Or is that not recommended and it means using entities? e.g.
>
> <source>no text <![CDATA[this is <b>my cdata≶/b<]]></source>
Yes, but it's not a CDATA section anymore, so the CDATA marker should not be there.
> I'm assuming since it says MAY, that it is also valid to not escape it at all:
>
> <source><![CDATA[this is <b>my cdata</b>]]></source>
Yes.
In summary, it means you can output:
a) like the original (preserve the CDATA notation):
<source><![CDATA[this is <b>my cdata</b>]]></source>
b) use the normal content notation, and in that case, any XML meta character (like <, or &) would be escaped:
<source>this is <b>my cdata</b></source>
Or, if you want to alo escape > to >:
<source>this is <b>my cdata</b></source>
Those three notations result in the exact same parsed string: "this is <b>my cdata</b>", which is what you had in input.
I hope this helps,
-yves