जावाडोक का उपयोग कैसे करें: बहु-मॉड्यूल मेवेन प्रोजेक्ट में कुल मिलाकर ठीक से?

Question

यह एक बहु-मॉड्यूल प्रोजेक्ट में मेरी मूल pom.xml फ़ाइल (इसका हिस्सा) है:

... 
<build> 
    <plugins> 
     <plugin> 
      <groupId>org.apache.maven.plugins</groupId> 
      <artifactId>maven-javadoc-plugin</artifactId> 
     </plugin> 
    </plugins> 
</build> 
... 

यह प्लगइन सभी उप-मॉड्यूल में विरासत में मिला है और मुझे नहीं लगता कि यह एक सही दृष्टिकोण है। जब मैं mvn javadoc:aggregate चला रहा हूं तो दस्तावेज़ target/site/apidoc में जेनरेट किया गया है, लेकिन लॉग चेतावनियों से भरा है:

... 
[WARNING] Removing: aggregate from forked lifecycle, 
to prevent recursive invocation. 
... 

मैं गलत क्या कर रहा हूं?

Answer 1

आप इस प्लगइन के लिए एकत्रीकरण सक्षम करने की आवश्यकता

mvn javadoc:aggregate 

संपादित करें:

ठीक है, मैं कुछ Maven प्लगइन का jira की खुदाई की और पाया किया कि सभी javadoc प्लगइन mojos @aggregator के साथ एनोटेट किया गया है। लेकिन वहाँ Maven के एग्रीगेटर मुद्दा है जिसके लिए here

वहाँ भी संबंधित हैं कीड़े here और here और दायर की गई है के साथ समस्याओं होने लगते हैं कुछ और

यह Maven के एग्रीगेटर के साथ एक अवरोधक मुद्दा हो रहा है जैसे कुछ प्लग-इन के बाद से जैसे क्लॉयर भाग नहीं होगा।

संक्षेप में प्रस्तुत करने के लिए, आप कुछ भी गलत नहीं कर रहे हैं

बस Maven-जावाडोक-प्लगइन के पुराने संस्करणों कि @aggregator मोजो एनोटेशन का उपयोग नहीं करता है और आप चेतावनी नहीं मिलेगा में वापस स्विच (जब तक आप कर रहे हैं javadoc प्लगइन की कुछ विशेषताओं का उपयोग करना जो पिछले संस्करण में उपलब्ध नहीं है)

एक तरफ ध्यान दें, यदि आप रिपोर्ट के रूप में javadoc प्लगइन चलाते हैं तो @aggregator को अनदेखा किया जाता है।