added better handling of parameter assignment and updated the documentation