Dave came up with a solution to this: http://www.powertrip.co.za/livedocs/viewpatch.php?patch=6
The questions remain, though: is html_entity_decode broken? should we be using ' in the docs at all?
I don't think there is any need to use ' at all.
Goba