fix doc: raising exception instead of returning false