doco fixup & change defaults: abs not rel
Merge pull request #5 from wwood/master

doco fixup & change defaults: abs not rel