issue #433 doc clarification