[jira] [Created] (MJAVADOC-602) "Aggregating Javadocs For Multi-Projects" code snippet is garbled and tag example is missing

["Falko Modler (JIRA)" <ji...@apache.org>]

Falko Modler created MJAVADOC-602:
-------------------------------------

             Summary: "Aggregating Javadocs For Multi-Projects" code snippet is garbled and <build/> tag example is missing
                 Key: MJAVADOC-602
                 URL: https://issues.apache.org/jira/browse/MJAVADOC-602
             Project: Maven Javadoc Plugin
          Issue Type: Bug
    Affects Versions: 3.1.0
            Reporter: Falko Modler
         Attachments: javadoc-aggregation-doc-formatting.PNG

After MJAVADOC-134, I was trying to find out how to migrate my working 2.10.4 aggregation setup to 3.1.0.

It seems [the respective documentation|https://maven.apache.org/plugins/maven-javadoc-plugin/examples/aggregate.html] was extended with the info of [this JIRA comment|https://issues.apache.org/jira/browse/MJAVADOC-134?focusedCommentId=16724514&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-16724514], but something went wrong with the formatting:
TODO

The other issue is that this bit doesn't cover the {{<build/>}} tag approach so I was fiddling around with this and ended up with:
{code:xml}
           <build>
                <plugins>
                    <plugin>
                        <groupId>org.apache.maven.plugins</groupId>
                        <artifactId>maven-javadoc-plugin</artifactId>
                        <configuration>
                            <skip>true</skip>
                        </configuration>
                        <executions>
                            <execution>
                                <id>aggregate-javadoc</id>
                                <goals>
                                    <goal>aggregate-no-fork</goal>
                                </goals>
                                <inherited>false</inherited>
                                <configuration>
                                    <skip>false</skip>
                                    <!- ... -->
                                </configuration>
                            </execution>
                        </executions>
                    </plugin>
                    <!- ... -->
{code}
Notes: {{mvn -N ...}} does not work, but I don't want a separate aggregation for each module. So I skip the plugin in general/for all modules by _not_ inheriting {{<skip>false</skip>}}.

This (or some better solution) should be added to the docs.

PS: A flag/property to just skip the individual aggregations per module would be very much appreciated!



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