fix an important omission from the docs