Return-Path: Delivered-To: apmail-maven-commits-archive@www.apache.org Received: (qmail 86710 invoked from network); 9 Jan 2008 20:11:36 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 9 Jan 2008 20:11:36 -0000 Received: (qmail 4988 invoked by uid 500); 9 Jan 2008 20:11:25 -0000 Delivered-To: apmail-maven-commits-archive@maven.apache.org Received: (qmail 4770 invoked by uid 500); 9 Jan 2008 20:11:24 -0000 Mailing-List: contact commits-help@maven.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@maven.apache.org Delivered-To: mailing list commits@maven.apache.org Received: (qmail 4757 invoked by uid 99); 9 Jan 2008 20:11:24 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Jan 2008 12:11:24 -0800 X-ASF-Spam-Status: No, hits=-99.1 required=10.0 tests=ALL_TRUSTED,NORMAL_HTTP_TO_IP,URIBL_RHS_DOB X-Spam-Check-By: apache.org Received: from [140.211.11.3] (HELO eris.apache.org) (140.211.11.3) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 09 Jan 2008 20:11:12 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 456211A9882; Wed, 9 Jan 2008 12:10:57 -0800 (PST) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Subject: svn commit: r610540 - /maven/site/trunk/src/site/apt/pom.apt Date: Wed, 09 Jan 2008 20:10:54 -0000 To: commits@maven.apache.org From: vsiveton@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20080109201057.456211A9882@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Author: vsiveton Date: Wed Jan 9 12:10:25 2008 New Revision: 610540 URL: http://svn.apache.org/viewvc?rev=610540&view=rev Log: MNG-2769: Use of POM namespace is confused and confusing in both the code and the documentation o fixed doc as suggested Modified: maven/site/trunk/src/site/apt/pom.apt Modified: maven/site/trunk/src/site/apt/pom.apt URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/pom.apt?rev=610540&r1=610539&r2=610540&view=diff ============================================================================== --- maven/site/trunk/src/site/apt/pom.apt (original) +++ maven/site/trunk/src/site/apt/pom.apt Wed Jan 9 12:10:25 2008 @@ -3,7 +3,7 @@ ----- Eric Redmond ----- - 3 September 2006 + January 2008 ----- POM Reference @@ -120,7 +120,10 @@ contains 4.0.0. That is currently the only supported POM version for Maven 2, and is always required. +--------------------------+ - + 4.0.0 @@ -174,8 +177,12 @@ <<>> file, where tasks are almost always dependant on the lines executed before it. +--------------------------+ - + 4.0.0 + org.codehaus.mojo my-project 1.0 @@ -227,7 +234,10 @@ <<>>. We could make it into a <<>> by declaring a different packaging: +-----------------+ - + ... war ... @@ -268,7 +278,10 @@ allowing your list to focus solely on the dependencies your project requires. +-----------------+ - + ... @@ -360,7 +373,10 @@ wish to use it or its dependencies, then we would add it as an <<>>. +-----------------------------+ - + ... @@ -392,8 +408,12 @@ extra step in making project inheritance explicit to the project object model. +-----------------------------+ - + 4.0.0 + org.codehaus.mojo my-parent 2.0 @@ -424,14 +444,19 @@ [] +-----------------------------+ - + 4.0.0 + org.codehaus.mojo my-parent 2.0 ../my-parent + my-project +-----------------------------+ @@ -586,11 +611,16 @@ directories to those projects. +-----------------------------+ - + 4.0.0 + org.codehaus.mojo my-parent 2.0 + my-project @@ -651,7 +681,11 @@ <<>> +-----------------------+ - + + ... ... @@ -719,7 +753,10 @@ to bundle the resource correctly, you would specify resources similar to the following: +------------------------------------------+ - + ... @@ -778,7 +815,10 @@ *** {Plugins} +------------------------------------------+ - + ... @@ -838,7 +878,10 @@ You would get an <<>> like this: +------------------------------------------+ - + ... @@ -900,7 +943,11 @@ [] +------------------------------------------+ - + + ... ... @@ -935,7 +982,11 @@ So rather than the above mess included in every child <<>>, only the following is required: +------------------------------------------+ - + + ... ... @@ -962,7 +1013,11 @@ for the POM as a whole. Since they do not exist in profile builds, these cannot be altered by profiles. +------------------------------------------+ - + + ... ${basedir}/src/main/java ${basedir}/src/main/scripts @@ -988,7 +1043,11 @@ are excellent for specifying one out of multiple implementations of a common plugin interface. +------------------------------------------+ - + + ... ... @@ -1023,7 +1082,10 @@ also be suppressed in the following, more verbose, way, which effectively turns off project-info reports. +------------------------------------------+ - + ... @@ -1056,7 +1118,10 @@ children, and set <<>> to true. The <<>> would resemble the following: +------------------------------------------+ - + ... @@ -1144,7 +1209,10 @@ where the most basic information is set. +-------------------------+ - + ... Codehaus Mojo @@ -1164,7 +1232,10 @@ should not be contacted about the project, they need not be listed here. +-------------------------+ - + ... @@ -1215,7 +1286,10 @@ than developers. +-------------------------+ - + ... @@ -1248,7 +1322,10 @@ something, its primarily used for generating project documentation. +-------------------------+ - + ... Bugzilla @@ -1271,7 +1348,10 @@ <<>>, and not <<>> or <<>>. +-------------------------+ - + ... continuum @@ -1297,7 +1377,10 @@ Most mailing lists are for developers and users. +-------------------------+ - + ... @@ -1334,7 +1417,10 @@ (it does, doesn't it?) then here is where you would place that information into the POM. +-------------------------+ - + ... scm:svn:http://127.0.0.1/svn/my-project @@ -1373,7 +1459,10 @@ A publicly browsable repository. For example, via ViewCVS. +-------------------------+ - + ... 2.0.4 @@ -1405,7 +1494,10 @@ is the Codehaus snapshots repo. +-------------------------+ - + ... @@ -1472,7 +1564,10 @@ and supporting files generated throughout the build process. Starting with the last elements first: +-------------------------+ - + ... ... @@ -1517,7 +1612,10 @@ The repository elements will be used for snapshot distribution if the snapshotRepository is not defined. +-------------------------+ - + ... @@ -1562,7 +1660,10 @@ how to deploy the project’s site and documentation. +-------------------------+ - + ... ... @@ -1584,7 +1685,10 @@ ** {Relocation} +-------------------------+ - + ... ... @@ -1617,7 +1721,10 @@ the JDK version used. The elements of profiles are as follows: +-------------------------+ - + ... @@ -1642,7 +1749,10 @@ basic POM only under certain circumstances. Those circumstances are specified via an <<>> element. +-------------------------+ - + ...