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

["Peter Ivanov (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/MJAVADOC-602?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17382180#comment-17382180 ] 

Peter Ivanov edited comment on MJAVADOC-602 at 7/16/21, 4:09 PM:
-----------------------------------------------------------------

[~famod], do you know the way to use new javadoc plugin with just {{mvn javadoc:aggregate}} command and proper settings in pom.xml or in command line?

I too can't make javadoc plugin to make aggregate report from root module...


was (Author: vveider):
[~famod], do you know the way to use new javadoc plugin with just {{mvn javadoc:aggregate}} command and proper settings in pom.xml or in command line?

> "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
>            Assignee: Robert Scholte
>            Priority: Major
>         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:
>  !javadoc-aggregation-doc-formatting.PNG!
> 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
(v8.3.4#803005)