Cleanup PhpDoc comments

Cleanup the PhpDoc comments for the first files (more patches follow)…
Revert "Cleanup PhpDoc comments"

This reverts commit 2584d4f81892a9586c096ef271ce44de96d04d6c.
Revert "Remove many is_dir, substr calls"

This reverts commit f393d74355b62e748b0b65da86159320bfddd183.
Revert "change file_exists to is_file"

This reverts commit e9ba6216d8ce3539c5bde84653403db547fce625.
Revert "Performance Improvement (is_null, strlen)"

This reverts commit 6f32a69a816fefd8900773b3677103166e5e6d1d.
Revert "Fix invalid call of the Exception construct method"

This reverts commit 2b902eef3785fe97e7c9582329bd3808a701e5a0.
Recommit the documentation changes

This reverts commit 91895c2420133629787a75f57a566cc203eaf0cf.
General PhpDoc documentation of all methods

More PhpDoc cleanups will follow…
Merge pull request #150 from lochmueller/master

Fix invalid call of the Exception construct method & performance improvments
Merge pull request #151 from lochmueller/documentation

Documentation PhpDoc