Update ReadMe

Multiple fixes in documentation. Also some new features added.

Please search for my questions marked with (??? ... ???) and try to answer them. I can't catch you online in IRC lately :(