Agreed, we want to keep them in the Javadoc. An interesting side quest would be to investigate switching to the latest version of JavaCC or switching to Antlr.
Gary On Mon, Jul 4, 2022, 10:38 Matt Juntunen <matt.a.juntu...@gmail.com> wrote: > Hello Alex, > > That would remove those files from the javadoc completely. As of now, > the generated files are included in the javadoc [1]. These files are > part of the public API (per previous releases) so I don't believe we > would want them undocumented. > > Regards, > Matt J > > [1] > https://commons.apache.org/proper/commons-configuration/apidocs/index.html > > On Mon, Jul 4, 2022 at 3:14 AM Alex Herbert <alex.d.herb...@gmail.com> > wrote: > > > > On Mon, 4 Jul 2022 at 03:41, Matt Juntunen <matt.a.juntu...@gmail.com> > > wrote: > > > > > I'm not sure what to do > > > about the javadoc warnings on the generated classes. From the comments > > > in the pom, this seems to have been an issue since v2.4. > > > > > > > <sourceFileExcludes> > > <sourceFileExclude>**/generated/*.java</sourceFileExclude> > > </sourceFileExcludes> > > > > Or whatever path is suitable [1]. > > > > Alex > > > > [1] > > > https://maven.apache.org/plugins/maven-javadoc-plugin/javadoc-mojo.html#sourceFileExcludes > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > >
