updated phpdoc and documentation slightly
minor cosmetics fix