some documentation improvements
removed 'source' option
tests