documentation with emu

keeps in sync code comments and README.md