I'm unsure if our doc tool likes @public directives in the middle of a /** documentation block. I've usually seen it with the directive preceding the comment.