added various documentation

* extended README.md
* added MANUAL.md
* extended phpdoc comments
Merge branch 'doc'