You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@maven.apache.org by "Konrad Windszus (Jira)" <ji...@apache.org> on 2022/11/29 19:36:00 UTC
[jira] [Comment Edited] (MNG-7609) Clarify documentation of extension descriptor
[ https://issues.apache.org/jira/browse/MNG-7609?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17640892#comment-17640892 ]
Konrad Windszus edited comment on MNG-7609 at 11/29/22 7:35 PM:
----------------------------------------------------------------
The descriptor is read in https://github.com/apache/maven/blob/master/maven-core/src/main/java/org/apache/maven/project/ExtensionDescriptorBuilder.java and evaluated in https://github.com/apache/maven/blob/c6ecff9923088d854d4621e17d602f1c70dda806/maven-core/src/main/java/org/apache/maven/extension/internal/CoreExtensionEntry.java#L88
The exportedPackages format is used by Plexus Classworlds {{importFrom}}.
was (Author: kwin):
The descriptor is read in https://github.com/apache/maven/blob/master/maven-core/src/main/java/org/apache/maven/project/ExtensionDescriptorBuilder.java and evaluated in https://github.com/apache/maven/blob/c6ecff9923088d854d4621e17d602f1c70dda806/maven-core/src/main/java/org/apache/maven/extension/internal/CoreExtensionEntry.java#L88
> 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
> Priority: Major
>
> 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)