Doc clarifications.  Minor addition to API.