Need to throw the new exceptions rather than leaving them to fall into the void

Pretty straightforward fix

Also took the liberty of fixing some docs for one of the methods.