Fix: minors feedbacks of pmartin

phpdoc fix
more verbose exception