[GROOVY-10689] Groovydoc for Groovy 3+ documents classes at too early a phase of compilation

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.0.4
• Assignee: Paul King
• Reporter: Paul King
• Created: 18/Jul/22 11:45
• Updated: 23/Jul/22 21:05
• Resolved: 19/Jul/22 10:59

Description

Groovydoc currently compiles to the CONVERSION phase of the compiler before running the GroovydocVisitor. The visitor adds in some of the information that would appear in later phases but far from all. That phase was selected to align with earlier versions of the tool which don't require all mentioned classes to be in the classpath during groovydoc execution.

This improvement will move the processing to a later phase (which will require more classes on the classpath) but provide a system property so that the phase can be dialed back if needed for folks where the classpath requirement imposes too great a burden. This improvement will be targeted initially only at Groovy 4+.

Issue Links

• links to: GitHub Pull Request #1749