restructure (again) the section on parameters
improve error messagess