added returned parameters to documentation.