add docs for .throw() additions