enhance docu for overriding the defaults