apache / apache/maven-javadoc-plugin

[MJAVADOC-649] javadoc:aggregate mis-determines whether a submodule was skipped

Open
#1,003 0 comments 0 reactions 0 assignees View on GitHub
bug priority:major
Dominant language
Java
Stars
107
Forks
116
Avg merge
1d 10h
Merged PRs (30d)
16

Description

**[Robert Varga](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=nite)** opened **[MJAVADOC-649](https://issues.apache.org/jira/browse/MJAVADOC-649?redirect=false)** and commented

The fix for MJAVADOC-613 ends up mis-detecting when a submodule is being skipped in case there is an interplay between command-line and profile activation.

In OpenDaylight we have a setup, where we have a profile doing roughly:

```java

q

true


```

this profile is defined for each and every artifact we build.

We then have a job dedicated to extraction of javadoc which does:

```
mvn verify javadoc:aggregate -e -Pq -Dmaven.javadoc.skip=false
```

This works perfectly well with maven-javadoc-plugin-3.1.1, but breaks with 3.2.0: while each submodule generates its javadoc correctly (observing the command-line override of the profile), the aggregate goal ends up skipping all submodules, resulting in no aggregate being generated.

 

 

---

**Affects:** 3.2.0

**Issue Links:**
- [MJAVADOC-613](https://issues.apache.org/jira/browse/MJAVADOC-613) Exclude some modules with aggregate goals
(_**"is caused by"**_)

Contributor guide

No contributing guide indexed for this repository

Research direction

Reproduce the reported command, `mvn verify javadoc:aggregate -e -Pq -Dmaven.javadoc.skip=false`, using the profile setup and compare behavior between plugin versions 3.1.1 and 3.2.0. Trace the `javadoc:aggregate` handling of submodule skip status; done means the command-line override is honored and an aggregate Javadoc is generated for the eligible submodules.

Written by the indexing model from the issue text.

Assessment

Tech stack
java
Domain
build-system
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.