Documentation.  Also, added for_update and nowait flags to find_by