moar yarddoc - probably a few references in here to things that haven't yet been yarddoc-ified