[Xcb] [PATCH] Fill in some TODO bits for CreateWindow & InternAtom

Josh Triplett josh at joshtriplett.org
Wed Nov 30 14:06:23 PST 2011

On Wed, Nov 30, 2011 at 09:10:23PM +0000, Michael Stapelberg wrote:
> Excerpts from Peter Harris's message of 2011-11-30 14:03:32 +0000:
> > (or similar)? That way, in theory, the other language bindings can
> > generate their own mangled name of choice for their docs. It means
> > giving up on CDATA in most places, but I don't see any < or & used
> > outside of the examples. (Inside of the examples[1], they're clearly in
> > C anyway, so CDATA and libxcb mangled names are fine).
> I am aware of the problem and in a few cases I’ve suffixed (TODO) to the places
> where I’ve used mangled names. To highlight words in the CDATA, the convention
> `foo` is used at the moment. I will look into mangling appropriately (depending
> on the context) automatically or with a different convention. Using more XML to
> solve this is something I’d like to avoid, though :).

In the middle of an XML document, XML seems like the right format to
use.  I don't think it makes sense to introducing additional non-XML
markup in a text field of an XML document.

- Josh Triplett

More information about the Xcb mailing list