update docs to reflect reality (bug 867841)