Konrad Windszus created MNG-7609:
------------------------------------
Summary: Clarify documentation of extension descriptor
Key: MNG-7609
URL: https://issues.apache.org/jira/browse/MNG-7609
Project: Maven
Issue Type: Improvement
Components: Core
Reporter: Konrad Windszus
The extension descriptor is documented in
https://maven.apache.org/ref/3-LATEST/maven-core/extension.html based on the
MDO file at
https://github.com/apache/maven/blob/master/maven-core/src/main/mdo/extension.mdo.
It is lacking important information such as
- how are subpackages and wildcards handled in {{exportedPackages}}?
- how can one export individual classes via {{exportedPackages}} (compare with
https://github.com/apache/maven/blob/c6ecff9923088d854d4621e17d602f1c70dda806/maven-core/src/main/mdo/extension.mdo#L50)
- how are {{exportedPackages}} and {{exportedArtifacts}} related? Are they just
merged or are they combined in some other way?
The better extension descriptor documentation should finally be linked also
from
https://github.com/apache/maven/blob/master/maven-core/src/site/apt/core-extensions.apt.vm,
as well as from
https://maven.apache.org/guides/mini/guide-maven-classloading.html#API_Classloader
and https://maven.apache.org/guides/mini/guide-using-extensions.html
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
