You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by di...@apache.org on 2004/03/29 22:50:07 UTC

cvs commit: maven/xdocs/reference project-descriptor.xml

dion        2004/03/29 12:50:07

  Modified:    xdocs/reference Tag: MAVEN-1_0-BRANCH project-descriptor.xml
  Log:
  Add sample descriptor with links
  
  Revision  Changes    Path
  No                   revision
  No                   revision
  1.29.2.4  +275 -83   maven/xdocs/reference/project-descriptor.xml
  
  Index: project-descriptor.xml
  ===================================================================
  RCS file: /home/cvs/maven/xdocs/reference/project-descriptor.xml,v
  retrieving revision 1.29.2.3
  retrieving revision 1.29.2.4
  diff -u -r1.29.2.3 -r1.29.2.4
  --- project-descriptor.xml	4 Mar 2004 17:45:57 -0000	1.29.2.3
  +++ project-descriptor.xml	29 Mar 2004 20:50:06 -0000	1.29.2.4
  @@ -21,7 +21,7 @@
   
     <properties>
       <author email="pete-apache-dev@kazmier.com">Pete Kazmier</author>
  -    <author email="dion@apache.org">don Gillard</author>
  +    <author email="dion@apache.org">dIon Gillard</author>
       <title>Maven Project Descriptors</title>
     </properties>
   
  @@ -46,6 +46,160 @@
         </p>
       </section>
   
  +    <section name="Descriptor with links">
  +      <source>
  +<a href="#project" class="required">&lt;project&gt;</a>
  +    <a href="#extend" class="optional">&lt;extend/&gt;</a>
  +    <a href="#pomVersion">&lt;pomVersion/&gt;</a>
  +    <a href="#id">&lt;id/&gt;</a>
  +    <a href="#name" title="short name for the project">&lt;name/&gt;</a>
  +    <a href="#groupId">&lt;groupId/&gt;</a>
  +    <a href="#currentVersion">&lt;currentVersion/&gt;</a>
  +    <a href="#organization">&lt;organization&gt;</a>
  +        <a href="#organization_name">&lt;name/&gt;</a>
  +        <a href="#organization_url">&lt;url/&gt;</a>
  +        <a href="#organization_logo">&lt;logo/&gt;</a>
  +    <a href="#organization">&lt;/organization&gt;</a>
  +    <a href="#inceptionYear">&lt;inceptionYear/&gt;</a>
  +    <a href="#package">&lt;package/&gt;</a>
  +    <a href="#logo">&lt;logo/&gt;</a>
  +    <a href="#gumpRepositoryId">&lt;gumpRepositoryId/&gt;</a>
  +    <a href="#description">&lt;description/&gt;</a>
  +    <a href="#shortDescription">&lt;shortDescription/&gt;</a>
  +    <a href="#url">&lt;url/&gt;</a>
  +    <a href="#issueTrackingUrl">&lt;issueTrackingUrl/&gt;</a>
  +    <a href="#siteAddress">&lt;siteAddress/&gt;</a>
  +    <a href="#siteDirectory">&lt;siteDirectory/&gt;</a>
  +    <a href="#distributionSite">&lt;distributionSite/&gt;</a>
  +    <a href="#distributionDirectory">&lt;distributionDirectory/&gt;</a>
  +    <a href="#repository">&lt;repository&gt;</a>
  +        <a href="#repository_connection">&lt;connection/&gt;</a>
  +        <a href="#repository_developerConnection">&lt;developerConnection/&gt;</a>
  +        <a href="#repository_url">&lt;url/&gt;</a>
  +    <a href="#repository">&lt;/repository&gt;</a>
  +    <a href="#versions">&lt;versions&gt;</a>
  +        <a href="#version">&lt;version&gt;</a>
  +            <a href="#version_id">&lt;id/&gt;</a>
  +            <a href="#version_name">&lt;name/&gt;</a>
  +            <a href="#version_tag">&lt;tag/&gt;</a>
  +        <a href="#version">&lt;/version&gt;</a>
  +    <a href="#versions">&lt;/versions&gt;</a>
  +    <a href="#branches">&lt;branches&gt;</a>
  +        <a href="#branch">&lt;branch&gt;</a>
  +            <a href="#branch_tag">&lt;tag/&gt;</a>
  +        <a href="#branch">&lt;/branch&gt;</a>
  +    <a href="#branches">&lt;/branches&gt;</a>
  +    <a href="#mailingLists">&lt;mailingLists&gt;</a>
  +        <a href="#mailingList">&lt;mailingList&gt;</a>
  +            <a href="#mailingList_name">&lt;name/&gt;</a>
  +            <a href="#mailingList_subscribe">&lt;subscribe/&gt;</a>
  +            <a href="#mailingList_unsubscribe">&lt;unsubscribe/&gt;</a>
  +            <a href="#mailingList_archive">&lt;archive/&gt;</a>
  +        <a href="#mailingList">&lt;/mailingList&gt;</a>
  +    <a href="#mailingLists">&lt;/mailingLists&gt;</a>
  +    <a href="#developers">&lt;developers&gt;</a>
  +        <a href="#developer">&lt;developer&gt;</a>
  +            <a href="#developer_name">&lt;name/&gt;</a>
  +            <a href="#developer_id">&lt;id/&gt;</a>
  +            <a href="#developer_email">&lt;email/&gt;</a>
  +            <a href="#developer_organization">&lt;organization/&gt;</a>
  +            <a href="#developer_roles">&lt;roles&gt;</a>
  +                <a href="#developer_roles">&lt;role/&gt;</a>
  +            <a href="#developer_roles">&lt;/roles&gt;</a>
  +            <a href="#developer_url">&lt;url/&gt;</a>
  +            <a href="#developer_timezone">&lt;organization/&gt;</a>
  +        <a href="#developer">&lt;/developer&gt;</a>
  +    <a href="#developers">&lt;/developers&gt;</a>
  +    <a href="#contributors">&lt;contributors&gt;</a>
  +        <a href="#contributor">&lt;contributor&gt;</a>
  +            <a href="#contributor_name">&lt;name/&gt;</a>
  +            <a href="#contributor_email">&lt;email/&gt;</a>
  +            <a href="#contributor_organization">&lt;organization/&gt;</a>
  +            <a href="#contributor_roles">&lt;roles&gt;</a>
  +                <a href="#contributor_roles">&lt;role/&gt;</a>
  +            <a href="#contributor_roles">&lt;/roles&gt;</a>
  +            <a href="#contributor_url">&lt;url/&gt;</a>
  +            <a href="#contributor_timezone">&lt;organization/&gt;</a>
  +        <a href="#contributor">&lt;/contributor&gt;</a>
  +    <a href="#contributors">&lt;/contributors&gt;</a>
  +    <a href="#licenses">&lt;licenses&gt;</a>
  +        <a href="#license">&lt;license&gt;</a>
  +            <a href="#license_name">&lt;name/&gt;</a>
  +            <a href="#license_url">&lt;url/&gt;</a>
  +            <a href="#license_distribution">&lt;distribution/&gt;</a>
  +        <a href="#license">&lt;/license&gt;</a>
  +    <a href="#licenses">&lt;/licenses&gt;</a>
  +    <a href="#dependencies">&lt;dependencies&gt;</a>
  +        <a href="#dependency">&lt;dependency&gt;</a>
  +            <a href="#dependency_id">&lt;id/&gt;</a>
  +            <a href="#dependency_groupId">&lt;groupId/&gt;</a>
  +            <a href="#dependency_artifactId">&lt;artifactId/&gt;</a>
  +            <a href="#dependency_version">&lt;version/&gt;</a>
  +            <a href="#dependency_jar">&lt;jar/&gt;</a>
  +            <a href="#dependency_type">&lt;type/&gt;</a>
  +            <a href="#dependency_url">&lt;url/&gt;</a>
  +            <a href="#dependency_properties">&lt;properties&gt;</a>
  +            <a href="#dependency_properties">&lt;/properties&gt;</a>
  +        <a href="#dependency">&lt;/dependency&gt;</a>
  +    <a href="#dependencies">&lt;/dependencies&gt;</a>
  +    <a href="#build">&lt;build&gt;</a>
  +        <a href="#build_nagEmailAddress">&lt;nagEmailAddress/&gt;</a>
  +        <a href="#sourceDirectory">&lt;sourceDirectory/&gt;</a>
  +        <a href="#sourceModifications">&lt;sourceModifications&gt;</a>
  +            <a href="#sourceModification">&lt;sourceModification&gt;</a>
  +                <a href="#sourceModification_className">&lt;className/&gt;</a>
  +                <a href="#sourceModification_includes">&lt;includes&gt;</a>
  +                    <a href="#sourceModification_includes">&lt;include/&gt;</a>
  +                <a href="#sourceModification_includes">&lt;/includes&gt;</a>
  +                <a href="#sourceModification_excludes">&lt;excludes&gt;</a>
  +                    <a href="#sourceModification_excludes">&lt;exclude/&gt;</a>
  +                <a href="#sourceModification_excludes">&lt;/excludes&gt;</a>
  +            <a href="#sourceModification">&lt;/sourceModification&gt;</a>
  +        <a href="#sourceModifications">&lt;/sourceModifications&gt;</a>
  +        <a href="#build_unitTestSourceDirectory">&lt;unitTestSourceDirectory/&gt;</a>
  +        <a href="#build_integrationUnitTestSourceDirectory">&lt;integrationUnitTestSourceDirectory/&gt;</a>
  +        <a href="#build_aspectSourceDirectory">&lt;aspectSourceDirectory/&gt;</a>
  +        <a href="#unitTest">&lt;unitTest&gt;</a>
  +            <a href="#unitTest_includes">&lt;includes&gt;</a>
  +                <a href="#unitTest_includes">&lt;include/&gt;</a>
  +            <a href="#unitTest_includes">&lt;/includes&gt;</a>
  +            <a href="#unitTest_excludes">&lt;excludes&gt;</a>
  +                <a href="#unitTest_excludes">&lt;exclude/&gt;</a>
  +            <a href="#unitTest_excludes">&lt;/excludes&gt;</a>
  +            <a href="#unitTest_resources">&lt;resources&gt;</a>
  +                <a href="#resource">&lt;resource&gt;</a>
  +                    <a href="#resource_directory">&lt;directory/&gt;</a>
  +                    <a href="#resource_targetPath">&lt;targetPath/&gt;</a>
  +                    <a href="#resource_includes">&lt;includes&gt;</a>
  +                        <a href="#resource_includes">&lt;include/&gt;</a>
  +                    <a href="#resource_includes">&lt;/includes&gt;</a>
  +                    <a href="#resource_excludes">&lt;excludes&gt;</a>
  +                        <a href="#resource_excludes">&lt;exclude/&gt;</a>
  +                    <a href="#resource_excludes">&lt;/excludes&gt;</a>
  +                <a href="#resource">&lt;/resource&gt;</a>
  +            <a href="#unitTest_resources">&lt;/resources&gt;</a>
  +        <a href="#unitTest">&lt;/unitTest&gt;</a>
  +        <a href="#resources">&lt;resources&gt;</a>
  +            <a href="#resource">&lt;resource&gt;</a>
  +                <a href="#resource_directory">&lt;directory/&gt;</a>
  +                <a href="#resource_targetPath">&lt;targetPath/&gt;</a>
  +                <a href="#resource_includes">&lt;includes&gt;</a>
  +                    <a href="#resource_includes">&lt;include/&gt;</a>
  +                <a href="#resource_includes">&lt;/includes&gt;</a>
  +                <a href="#resource_excludes">&lt;excludes&gt;</a>
  +                    <a href="#resource_excludes">&lt;exclude/&gt;</a>
  +                <a href="#resource_excludes">&lt;/excludes&gt;</a>
  +            <a href="#resource">&lt;/resource&gt;</a>
  +        <a href="#resources">&lt;/resources&gt;</a>
  +    <a href="#build">&lt;/build&gt;</a>
  +    <a href="#reports">&lt;reports&gt;</a>
  +        <a href="#report">&lt;report&gt;</a>
  +    <a href="#reports">&lt;/reports&gt;</a>
  +    <a href="#properties">&lt;properties/&gt;</a>
  +<a href="#project">&lt;/project&gt;</a>
  +      </source>
  +    </section>
  +    
       <section name="project">
         <p>
           The <code>&lt;project&gt;</code> element specifies various
  @@ -57,7 +211,7 @@
         <table>
           <tr><th>Element</th><th>Description</th></tr>
           <tr>
  -          <td>extend</td>
  +          <td><a name="extend">extend</a></td>
             <td>
               The location of the parent project, if one exists. Values from the parent project will be
               the default for this project if they are left unspecified.
  @@ -66,7 +220,7 @@
             </td>
           </tr>
           <tr>
  -          <td>pomVersion</td>
  +          <td><a name="pomVersion">pomVersion</a></td>
             <td>
               The current version of the Maven project descriptor.  This
               version number enables Maven to automatically update an
  @@ -77,7 +231,7 @@
             </td>
           </tr>
           <tr>
  -          <td>id</td>
  +          <td><a name="id">id</a></td>
             <td>
               The short name of the project.  This value is used when
               naming <a href="plugins/java/index.html">jars</a> and <a
  @@ -85,7 +239,7 @@
             </td>
           </tr>
           <tr>
  -          <td>name</td>
  +          <td><a name="name">name</a></td>
             <td>
               The full name of the project.  This value is used when
               generating <a href="plugins/javadoc/index.html">JavaDoc</a>
  @@ -93,7 +247,7 @@
             </td>
           </tr>
           <tr>
  -          <td>groupId</td>
  +          <td><a name="groupId">groupId</a></td>
             <td>
               The short name of the project group. This value is used to group
               all jars for a project in one directory. For more info look at the
  @@ -101,7 +255,7 @@
             </td>
           </tr>
           <tr>
  -          <td>currentVersion</td>
  +          <td><a name="currentVersion">currentVersion</a></td>
             <td>
               The current version of the project.  This value is used when
               naming <a href="plugins/java/index.html">jars</a> and <a
  @@ -116,7 +270,7 @@
             </td>
           </tr>
           <tr>
  -          <td>inceptionYear</td>
  +          <td><a name="inceptionYear">inceptionYear</a></td>
             <td>
               The year of the project's inception specified with 4 digits.
               This value is used when generating <a
  @@ -125,7 +279,7 @@
             </td>
           </tr>
           <tr>
  -          <td>package</td>
  +          <td><a name="package">package</a></td>
             <td>
               The Java package name of the project.  This value is used
               when generating <a
  @@ -133,7 +287,7 @@
             </td>
           </tr>
           <tr>
  -          <td>logo</td>
  +          <td><a name="logo">logo</a></td>
             <td>
               The URL to the project's logo image.  This can be an URL relative
               to the base directory of the generated web site,
  @@ -143,7 +297,7 @@
             </td>
           </tr>
           <tr>
  -          <td>gumpRepositoryId</td>
  +          <td><a name="gumpRepositoryId">gumpRepositoryId</a></td>
             <td>
               Optional. This is the Id of the Gump repository that this project is
               part of (assuming it participates in the Gump integration
  @@ -151,7 +305,7 @@
             </td>
           </tr>
           <tr>
  -          <td>description</td>
  +          <td><a name="description">description</a></td>
             <td>
               Optional. A detailed description of the project.  This element is
               usually specified as CDATA to enable the use of HTML tags
  @@ -161,26 +315,26 @@
             </td>
           </tr>
           <tr>
  -          <td>shortDescription</td>
  +          <td><a name="shortDescription">shortDescription</a></td>
             <td>
               A short description of the project.  The short description
               should be limited to a single line.
             </td>
           </tr>
           <tr>
  -          <td>url</td>
  +          <td><a name="url">url</a></td>
             <td>
               The URL to the project's homepage.
             </td>
           </tr>
           <tr>
  -          <td>issueTrackingUrl</td>
  +          <td><a name="issueTrackingUrl">issueTrackingUrl</a></td>
             <td>
               Optional. The URL to the project's issue tracking system.
             </td>
           </tr>
           <tr>
  -          <td>siteAddress</td>
  +          <td><a name="siteAddress">siteAddress</a></td>
             <td>
               Optional. The hostname of the web server that hosts the project's web
               site.  This is used when the web site is <a
  @@ -188,7 +342,7 @@
             </td>
           </tr>
           <tr>
  -          <td>siteDirectory</td>
  +          <td><a name="siteDirectory">siteDirectory</a></td>
             <td>
               Optional. The directory on the web server where the public web site
               for this project resides.  This is used when the web site is <a
  @@ -196,7 +350,7 @@
             </td>
           </tr>
           <tr>
  -          <td>distributionSite</td>
  +          <td><a name="distributionSite">distributionSite</a></td>
             <td>
               Optional. The server server where the final
               distributions will be published.  This is used when the
  @@ -210,7 +364,7 @@
             </td>
           </tr>
           <tr>
  -          <td>distributionDirectory</td>
  +          <td><a name="distributionDirectory">distributionDirectory</a></td>
             <td>
               Optional. The directory on the web server where the final
               distributions will be published.  This is used when the
  @@ -298,7 +452,7 @@
             </td>
           </tr>
           <tr>
  -          <td>properties</td>
  +          <td><a name="properties">properties</a></td>
             <td>
               Project properties that will be used by various plugins
             </td>
  @@ -314,19 +468,19 @@
         <table>
           <tr><th>Element</th><th>Description</th></tr>
           <tr>
  -          <td>name</td>
  +          <td><a name="organization_name">name</a></td>
             <td>
               The full name of the organization.
             </td>
           </tr>
           <tr>
  -          <td>url</td>
  +          <td><a name="organization_url">url</a></td>
             <td>
               The URL to the organization's home page.
             </td>
           </tr>
           <tr>
  -          <td>logo</td>
  +          <td><a name="organization_logo">logo</a></td>
             <td>
               The URL to the organization's logo image.  This can be an URL relative
               to the base directory of the generated web site,
  @@ -341,7 +495,7 @@
         <table>
           <tr><th>Element</th><th>Description</th></tr>
           <tr>
  -          <td>connection</td>
  +          <td><a name="repository_connection">connection</a></td>
             <td>
               <p>Optional.  The source configuration management system URL
               that describes the repository and how to connect to the
  @@ -374,7 +528,7 @@
                 colon (<code>:</code>) in it.
               </p>
               <p>
  -           	  For local file system repositories
  +              For local file system repositories
                 <source><pre>scm:cvs:local:ignored:/cvs/root:module-name</pre></source>
               </p>
               <p>
  @@ -385,10 +539,10 @@
                 administrator. 
               </p>
               <p>
  -            	The delimiter is determined by the character after "scm". eg.
  -            	<code>scm|cvs|pserver|user@host|/cvs/root|module-name</code> 
  -            	is equivalent to that listed above. This can be useful for Windows users
  -            	who have : in their cvsroot parameter (eg. D:\cvsroot)
  +                The delimiter is determined by the character after "scm". eg.
  +                <code>scm|cvs|pserver|user@host|/cvs/root|module-name</code> 
  +                is equivalent to that listed above. This can be useful for Windows users
  +                who have : in their cvsroot parameter (eg. D:\cvsroot)
               </p>
               <p>
                 Where <code>pserver</code> is the protocol used to access CVS,
  @@ -407,14 +561,14 @@
             </td>
           </tr>
           <tr>
  -          <td>developerConnection</td>
  +          <td><a name="repository_developerConnection">developerConnection</a></td>
             <td>
               Optional. Just like connection, but for developers, i.e. this scm connection
               will not be read only.
             </td>
           </tr>
           <tr>
  -          <td>url</td>
  +          <td><a name="repository_url">url</a></td>
             <td>
               Optional. The URL to the project's browsable CVS repository
             </td>
  @@ -430,7 +584,7 @@
               <table>
                   <tr><th>Element</th><th>Description</th></tr>
                   <tr>
  -                    <td>id</td>
  +                    <td><a name="version_id">id</a></td>
                       <td>
                         A unique identifier for a version.  This ID is
                         used to specify the version that <a
  @@ -439,7 +593,7 @@
                       </td>
                   </tr>
                   <tr>
  -                    <td>name</td>
  +                    <td><a name="version_name">name</a></td>
                       <td>
                         The external version number under which this
                         release was distributed. Examples include:
  @@ -448,7 +602,7 @@
                       </td>
                   </tr>
                   <tr>
  -                    <td>tag</td>
  +                    <td><a name="version_tag">tag</a></td>
                       <td>
                         The name given in the version control system
                         (e.g. cvs) used by the project for the source
  @@ -468,7 +622,7 @@
               <table>
                   <tr><th>Element</th><th>Description</th></tr>
                   <tr>
  -                    <td>tag</td>
  +                    <td><a name="branch_tag">tag</a></td>
                       <td>
                         The branch tag in the version control system
                         (e.g. cvs) used by the project for the source
  @@ -491,11 +645,11 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>name</td>
  +            <td><a name="mailingList_name">name</a></td>
               <td>The name of the mailing list.</td>
             </tr>
             <tr>
  -            <td>subscribe</td>
  +            <td><a name="mailingList_subscribe">subscribe</a></td>
               <td>
                 The email address or link that can be used to subscribe to the
                 mailing list.  If this is an email address, a
  @@ -504,7 +658,7 @@
               </td>
             </tr>
             <tr>
  -            <td>unsubscribe</td>
  +            <td><a name="mailingList_unsubscribe">unsubscribe</a></td>
               <td>
                 The email address or link that can be used to unsubscribe to
                 the mailing list.  If this is an email address, a
  @@ -531,23 +685,23 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>name</td>
  +            <td><a name="developer_name">name</a></td>
               <td>The full name of the developer.</td>
             </tr>
             <tr>
  -            <td>id</td>
  +            <td><a name="developer_id">id</a></td>
               <td>The username of the developer.</td>
             </tr>
             <tr>
  -            <td>email</td>
  +            <td><a name="developer_email">email</a></td>
               <td>The email address of the developer.</td>
             </tr>
             <tr>
  -            <td>organization</td>
  +            <td><a name="developer_organization">organization</a></td>
               <td>The organization to which the developer belongs.</td>
             </tr>
             <tr>
  -            <td>roles</td>
  +            <td><a name="developer_roles">roles</a></td>
               <td>
                 The roles the developer plays in the project.  Each role is
                 describe by a <code>role</code> element, the body of which is a
  @@ -555,11 +709,11 @@
               </td>
             </tr>
             <tr>
  -            <td>url</td>
  +            <td><a name="developer_url">url</a></td>
               <td>The URL for the homepage of the developer</td>
             </tr>
             <tr>
  -            <td>timezone</td>
  +            <td><a name="developer_timezone">timezone</a></td>
               <td>
                 The timezone the developer is in. This is a number in the range
                 -14 to 14.
  @@ -580,19 +734,19 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>name</td>
  +            <td><a name="contributor_name">name</a></td>
               <td>The full name of the contributor.</td>
             </tr>
             <tr>
  -            <td>email</td>
  +            <td><a name="contributor_email">email</a></td>
               <td>The email address of the contributor.</td>
             </tr>
             <tr>
  -            <td>organization</td>
  +            <td><a name="contributor_organization">organization</a></td>
               <td>The organization to which the contributor belongs.</td>
             </tr>
             <tr>
  -            <td>roles</td>
  +            <td><a name="contributor_roles">roles</a></td>
               <td>
                 The roles the contributor plays in the project.  Each role is
                 describe by a <code>role</code> element, the body of which is a
  @@ -600,11 +754,11 @@
               </td>
             </tr>
             <tr>
  -            <td>url</td>
  +            <td><a name="contributor_url">url</a></td>
               <td>The URL for the homepage of the contributor</td>
             </tr>
             <tr>
  -            <td>timezone</td>
  +            <td><a name="contributor_timezone">timezone</a></td>
               <td>
                 The timezone the contributor is in. This is a number in the range
                 -14 to 14.
  @@ -626,15 +780,15 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>name</td>
  +            <td><a name="license_name">name</a></td>
               <td>The full legal name of the license.</td>
             </tr>
             <tr>
  -            <td>url</td>
  +            <td><a name="license_url">url</a></td>
               <td>The official url for the license text.</td>
             </tr>
             <tr>
  -            <td>distribution</td>
  +            <td><a name="license_distribution">distribution</a></td>
               <td>The primary method by which this project may be distributed.
                 <dl>
                   <dt>repo</dt>
  @@ -696,7 +850,7 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>id</td>
  +            <td><a name="dependency_id">id</a></td>
               <td>
                 <p>The name of the dependency.</p>
                 <p>
  @@ -707,30 +861,30 @@
               </td>
             </tr>
             <tr>
  -            <td>groupId</td>
  +            <td><a name="dependency_groupId">groupId</a></td>
               <td>
                 The project group that produced the dependency, e.g. <code>jboss</code>.
               </td>
             </tr>
             <tr>
  -            <td>artifactId</td>
  +            <td><a name="dependency_artifactId">artifactId</a></td>
               <td>
                 The unique id for an artifact produced by the project group, e.g.
                 <code>jboss-boot</code>
               </td>
             </tr>
             <tr>
  -            <td>version</td>
  +            <td><a name="dependency_version">version</a></td>
               <td>The version of the dependency., e.g. <code>3.2.1</code></td>
             </tr>
             <tr>
  -            <td>jar</td>
  +            <td><a name="dependency_jar">jar</a></td>
               <td>
                 The name of jar file if it doesn't respect 
                 <code>&lt;artifactId&gt;-&lt;version&gt;.jar pattern.</code></td>
             </tr>
             <tr>
  -            <td>type</td>
  +            <td><a name="dependency_type">type</a></td>
               <td>
                 The type of dependency. This defaults to <code>jar</code>.
                 <p>
  @@ -740,7 +894,7 @@
               </td>
             </tr>
             <tr>
  -            <td>url</td>
  +            <td><a name="dependency_url">url</a></td>
               <td>
                 The url of the dependency's homepage.
                 <p>
  @@ -750,7 +904,7 @@
               </td>
             </tr>
             <tr>
  -            <td>properties</td>
  +            <td><a name="dependency_properties">properties</a></td>
               <td>
                 Properties about the dependency. Various plugins allow you to 
                 <code>mark</code> dependencies with properties. For example the 
  @@ -771,13 +925,13 @@
         <table>
           <tr><th>Element</th><th>Description</th></tr>
           <tr>
  -          <td>nagEmailAddress</td>
  +          <td><a name="build_nagEmailAddress">nagEmailAddress</a></td>
             <td>
               An address to which notifications regarding the status of builds
               for this project can be sent. This is intended for use by tools
               which do unattended builds, for example those providing for
               continuous integration. Currently this is used by the
  -            <a href="build-file.html#maven:gump-descriptor">maven:gump-descriptor</a>
  +            <a href="plugins/gump/">gump plugin</a>
               target.
             </td>
           </tr>
  @@ -794,11 +948,11 @@
             <td><a href="#sourceModifications">sourceModifications</a></td>
             <td>
               This element specifies how source code will be excluded or included
  -            depending on the presence of a given class.
  +            depending on the presence of a given class. e.g.
             </td>
           </tr>
           <tr>
  -          <td>unitTestSourceDirectory</td>
  +          <td><a name="build_unitTestSourceDirectory">unitTestSourceDirectory</a></td>
             <td>
               This element specifies a directory containing the unit test
               source of the project. The generated build system will
  @@ -808,7 +962,7 @@
             </td>
           </tr>
           <tr>
  -          <td>integrationUnitTestSourceDirectory</td>
  +          <td><a name="build_integrationUnitTestSourceDirectory">integrationUnitTestSourceDirectory</a></td>
             <td>
               This element is deprecated and should no longer be used.
               Initially it was used by the first Cactus plugin. Now
  @@ -819,7 +973,7 @@
             </td>
           </tr>
           <tr>
  -          <td>aspectSourceDirectory</td>
  +          <td><a name="build_aspectSourceDirectory">aspectSourceDirectory</a></td>
             <td>
               This element specifies a directory containing Aspect
               sources of the project.  The generated build system will
  @@ -848,11 +1002,11 @@
            the build is running in.
           </p>
           
  -        <p>sourceModification elements</p>
  +        <p><a name="sourceModification">sourceModification elements</a></p>
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>className</td>
  +            <td><a name="sourceModification_className">className</a></td>
               <td>
                 If the class with this name can <strong>not</strong> be
                 loaded, then the includes and excludes specified below 
  @@ -861,31 +1015,47 @@
               </td>
             </tr>
             <tr>
  -            <td><a href="#includes">includes</a></td>
  +            <td><a name="sourceModification_includes"><a href="#includes">includes</a></a></td>
               <td>Describe the files to be included if the class was not found</td>
             </tr>
             <tr>
  -            <td><a href="#excludes">excludes</a></td>
  +            <td><a name="sourceModification_excludes"><a href="#excludes">excludes</a></a></td>
               <td>Describe the files to be excluded if the class was not found</td>
             </tr>
           </table>
           <p>
             <strong>Note</strong>: not all plugins support the sourceModifications element.
           </p>
  +        <p>
  +          An example below always excludes the classes beginning with <code>EJS</code>
  +          and <code>_</code>.
  +        </p>
  +        <source><![CDATA[
  +    <sourceModifications>
  +      <sourceModification>
  +        <className>fakeClass</className>
  +        <excludes>
  +          <exclude>**/EJS*.java</exclude>
  +          <exclude>**/_*.java</exclude>
  +        </excludes>
  +      </sourceModification>
  +    </sourceModifications>
  +]]></source>
  +
         </subsection>
         <subsection name="unitTest">
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td><a href="#includes">includes</a></td>
  +            <td><a name="unitTest_includes"><a href="#includes">includes</a></a></td>
               <td>Describe the includes unit tests</td>
             </tr>
             <tr>
  -            <td><a href="#excludes">excludes</a></td>
  +            <td><a name="unitTest_excludes"><a href="#excludes">excludes</a></a></td>
               <td>Describe the excludes unit tests</td>
             </tr>
             <tr>
  -            <td><a href="#resources">resources</a></td>
  +            <td><a name="unitTest_resources"><a href="#resources">resources</a></a></td>
               <td>Describe the resources associated with unit tests</td>
             </tr>
           </table>
  @@ -904,19 +1074,41 @@
               <td>Each resource must be defined in a <tt>resource</tt> element.</td>
             </tr>
           </table>
  +        <p>
  +          Here's an example <code>resources</code> block
  +        </p>
  +        <source><![CDATA[
  +    <!-- J A R  R E S O U R C E S -->
  +    <!-- Resources that are packaged up inside the JAR file -->
  +    <resources>
  +      <resource>
  +        <directory>${basedir}/src/resources/misc</directory>
  +        <includes>
  +          <include>*.xsd</include>
  +        </includes>
  +      </resource>
  +      <resource>
  +        <directory>${basedir}/src/resources/logging</directory>
  +        <includes>
  +          <include>log4j.properties</include>
  +        </includes>
  +      </resource>
  +    </resources>
  +]]></source>
         </subsection>
  +      
         <subsection name="resource">
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>directory</td>
  +            <td><a name="resource_directory">directory</a></td>
               <td>
                 Describe the directory where the resource is stored.
                 The path may be absolute, or relative to the project.xml file.
               </td>
             </tr>
             <tr>
  -            <td>targetPath</td>
  +            <td><a name="resource_targetPath">targetPath</a></td>
               <td>
                 Describe the resource target path. For example, if you want that resource
                 appear into a specific package (<code>org.apache.maven.messages</code>), you must specify this
  @@ -924,15 +1116,15 @@
               </td>
             </tr>
             <tr>
  -            <td><a href="#includes">includes</a></td>
  +            <td><a name="resource_includes"><a href="#includes">includes</a></a></td>
               <td>Describe the includes files to the project</td>
             </tr>
             <tr>
  -            <td><a href="#excludes">excludes</a></td>
  +            <td><a name="resource_excludes"><a href="#excludes">excludes</a></a></td>
               <td>Describe the excludes files to the project</td>
             </tr>
             <tr>
  -            <td>filtering</td>
  +            <td><a name="resource_filtering">filtering</a></td>
               <td>Boolean. Describe if resources are filtered or not.</td>
             </tr>
           </table>
  @@ -941,7 +1133,7 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>include</td>
  +            <td><a name="include">include</a></td>
               <td>
                 This element specifies an 
                 <a href="http://ant.apache.org/manual/CoreTypes/patternset.html">Ant pattern</a>
  @@ -954,7 +1146,7 @@
           <table>
             <tr><th>Element</th><th>Description</th></tr>
             <tr>
  -            <td>exclude</td>
  +            <td><a name="exclude">exclude</a></td>
               <td>
                 This element specifies an 
                 <a href="http://ant.apache.org/manual/CoreTypes/patternset.html">Ant pattern</a>
  @@ -975,7 +1167,7 @@
         <table>
           <tr><th>Element</th><th>Description</th></tr>
           <tr>
  -          <td>report</td>
  +          <td><a name="report">report</a></td>
             <td>
               The name of the report that should be run when the site is
               generated.  There is an established naming convention that
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org