XCM emulator docs and examples

[xlc]

Right now it have pretty much no docs and many small issues, which can be discovered if someone is trying to use it to create a simple example. I have fixed all the issues I discovered myself with #2985

[NachoPal]

@xlc You are right, good documentation is needed. Since it was still under some heavy development/improvement, we didn't find time for it yet.

A developers guide will be created.