documented options and internals