You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by vs...@apache.org on 2007/05/17 13:12:09 UTC
svn commit: r538873 -
/maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml
Author: vsiveton
Date: Thu May 17 04:12:09 2007
New Revision: 538873
URL: http://svn.apache.org/viewvc?view=rev&rev=538873
Log:
MJAVADOC-75: Document how to deploy javadoc jars
o added a FAQ
Modified:
maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml
Modified: maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml?view=diff&rev=538873&r1=538872&r2=538873
==============================================================================
--- maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml (original)
+++ maven/plugins/trunk/maven-javadoc-plugin/src/site/fml/faq.fml Thu May 17 04:12:09 2007
@@ -101,5 +101,53 @@
</p>
</answer>
</faq>
+ <faq id="How to deploy javadoc jar">
+ <question>How to deploy javadoc jar?</question>
+ <answer>
+ <p>
+ Basically, you need to call <i>mvn clean javadoc:jar deploy</i>. If you want to include the javadoc jar
+ in a release process, you need to attach it in the release profile, for instance:
+ <source>
+<project>
+ ...
+ <profiles>
+ <profile>
+ <id>release</id>
+ <build>
+ <plugins>
+ <plugin>
+ <groupId>org.apache.maven.plugins</groupId>
+ <artifactId>maven-javadoc-plugin</artifactId>
+ <executions>
+ <execution>
+ <id>attach-javadocs</id>
+ <goals>
+ <goal>jar</goal>
+ </goals>
+ </execution>
+ </executions>
+ </plugin>
+ </plugins>
+ </build>
+ </profile>
+ </profiles>
+ ...
+</project></source>
+ </p>
+ <p>
+ To deploy the Javadoc jar on a given Maven repository, you could call:
+ <source>
+mvn deploy:deploy-file \
+ -DgroupId=<group-id> \
+ -DartifactId=<artifact-id> \
+ -Dversion=<version> \
+ -Dfile=<path-to-file> \
+ -Dpackaging=jar \
+ -DrepositoryId=<repository-id> \
+ -Durl=dav:http://www.myrepository.com/m2 \
+ -Dclassifier=javadoc</source>
+ </p>
+ </answer>
+ </faq>
</part>
</faqs>