added params to doc comments