If `result` is now required, the `@returns` doc on these methods should be updated to take out the "new instance if one was not provided" part.  Same throughout.