ascopes commented on issue #1080: URL: https://github.com/apache/maven-plugin-tools/issues/1080#issuecomment-4072994136
I was thinking about this recently and wondered if one option to consider could be replacing the logic that scrapes Mojo classes with an annotation processor that hooks into the Java Compiler. It appears that the ProcessingEnvironment class within the annotation processing API can provide details on JavaDoc comments decorating annotations, and the Mojo classes themselves are already driven by annotations that could be hooked into. The `help` Mojo (in theory) could then be generated by collecting some JSON or XML blobs the AP emits that holds the details of each parameter in each Mojo. Since the Javac implementation also supports the new markdown-style comments (`/// foo`), this could open the ability to support that. This may also enable being able to generate docs for complex objects that have JavaDoc comments internally as well (at least, if they are in the same project), since that could be interrogated during compilation. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
