tweak docs to match current behavior