We should add this to all the Cartesian types and to CHANGES.md.  Sorry, I guess I wasn't clear enough.  An `@example` would be good to.

All this is pretty standard every time I add something to these types.