updated doc blocks, removed dead code

hi,

i updated  the doc blocks of all classes in the lib folder and removed some "return FALSE" after an exception is thrown.

best regards