Update docs to reflect actual behaviour.