Fix name of update_aliases in docs.
Document methods in alphabetical order.
Tersen a docstring.
Declare what exceptions are raised by a couple routines.