Return-Path: Delivered-To: apmail-avalon-cvs-archive@www.apache.org Received: (qmail 22154 invoked from network); 21 Jun 2004 17:38:52 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 21 Jun 2004 17:38:51 -0000 Received: (qmail 68366 invoked by uid 500); 21 Jun 2004 17:39:04 -0000 Delivered-To: apmail-avalon-cvs-archive@avalon.apache.org Received: (qmail 68283 invoked by uid 500); 21 Jun 2004 17:39:03 -0000 Mailing-List: contact cvs-help@avalon.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Avalon CVS List" Reply-To: "Avalon Developers List" Delivered-To: mailing list cvs@avalon.apache.org Received: (qmail 68043 invoked by uid 99); 21 Jun 2004 17:39:01 -0000 Received: from [209.237.227.194] (HELO minotaur.apache.org) (209.237.227.194) by apache.org (qpsmtpd/0.27.1) with SMTP; Mon, 21 Jun 2004 10:39:01 -0700 Received: (qmail 21846 invoked by uid 65534); 21 Jun 2004 17:38:45 -0000 Date: 21 Jun 2004 17:38:45 -0000 Message-ID: <20040621173845.21842.qmail@minotaur.apache.org> From: mcconnell@apache.org To: cvs@avalon.apache.org Subject: svn commit: rev 21551 - avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Author: mcconnell Date: Mon Jun 21 10:38:44 2004 New Revision: 21551 Modified: avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/index.xml avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/javadoc.xml avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/publish.xml Log: more on publishing Modified: avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/index.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/index.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/index.xml Mon Jun 21 10:38:44 2004 @@ -9,6 +9,8 @@

+ Publication tasks deal with the generation of project document, + javadoc production, and publication into a common doc repository.

Modified: avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/javadoc.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/javadoc.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/javadoc.xml Mon Jun 21 10:38:44 2004 @@ -9,10 +9,50 @@

+ The javadoc task provides support for automatic generation of + consolidated javadoc taking into account the source directories of + dependent projects. If the target of javadoc generation supports + staged classloader defintions (API, SPI, IMPL) - then javadoc + will be generated for each set. The task supports local and remote + link declarations (see source for additional details).

+

+ The following declarations instruct the current build to invoke + javadoc generation on an identified project using the id attribute. + The title attribute sets the javadoc title. +

+ + + ]]> + +

Typical output of the javadoc task:

+
javadoc:
+[x:javadoc] Generating: Merlin Runtime, Version 3.3.0 : API
+[x:javadoc] link: http://java.sun.com/j2se/1.4/docs/api
+[x:javadoc] Adding src path: F:\dev\avalon\runtime\framework\api\target\build\main
+[x:javadoc] Adding src path: F:\dev\avalon\runtime\util\lifecycle\target\build\main
+  [javadoc] Generating Javadoc
+  [javadoc] Javadoc execution
+  [javadoc] Loading source files for package org.apache.avalon.framework...
+  [javadoc] Loading source files for package org.apache.avalon.framework.activity...
+  [javadoc] Loading source files for package org.apache.avalon.framework.configuration...
+  [javadoc] Loading source files for package org.apache.avalon.framework.context...
+  [javadoc] Loading source files for package org.apache.avalon.framework.logger...
+  [javadoc] Loading source files for package org.apache.avalon.framework.parameters...
+  [javadoc] Loading source files for package org.apache.avalon.framework.service...
+  [javadoc] Loading source files for package org.apache.avalon.framework.thread...
+  [javadoc] Loading source files for package org.apache.avalon.lifecycle...
+  [javadoc] Constructing Javadoc information...
+  [javadoc] Standard Doclet version 1.4.2_04
+  [javadoc] Building tree for all the packages and classes...
+  [javadoc] Building index for all the packages and classes...
+  [javadoc] Building index for all classes...
+
+  [javadoc] Generating F:\dev\avalon\central\system\.docs\avalon\runtime\3.3.0\api\stylesheet.css...
+
+  ....
Modified: avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/publish.xml ============================================================================== --- avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/publish.xml (original) +++ avalon/trunk/central/site/src/xdocs/central/tools/magic/tasks/publication/publish.xml Mon Jun 21 10:38:44 2004 @@ -7,12 +7,21 @@ -
+

+ The publish task copies documentation content from ${basedir}/target/docs + into the doc repository under the relative path [group]/[name]/[version]. + The relative path can be overriden using the path attribute as shown in + the following example of a project publishing into the root of the document + repository.

+ ]]> + +
site:
+     [copy] Copying 405 files to F:\dev\avalon\central\system\.docs
+
--------------------------------------------------------------------- To unsubscribe, e-mail: cvs-unsubscribe@avalon.apache.org For additional commands, e-mail: cvs-help@avalon.apache.org