Follow-up r61021: added some documentation per Tim's request