more doxy
throws exceptions