How do I generate and deploy a javadoc jar file for my project?
Author: Deron Eriksson
Description: This maven tutorial describes how to generate a javadoc jar file for a project using the maven-javadoc-plugin plugin.
Tutorial created using: Windows Vista || JDK 1.6.0_04 || Eclipse Web Tools Platform 2.0.1 (Eclipse 3.3.1)


Page: < 1 2

(Continued from page 1)

Now I'll build and deploy the aforementioned project jarW files to my ArchivaS repository via "mvn clean deploy".

Executing 'mvn clean deploy' on 'aproject'

The console output of "mvn clean deploy" is shown here:

Console output for 'mvn clean deploy' on 'aproject' project

[INFO] Scanning for projects...
WAGON_VERSION: 1.0-beta-2
[INFO] ------------------------------------------------------------------------
[INFO] Building aproject
[INFO]    task-segment: [clean, deploy]
[INFO] ------------------------------------------------------------------------
[INFO] [clean:clean]
[INFO] Deleting directory C:\dev\workspace\aproject\target
[INFO] [resources:resources]
[INFO] Using default encoding to copy filtered resources.
[INFO] [compiler:compile]
[INFO] Compiling 1 source file to C:\dev\workspace\aproject\target\classes
[INFO] [resources:testResources]
[INFO] Using default encoding to copy filtered resources.
[INFO] [compiler:testCompile]
[INFO] Compiling 1 source file to C:\dev\workspace\aproject\target\test-classes
[INFO] [surefire:test]
[INFO] Surefire report directory: C:\dev\workspace\aproject\target\surefire-reports

-------------------------------------------------------
 T E S T S
-------------------------------------------------------
Running com.maventest.AppTest
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0, Time elapsed: 0.038 sec

Results :

Tests run: 1, Failures: 0, Errors: 0, Skipped: 0

[INFO] [jar:jar]
[INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2.jar
[INFO] Preparing source:jar
[WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation.
[INFO] No goals needed for project - skipping
[INFO] [source:jar {execution: attach-sources}]
[INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2-sources.jar
[INFO] Preparing javadoc:jar
[INFO] ------------------------------------------------------------------------
[INFO] Building aproject
[INFO] ------------------------------------------------------------------------
[WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation.
[WARNING] Removing: jar from forked lifecycle, to prevent recursive invocation.
[INFO] No goals needed for project - skipping
[INFO] [javadoc:jar {execution: attach-javadocs}]
Loading source files for package com.maventest...
Constructing Javadoc information...
Standard Doclet version 1.6.0_04
Building tree for all the packages and classes...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\App.html...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-frame.html...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-summary.html...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-tree.html...
Generating C:/dev/workspace/aproject/target/apidocs\constant-values.html...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\class-use\App.html...
Generating C:/dev/workspace/aproject/target/apidocs\com/maventest/\package-use.html...
Building index for all the packages and classes...
Generating C:/dev/workspace/aproject/target/apidocs\overview-tree.html...
Generating C:/dev/workspace/aproject/target/apidocs\index-all.html...
Generating C:/dev/workspace/aproject/target/apidocs\deprecated-list.html...
Building index for all classes...
Generating C:/dev/workspace/aproject/target/apidocs\allclasses-frame.html...
Generating C:/dev/workspace/aproject/target/apidocs\allclasses-noframe.html...
Generating C:/dev/workspace/aproject/target/apidocs\index.html...
Generating C:/dev/workspace/aproject/target/apidocs\help-doc.html...
Generating C:/dev/workspace/aproject/target/apidocs\stylesheet.css...
[INFO] Building jar: C:\dev\workspace\aproject\target\aproject-1.2-javadoc.jar
[INFO] [install:install]
[INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2.jar
[INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2-sources.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2-sources.jar
[INFO] Installing C:\dev\workspace\aproject\target\aproject-1.2-javadoc.jar to \dev\m2repo\com\maventest\aproject\1.2\aproject-1.2-javadoc.jar
[INFO] [deploy:deploy]
altDeploymentRepository = null
Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2.jar
2446/?
[INFO] Retrieving previous metadata from archiva.internal
[INFO] Uploading project information for aproject 1.2
[INFO] Retrieving previous metadata from archiva.internal
[INFO] Uploading repository metadata for: 'artifact com.maventest:aproject'
Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2-sources.jar
770/?
Uploading: http://192.168.1.7:8081/archiva/repository/internal/com/maventest/aproject/1.2/aproject-1.2-javadoc.jar
4096/?
8192/?
12288/?
16384/?
20480/?
21036/?
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 10 seconds
[INFO] Finished at: Tue Feb 19 21:28:25 PST 2008
[INFO] Final Memory: 16M/28M
[INFO] ------------------------------------------------------------------------

If we examine the Archiva internal repository, we can see it now contains the jar artifact, the source jar, and the javadoc jar.

jar, source jar, and javadoc jar are present in Archiva repository
Page: < 1 2