maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Thorsten Glaser (JIRA)" <j...@apache.org>
Subject [jira] [Created] (MJAVADOC-523) Exclude non-Java JARs from Maven Javadoc plugin processing
Date Fri, 13 Apr 2018 19:10:00 GMT
Thorsten Glaser created MJAVADOC-523:
----------------------------------------

             Summary: Exclude non-Java JARs from Maven Javadoc plugin processing
                 Key: MJAVADOC-523
                 URL: https://issues.apache.org/jira/browse/MJAVADOC-523
             Project: Maven Javadoc Plugin
          Issue Type: Bug
          Components: javadoc
    Affects Versions: 2.8
            Reporter: Thorsten Glaser


I have a multi-module project which builds a couple of JARs and then distributed them into
two WARs.

However, one of the JARs does not contain any Java code at all, merely (maven-filtered) resources.
This leads to warnings during the build like these:
{{[…]
[INFO] --- maven-javadoc-plugin:2.8:jar (attach-javadocs) @ foo-services ---
[INFO] The goal 'org.apache.maven.plugins:maven-javadoc-plugin:2.8:javadoc' has not been previously
called for the module: 'de.tarent.foo:foo-rsrcs:jar:1.3.900-SNAPSHOT'. Trying to invoke it...

[WARNING] Creating fake javadoc directory to prevent repeated invocations: /var/lib/jenkins/jobs/FooTool/workspace/foo-backend/foo-rsrcs/target/apidocs
[ERROR] Error fetching link: /var/lib/jenkins/jobs/FooTool/workspace/foo-backend/foo-rsrcs/target/apidocs/package-list.
Ignored it.

[INFO] 
Loading source files for package de.tarent.foo.rest.transformation...
[…]}}
I found how I can exclude javadoc stuff by package, but not by artifact.

The plugin is currently included ONLY in the parent POM, like this:
{{<plugin><groupId>org.apache.maven.plugins</groupId><artifactId>maven-javadoc-plugin</artifactId><version>2.8</version><executions><execution><id>attach-javadocs</id><goals><goal>jar</goal></goals></execution></executions></plugin>}}
While it _is_ run during “compilation” of the resources-only JAR, it (obviously) produces
no result, thus the warning (as it’s not excluded either).

How can I either make it produce something (i.e. the ability to create a valid-looking yet
contentless FOO-javadoc.jar that satisfies references by reverse dependencies, in a JAR not
containing any Java™ code) or, probably preferably, exclude the {{foo-rsrcs}} module from
being accessed by mjavadoc on modules depending on it?



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Mime
View raw message