Improve documentation.

This is in response to a question on the mailing list.