names of remote entity properties clash with Entity API metadata properties

There's no way to fix this without breaking the API, so I'm filing this as a documentation issue.

For 2.x, this needs to be changed to using a compound property, so it's $wrapper->remote->foo->value() rather than $wrapper->foo->value(), and so the clash is avoided.