The JAXB doclet generates documentation for your XML schema based on JAXB annotations and JavaDoc comments on your JAXB classes.
JavaDoc is read either on the JAXB properties (getter methods or fields), or their interface (only for the getters) as well as on the JAXB classes.
Since the JAX-RS supports links to JAXB documentation, you should first run the JAXB doclet, then
the JAX-RS doclet using the -link parameter.