* API Change - better error handling
* added [in] [out] to doxygen function comments