fixed typo in reference to irreal; completed readme with infos on how to
use this for reference