JDK21: error: invalid flag: -basePackage

[manticore-projects]

error: invalid flag: -basePackage

[manoelcampos]

This parameter is not being used anywhere. I don't know what it is expected to do since the docs don't make it clear.

[manticore-projects]

This parameter is not being used anywhere. I don't know what it is expected to do since the docs don't make it clear.

It is used to trim the package names in the generated output, e.g. to translate com.manticore.tools.xml-doclet.* to xml-doclet.* when setting -basePackage "com.manticore.tools".
Also, please lets use com.manticore instead of com.manticoreprojects because this is the maven registration -- and we have enough name chaos already around this package.

In my projects, the Doclet call looks like:

tasks.register('xmldoc', Javadoc) {
    
    source = sourceSets.main.allJava
    // beware: Gradle deletes this folder automatically and there is no switch-off
    destinationDir = reporting.file("xmlDoclet")
    options.docletpath = configurations.xmlDoclet.files as List
    options.doclet = "com.github.markusbernhardt.xmldoclet.XmlDoclet"
    title = "API $version"
    options.addBooleanOption("rst", true)
    options.addBooleanOption("withFloatingToc", Boolean.parseBoolean(System.getenv().getOrDefault("FLOATING_TOC", "true")))
    options.addStringOption("basePackage", "net.sf.jsqlparser")
    options.addStringOption("filename", outFile.getName())

}

Here is a good illustration: https://manticore-projects.com/XMLDoclet/javadoc.html
You can see, that output is left-trimmed by basePackage.

[manoelcampos]

It is used to trim the package names in the generated output, e.g. to translate com.manticore.tools.xml-doclet.* to xml-doclet.* when setting -basePackage "com.manticore.tools".

I see. Thanks.

Also, please lets use com.manticore instead of com.manticoreprojects because this is the maven registration -- and we have enough name chaos already around this package.

Sure. I’ll change it latter today.

[manticore-projects]

Everything I have tested so far is working just fine. Lets see what the real world will say after release.