add docs for throw
add examples