doco fixup & change defaults: abs not rel