I should have mentioned this, we don't document optional argument exceptions, it's implicit in the param markup already (and in the generated HTML).  You can remove any of the `xxx is required` `@exception`s you added.