added various documentation

* extended README.md
* added MANUAL.md
* extended phpdoc comments