minor changes in the documentation and the return parameter sets