Update doc strings to better conform to jsDoc spec. Use Object instead o...

...f Hash, and place optional parameter names in parenthesis.