Given that CommandLine.Option and other annotations carry so much weight for documenting usage and semantics, this leaves a gap in actual javadoc without duplicity.

Since Javadoc is in scope for annotation processors, and code generation is available, it would be nice to have the option to generate versions of annotated classes which the default xdoclet could use to extract details.
Thus, javadoc users would be able to see everything in one place, with appropriate attribution that some details came from picocli annotations.

This could be enabled with an additional property on existing annotations, or with a separate annotation on the class element.