The JAX-RS doclet generates documentation for your RESTful service based on JAX-RS annotations and JavaDoc comments on your JAX-RS resource methods.
JavaDoc is read either on the JAX-RS resource methods, or their interface. Only method-level
JavaDoc is used. Documentation for a given RESTful URL is taken from the method annotated with @GET,
@HEAD, @POST, @PUT or @DELETE
for that URL (in order of preference).
JAX-RS resource locators are supported.
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.