doc clarification; bug report