Probably worth taking the opportunity to add yardocs to this method now. Esp. curious about what the options hash accepts.