Fix Version/s: 13
Compatibility Risk Description:This is a new feature being added; it is highly unlikely that there is any existing conflicting usage of such configuration files.
Interface Kind:add/remove/modify command line option, File or wire format
Provide the ability to automatically load taglets from a jar file.
Users have asked to be able to put multiple taglets in a single jar file and to have the
javadoc tool load them automatically, rather than having to call out each taglet separately
-taglet command-line option.
Support the use of a standard service-provider configuration file in jar files found on the taglet path.
Within the javadoc tool, the
TagletManager class will use
class to automatically load all the taglet classes specified in the configuration file.
This behavior will be enabled when a jar file containing a suitable service-provider configuration file is found on the taglet path.
The file must be named
jdk.javadoc.doclet.Tagletand placed in the
META-INF/servicesdirectory in the jar file.
The file must contain the fully qualified name of each of the taglet implementation classes that are to be loaded automatically.
The taglet manager will load all the taglets specified in the serice-provider configuration file. There is no need to used the -taglet option for individual taglets specified in that file.