brett 2005/04/11 18:44:37
Modified: maven-site/src/site/xdoc/style project.css
maven-site/src/site/xdoc configuration.xml index.xml
navigation.xml project-descriptor.xml
Added: maven-site/src/site/xdoc settings-descriptor.xml
Log:
add configuration doco
Revision Changes Path
1.2 +3 -0
maven-components/maven-site/src/site/xdoc/style/project.css
Index: project.css
===================================================================
RCS file:
/home/cvs/maven-components/maven-site/src/site/xdoc/style/project.css,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- project.css 7 Apr 2005 07:01:44 -0000 1.1
+++ project.css 12 Apr 2005 01:44:37 -0000 1.2
@@ -3,3 +3,6 @@
padding-right: 0;
}
+body ul {
+ list-style-type: square;
+}
1.2 +116 -1
maven-components/maven-site/src/site/xdoc/configuration.xml
Index: configuration.xml
===================================================================
RCS file:
/home/cvs/maven-components/maven-site/src/site/xdoc/configuration.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- configuration.xml 7 Apr 2005 07:39:14 -0000 1.1
+++ configuration.xml 12 Apr 2005 01:44:37 -0000 1.2
@@ -6,8 +6,123 @@
<body>
<section name="Configuring Maven">
<p>
- ...
+ Maven configuration occurs at 3 levels:
</p>
+ <ul>
+ <li>
+ <i>Project</i> - most static configuration occurs in
+ <code>pom.xml</code>
+ </li>
+ <li>
+ <i>Installation</i> - this is configuration added once for a Maven
installation (not supported in the initial Technology Preview)
+ </li>
+ <li>
+ <i>User</i> - this is configuration specific to a particular user
+ </li>
+ </ul>
+ <p>
+ The separation is quite clear - the project defines information that
applies to the project, no matter who is
+ building it, while the others both define settings for the current
environment.
+ </p>
+ <p>
+ <b>Note: </b> the installation and user configuration can not be
used to add shared project information -
+ for example setting
+ <code><organization></code> or
+ <code><distributionManagement></code> company-wide.
+ For this, you should have your projects inherit from a company-wide
parent
+ <code>pom.xml</code>.
+ <!-- TODO: versioning doc that discusses this -->
+ </p>
+ <p>
+ User configuration is specified in
+ <code>${user.home}/.m2/settings.xml</code>. A
+ <a href="settings-descriptor.html">full reference</a> to the
+ configuration file is available. This section will show how to make
some common configurations.
+ </p>
+ <p style="font-weight: bold; font-size: larger">
+ Configuring your Local Repository
+ </p>
+ <p>
+ The local repository is part of a profile in your user
configuration. You can have multiple profiles, with one
+ set to active so that you can switch environments.
+ </p>
+ <source><![CDATA[
+<settings>
+ .
+ .
+ <profiles>
+ <profile>
+ <active>true</active>
+ <localRepository>/path/to/local/repo</localRepository>
+ </profile>
+ </profiles>
+ .
+ .]]></source>
+ <p>
+ The local repository must be an absolute path.
+ </p>
+ <p style="font-weight: bold; font-size: larger">
+ Configuring a Proxy
+ </p>
+ <p>
+ You can configure a proxy to use for some or all of your HTTP
requests in Maven 2.0. The username and
+ password are only required if your proxy requires basic
authentication (note that later alphas will support
+ storing your passwords in a secured keystore - in the mean time,
please ensure your <code>settings.xml</code>
+ file is secured with permissions appropriate for your operating
system).
+ </p>
+ <p>
+ The <code>nonProxyHosts</code> setting accepts wild cards, and each
host not to proxy is separated by the
+ <code>|</code> character. This matches the
+ <a
href="http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html";>JDK
configuration</a> equivalent.
+ </p>
+ <source><![CDATA[
+<settings>
+ .
+ .
+ <proxies>
+ <proxy>
+ <active>true</active>
+ <protocol>http</protocol>
+ <host>http://proxy.somewhere.com</host>
+ <port>8080</port>
+ <username>proxyuser</username>
+ <password>somepassword</password>
+ <nonProxyHosts>www.google.com|*.somewhere.com</nonProxyHosts>
+ </proxy>
+ </proxies>
+ .
+ .]]></source>
+ <p style="font-weight: bold; font-size: larger">
+ Deployment Settings
+ </p>
+ <p>
+ Repositories to deploy to are defined in a project in the
<code><distributionManagement></code> section.
+ However, you cannot put your username, password, or other security
settings in that project. For that reason,
+ you should add a server definition to your own settings with an
<code>id</code> that matches that of the
+ deployment repository in the project.
+ </p>
+ <p>
+ Which settings are required will depend on the type of repository
you are deploying to. As of the first release,
+ only SCP deployments and file deployments are supported by default,
so only the following SCP configuration
+ is needed:
+ </p>
+ <source><![CDATA[
+<settings>
+ .
+ .
+ <servers>
+ <server>
+ <id>repo1</id>
+ <username>repouser</username>
+ <!-- other optional elements:
+ <password>my_login_password</password>
+ <privateKey>/path/to/identity</privateKey> (default is ~/.ssh/id_dsa)
+ <passphrase>my_key_passphrase</passphrase>
+ -->
+ </server>
+ </servers>
+ .
+ .]]></source>
</section>
</body>
</document>
1.9 +9 -9 maven-components/maven-site/src/site/xdoc/index.xml
Index: index.xml
===================================================================
RCS file: /home/cvs/maven-components/maven-site/src/site/xdoc/index.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- index.xml 11 Apr 2005 16:30:57 -0000 1.8
+++ index.xml 12 Apr 2005 01:44:37 -0000 1.9
@@ -16,7 +16,7 @@
<small>(685K)</small>
<br/>
</p>
- <ul style="margin-top: 0">
+ <ul style="margin-top: 0; list-style-type: disc">
<li style="font-size: smaller">
<a href="download.html#requirements">System Requirements</a>
</li>
@@ -39,7 +39,7 @@
Maven 2.0 is a rewrite of the popular Maven application to achieve a
number of goals, and to provide a stable
basis to take it into the future. It is currently available as a
Technology Preview.
</p>
- <ul style="list-style-type: square">
+ <ul>
<li>
<i>
<a href="about.html#what-is-maven">What is Maven?</a>
@@ -83,7 +83,7 @@
Maven 1.0 users will likely have a lot of questions about Maven 2.0
and how it will impact the future of Maven
1.0.
</p>
- <ul style="list-style-type: square">
+ <ul>
<li>
<i>
<a href="maven1.html#">What's changed?</a>
@@ -111,7 +111,7 @@
<p>
Maven is now simpler than ever to use!
</p>
- <ul style="list-style-type: square">
+ <ul>
<li>
<i>
<a href="getting-started.html">Getting Started</a>
@@ -122,14 +122,14 @@
<a href="general.html">General FAQ</a>
</i>
</li>
+ <li>
+ <i>
+ <a href="configuration.html">Configuring Maven</a>
+ </i>
+ </li>
<!-- TODO
<li>
<i>
- <a href="configuration.html">Configuring Maven</a>
- </i>
- </li>
- <li>
- <i>
<a href="archetypes.html">Generating a Template Project:
Archetypes</a>
</i>
</li>
1.6 +1 -0 maven-components/maven-site/src/site/xdoc/navigation.xml
Index: navigation.xml
===================================================================
RCS file: /home/cvs/maven-components/maven-site/src/site/xdoc/navigation.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- navigation.xml 8 Apr 2005 16:21:42 -0000 1.5
+++ navigation.xml 12 Apr 2005 01:44:37 -0000 1.6
@@ -22,6 +22,7 @@
</menu>
<menu name="Reference">
<item name="Project Descriptor" href="project-descriptor.html"/>
+ <item name="Settings Descriptor" href="settings-descriptor.html"/>
<item name="Available Plugins" href="plugin-list.html"/>
</menu>
</body>
1.4 +191 -192
maven-components/maven-site/src/site/xdoc/project-descriptor.xml
Index: project-descriptor.xml
===================================================================
RCS file:
/home/cvs/maven-components/maven-site/src/site/xdoc/project-descriptor.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- project-descriptor.xml 9 Apr 2005 02:07:15 -0000 1.3
+++ project-descriptor.xml 12 Apr 2005 01:44:37 -0000 1.4
@@ -12,198 +12,197 @@
<section name="Descriptor with links">
<p>
<source>
- <a href="#Model"><model></a>
- <a href="#Parent"><parent></a>
- <a href="#Parent"><artifactId/></a>
- <a href="#Parent"><groupId/></a>
- <a href="#Parent"><version/></a>
- <a href="#Parent"><parent></a>
- <a href="#Model"><modelVersion/></a>
- <a href="#Model"><groupId/></a>
- <a href="#Model"><artifactId/></a>
- <a href="#Model"><packaging/></a>
- <a href="#Model"><modules/></a>
- <a href="#Model"><name/></a>
- <a href="#Model"><version/></a>
- <a href="#Model"><description/></a>
- <a href="#Model"><url/></a>
- <a href="#IssueManagement"><issueManagement></a>
- <a href="#IssueManagement"><system/></a>
- <a href="#IssueManagement"><url/></a>
- <a href="#IssueManagement"><issueManagement></a>
- <a href="#CiManagement"><ciManagement></a>
- <a href="#CiManagement"><system/></a>
- <a href="#CiManagement"><url/></a>
- <a href="#notifiers"><notifiers></a>
- <a href="#Notifier"><notifier></a>
- <a href="#Notifier"><type/></a>
- <a href="#Notifier"><address/></a>
- <a href="#Notifier"><configuration/></a>
- <a href="#Notifier"><notifier></a>
- <a href="#notifiers"></notifiers></a>
- <a href="#CiManagement"><ciManagement></a>
- <a href="#Model"><inceptionYear/></a>
- <a href="#repositories"><repositories></a>
- <a href="#Repository"><repository></a>
- <a href="#Repository"><id/></a>
- <a href="#Repository"><name/></a>
- <a href="#Repository"><url/></a>
- <a href="#Repository"><snapshotPolicy/></a>
- <a href="#Repository"><layout/></a>
- <a href="#Repository"><repository></a>
- <a href="#repositories"></repositories></a>
- <a href="#pluginRepositories"><pluginRepositories></a>
- <a href="#Repository"><repository></a>
- <a href="#Repository"><id/></a>
- <a href="#Repository"><name/></a>
- <a href="#Repository"><url/></a>
- <a href="#Repository"><snapshotPolicy/></a>
- <a href="#Repository"><layout/></a>
- <a href="#Repository"><repository></a>
- <a href="#pluginRepositories"></pluginRepositories></a>
- <a href="#mailingLists"><mailingLists></a>
- <a href="#MailingList"><mailingList></a>
- <a href="#MailingList"><name/></a>
- <a href="#MailingList"><subscribe/></a>
- <a href="#MailingList"><unsubscribe/></a>
- <a href="#MailingList"><post/></a>
- <a href="#MailingList"><archive/></a>
- <a href="#MailingList"><otherArchives/></a>
- <a href="#MailingList"><mailingList></a>
- <a href="#mailingLists"></mailingLists></a>
- <a href="#developers"><developers></a>
- <a href="#Developer"><developer></a>
- <a href="#Developer"><id/></a>
- <a href="#Developer"><developer></a>
- <a href="#developers"></developers></a>
- <a href="#contributors"><contributors></a>
- <a href="#Contributor"><contributor></a>
- <a href="#Contributor"><name/></a>
- <a href="#Contributor"><email/></a>
- <a href="#Contributor"><url/></a>
- <a href="#Contributor"><organization/></a>
- <a href="#Contributor"><roles/></a>
- <a href="#Contributor"><timezone/></a>
- <a href="#Contributor"><contributor></a>
- <a href="#contributors"></contributors></a>
- <a href="#dependencies"><dependencies></a>
- <a href="#Dependency"><dependency></a>
- <a href="#Dependency"><groupId/></a>
- <a href="#Dependency"><artifactId/></a>
- <a href="#Dependency"><version/></a>
- <a href="#Dependency"><type/></a>
- <a href="#Dependency"><scope/></a>
- <a href="#Dependency"><dependency></a>
- <a href="#dependencies"></dependencies></a>
- <a href="#licenses"><licenses></a>
- <a href="#License"><license></a>
- <a href="#License"><name/></a>
- <a href="#License"><url/></a>
- <a href="#License"><comments/></a>
- <a href="#License"><license></a>
- <a href="#licenses"></licenses></a>
- <a href="#Reports"><reports></a>
- <a href="#Reports"><outputDirectory/></a>
- <a href="#plugins"><plugins></a>
- <a href="#Plugin"><plugin></a>
- <a href="#Plugin"><groupId/></a>
- <a href="#Plugin"><artifactId/></a>
- <a href="#Plugin"><version/></a>
- <a href="#Plugin"><configuration/></a>
- <a href="#goals"><goals></a>
- <a href="#Goal"><goal></a>
- <a href="#Goal"><id/></a>
- <a href="#Goal"><configuration/></a>
- <a href="#Goal"><goal></a>
- <a href="#goals"></goals></a>
- <a href="#Plugin"><plugin></a>
- <a href="#plugins"></plugins></a>
- <a href="#Reports"><reports></a>
- <a href="#Scm"><scm></a>
- <a href="#Scm"><connection/></a>
- <a href="#Scm"><developerConnection/></a>
- <a href="#Scm"><url/></a>
- <a href="#Scm"><scm></a>
- <a href="#Build"><build></a>
- <a href="#Build"><sourceDirectory/></a>
- <a href="#Build"><scriptSourceDirectory/></a>
- <a href="#Build"><testSourceDirectory/></a>
- <a href="#resources"><resources></a>
- <a href="#Resource"><resource></a>
- <a href="#Resource"><targetPath/></a>
- <a href="#Resource"><resource></a>
- <a href="#resources"></resources></a>
- <a href="#testResources"><testResources></a>
- <a href="#Resource"><resource></a>
- <a href="#Resource"><targetPath/></a>
- <a href="#Resource"><resource></a>
- <a href="#testResources"></testResources></a>
- <a href="#Build"><directory/></a>
- <a href="#Build"><outputDirectory/></a>
- <a href="#Build"><finalName/></a>
- <a href="#Build"><testOutputDirectory/></a>
- <a href="#plugins"><plugins></a>
- <a href="#Plugin"><plugin></a>
- <a href="#Plugin"><groupId/></a>
- <a href="#Plugin"><artifactId/></a>
- <a href="#Plugin"><version/></a>
- <a href="#Plugin"><configuration/></a>
- <a href="#goals"><goals></a>
- <a href="#Goal"><goal></a>
- <a href="#Goal"><id/></a>
- <a href="#Goal"><configuration/></a>
- <a href="#Goal"><goal></a>
- <a href="#goals"></goals></a>
- <a href="#Plugin"><plugin></a>
- <a href="#plugins"></plugins></a>
- <a href="#PluginManagement"><pluginManagement></a>
- <a href="#plugins"><plugins></a>
- <a href="#Plugin"><plugin></a>
- <a href="#Plugin"><groupId/></a>
- <a href="#Plugin"><artifactId/></a>
- <a href="#Plugin"><version/></a>
- <a href="#Plugin"><configuration/></a>
- <a href="#goals"><goals></a>
- <a href="#Goal"><goal></a>
- <a href="#Goal"><id/></a>
- <a href="#Goal"><configuration/></a>
- <a href="#Goal"><goal></a>
- <a href="#goals"></goals></a>
- <a href="#Plugin"><plugin></a>
- <a href="#plugins"></plugins></a>
- <a href="#PluginManagement"><pluginManagement></a>
- <a href="#Build"><build></a>
- <a href="#Organization"><organization></a>
- <a href="#Organization"><name/></a>
- <a href="#Organization"><url/></a>
- <a href="#Organization"><organization></a>
- <a
href="#DistributionManagement"><distributionManagement></a>
- <a href="#Repository"><repository></a>
- <a href="#Repository"><id/></a>
- <a href="#Repository"><name/></a>
- <a href="#Repository"><url/></a>
- <a href="#Repository"><snapshotPolicy/></a>
- <a href="#Repository"><layout/></a>
- <a href="#Repository"><repository></a>
- <a href="#Site"><site></a>
- <a href="#Site"><id/></a>
- <a href="#Site"><name/></a>
- <a href="#Site"><url/></a>
- <a href="#Site"><site></a>
- <a
href="#DistributionManagement"><distributionManagement></a>
- <a href="#DependencyManagement"><dependencyManagement></a>
- <a href="#dependencies"><dependencies></a>
- <a href="#Dependency"><dependency></a>
- <a href="#Dependency"><groupId/></a>
- <a href="#Dependency"><artifactId/></a>
- <a href="#Dependency"><version/></a>
- <a href="#Dependency"><type/></a>
- <a href="#Dependency"><scope/></a>
- <a href="#Dependency"><dependency></a>
- <a href="#dependencies"></dependencies></a>
- <a href="#DependencyManagement"><dependencyManagement></a>
- <a href="#Model"><model></a>
- </source>
+<a href="#Model"><model></a>
+<a href="#Parent"><parent></a>
+<a href="#Parent"><artifactId/></a>
+<a href="#Parent"><groupId/></a>
+<a href="#Parent"><version/></a>
+<a href="#Parent"><parent></a>
+<a href="#Model"><modelVersion/></a>
+<a href="#Model"><groupId/></a>
+<a href="#Model"><artifactId/></a>
+<a href="#Model"><packaging/></a>
+<a href="#Model"><modules/></a>
+<a href="#Model"><name/></a>
+<a href="#Model"><version/></a>
+<a href="#Model"><description/></a>
+<a href="#Model"><url/></a>
+<a href="#IssueManagement"><issueManagement></a>
+<a href="#IssueManagement"><system/></a>
+<a href="#IssueManagement"><url/></a>
+<a href="#IssueManagement"><issueManagement></a>
+<a href="#CiManagement"><ciManagement></a>
+<a href="#CiManagement"><system/></a>
+<a href="#CiManagement"><url/></a>
+<a href="#notifiers"><notifiers></a>
+<a href="#Notifier"><notifier></a>
+<a href="#Notifier"><type/></a>
+<a href="#Notifier"><address/></a>
+<a href="#Notifier"><configuration/></a>
+<a href="#Notifier"><notifier></a>
+<a href="#notifiers"></notifiers></a>
+<a href="#CiManagement"><ciManagement></a>
+<a href="#Model"><inceptionYear/></a>
+<a href="#repositories"><repositories></a>
+<a href="#Repository"><repository></a>
+<a href="#Repository"><id/></a>
+<a href="#Repository"><name/></a>
+<a href="#Repository"><url/></a>
+<a href="#Repository"><snapshotPolicy/></a>
+<a href="#Repository"><layout/></a>
+<a href="#Repository"><repository></a>
+<a href="#repositories"></repositories></a>
+<a href="#pluginRepositories"><pluginRepositories></a>
+<a href="#Repository"><repository></a>
+<a href="#Repository"><id/></a>
+<a href="#Repository"><name/></a>
+<a href="#Repository"><url/></a>
+<a href="#Repository"><snapshotPolicy/></a>
+<a href="#Repository"><layout/></a>
+<a href="#Repository"><repository></a>
+<a href="#pluginRepositories"></pluginRepositories></a>
+<a href="#mailingLists"><mailingLists></a>
+<a href="#MailingList"><mailingList></a>
+<a href="#MailingList"><name/></a>
+<a href="#MailingList"><subscribe/></a>
+<a href="#MailingList"><unsubscribe/></a>
+<a href="#MailingList"><post/></a>
+<a href="#MailingList"><archive/></a>
+<a href="#MailingList"><otherArchives/></a>
+<a href="#MailingList"><mailingList></a>
+<a href="#mailingLists"></mailingLists></a>
+<a href="#developers"><developers></a>
+<a href="#Developer"><developer></a>
+<a href="#Developer"><id/></a>
+<a href="#Developer"><developer></a>
+<a href="#developers"></developers></a>
+<a href="#contributors"><contributors></a>
+<a href="#Contributor"><contributor></a>
+<a href="#Contributor"><name/></a>
+<a href="#Contributor"><email/></a>
+<a href="#Contributor"><url/></a>
+<a href="#Contributor"><organization/></a>
+<a href="#Contributor"><roles/></a>
+<a href="#Contributor"><timezone/></a>
+<a href="#Contributor"><contributor></a>
+<a href="#contributors"></contributors></a>
+<a href="#dependencies"><dependencies></a>
+<a href="#Dependency"><dependency></a>
+<a href="#Dependency"><groupId/></a>
+<a href="#Dependency"><artifactId/></a>
+<a href="#Dependency"><version/></a>
+<a href="#Dependency"><type/></a>
+<a href="#Dependency"><scope/></a>
+<a href="#Dependency"><dependency></a>
+<a href="#dependencies"></dependencies></a>
+<a href="#licenses"><licenses></a>
+<a href="#License"><license></a>
+<a href="#License"><name/></a>
+<a href="#License"><url/></a>
+<a href="#License"><comments/></a>
+<a href="#License"><license></a>
+<a href="#licenses"></licenses></a>
+<a href="#Reports"><reports></a>
+<a href="#Reports"><outputDirectory/></a>
+<a href="#plugins"><plugins></a>
+<a href="#Plugin"><plugin></a>
+<a href="#Plugin"><groupId/></a>
+<a href="#Plugin"><artifactId/></a>
+<a href="#Plugin"><version/></a>
+<a href="#Plugin"><configuration/></a>
+<a href="#goals"><goals></a>
+<a href="#Goal"><goal></a>
+<a href="#Goal"><id/></a>
+<a href="#Goal"><configuration/></a>
+<a href="#Goal"><goal></a>
+<a href="#goals"></goals></a>
+<a href="#Plugin"><plugin></a>
+<a href="#plugins"></plugins></a>
+<a href="#Reports"><reports></a>
+<a href="#Scm"><scm></a>
+<a href="#Scm"><connection/></a>
+<a href="#Scm"><developerConnection/></a>
+<a href="#Scm"><url/></a>
+<a href="#Scm"><scm></a>
+<a href="#Build"><build></a>
+<a href="#Build"><sourceDirectory/></a>
+<a href="#Build"><scriptSourceDirectory/></a>
+<a href="#Build"><testSourceDirectory/></a>
+<a href="#resources"><resources></a>
+<a href="#Resource"><resource></a>
+<a href="#Resource"><targetPath/></a>
+<a href="#Resource"><resource></a>
+<a href="#resources"></resources></a>
+<a href="#testResources"><testResources></a>
+<a href="#Resource"><resource></a>
+<a href="#Resource"><targetPath/></a>
+<a href="#Resource"><resource></a>
+<a href="#testResources"></testResources></a>
+<a href="#Build"><directory/></a>
+<a href="#Build"><outputDirectory/></a>
+<a href="#Build"><finalName/></a>
+<a href="#Build"><testOutputDirectory/></a>
+<a href="#plugins"><plugins></a>
+<a href="#Plugin"><plugin></a>
+<a href="#Plugin"><groupId/></a>
+<a href="#Plugin"><artifactId/></a>
+<a href="#Plugin"><version/></a>
+<a href="#Plugin"><configuration/></a>
+<a href="#goals"><goals></a>
+<a href="#Goal"><goal></a>
+<a href="#Goal"><id/></a>
+<a href="#Goal"><configuration/></a>
+<a href="#Goal"><goal></a>
+<a href="#goals"></goals></a>
+<a href="#Plugin"><plugin></a>
+<a href="#plugins"></plugins></a>
+<a href="#PluginManagement"><pluginManagement></a>
+<a href="#plugins"><plugins></a>
+<a href="#Plugin"><plugin></a>
+<a href="#Plugin"><groupId/></a>
+<a href="#Plugin"><artifactId/></a>
+<a href="#Plugin"><version/></a>
+<a href="#Plugin"><configuration/></a>
+<a href="#goals"><goals></a>
+<a href="#Goal"><goal></a>
+<a href="#Goal"><id/></a>
+<a href="#Goal"><configuration/></a>
+<a href="#Goal"><goal></a>
+<a href="#goals"></goals></a>
+<a href="#Plugin"><plugin></a>
+<a href="#plugins"></plugins></a>
+<a href="#PluginManagement"><pluginManagement></a>
+<a href="#Build"><build></a>
+<a href="#Organization"><organization></a>
+<a href="#Organization"><name/></a>
+<a href="#Organization"><url/></a>
+<a href="#Organization"><organization></a>
+<a href="#DistributionManagement"><distributionManagement></a>
+<a href="#Repository"><repository></a>
+<a href="#Repository"><id/></a>
+<a href="#Repository"><name/></a>
+<a href="#Repository"><url/></a>
+<a href="#Repository"><snapshotPolicy/></a>
+<a href="#Repository"><layout/></a>
+<a href="#Repository"><repository></a>
+<a href="#Site"><site></a>
+<a href="#Site"><id/></a>
+<a href="#Site"><name/></a>
+<a href="#Site"><url/></a>
+<a href="#Site"><site></a>
+<a href="#DistributionManagement"><distributionManagement></a>
+<a href="#DependencyManagement"><dependencyManagement></a>
+<a href="#dependencies"><dependencies></a>
+<a href="#Dependency"><dependency></a>
+<a href="#Dependency"><groupId/></a>
+<a href="#Dependency"><artifactId/></a>
+<a href="#Dependency"><version/></a>
+<a href="#Dependency"><type/></a>
+<a href="#Dependency"><scope/></a>
+<a href="#Dependency"><dependency></a>
+<a href="#dependencies"></dependencies></a>
+<a href="#DependencyManagement"><dependencyManagement></a>
+<a href="#Model"><model></a></source>
</p>
<section name="Model">
<p>
1.1
maven-components/maven-site/src/site/xdoc/settings-descriptor.xml
Index: settings-descriptor.xml
===================================================================
<?xml version="1.0"?>
<document>
<properties>
<author email="[EMAIL PROTECTED]">Maven Development Team</author>
<title>Maven Model Documentation</title>
</properties>
<body>
<section name="Descriptor with links">
<p>
<source>
<a href="#Settings"><settings></a>
<a href="#jdks"><jdks></a>
<a href="#Jdk"><jdk></a>
<a href="#Jdk"><active/></a>
<a href="#Jdk"><version/></a>
<a href="#Jdk"><javaHome/></a>
<a href="#Jdk"><jdk></a>
<a href="#jdks"></jdks></a>
<a href="#proxies"><proxies></a>
<a href="#Proxy"><proxy></a>
<a href="#Proxy"><active/></a>
<a href="#Proxy"><protocol/></a>
<a href="#Proxy"><username/></a>
<a href="#Proxy"><password/></a>
<a href="#Proxy"><port/></a>
<a href="#Proxy"><host/></a>
<a href="#Proxy"><nonProxyHosts/></a>
<a href="#Proxy"><proxy></a>
<a href="#proxies"></proxies></a>
<a href="#servers"><servers></a>
<a href="#Server"><server></a>
<a href="#Server"><id/></a>
<a href="#Server"><username/></a>
<a href="#Server"><password/></a>
<a href="#Server"><privateKey/></a>
<a href="#Server"><passphrase/></a>
<a href="#Server"><server></a>
<a href="#servers"></servers></a>
<a href="#profiles"><profiles></a>
<a href="#Profile"><profile></a>
<a href="#Profile"><active/></a>
<a href="#Profile"><localRepository/></a>
<a href="#Profile"><passwordStore/></a>
<a href="#Profile"><profile></a>
<a href="#profiles"></profiles></a>
<a href="#Settings"><settings></a></source>
</p>
<section name="Settings">
<p>
<table>
<tr>
<th>Element</th>
<th>Description</th>
</tr>
<tr>
<td>jdks</td>
<td>
Configuration for different java environment profiles. One good
use
for this might be to configure both JDK 1.4 and JDK 1.5 to work
with
maven. Profiles will allow switching of entire java environments
based on the profile id, either in the defaults section below, or
on
the command line.
</td>
</tr>
<tr>
<td>proxies</td>
<td>
Configuration for different proxy profiles. Multiple proxy
profiles
might come in handy for anyone working from a notebook or other
mobile platform, to enable easy switching of entire proxy
configurations by simply specifying the profile id, again either
from
the command line or from the defaults section below.
</td>
</tr>
<tr>
<td>servers</td>
<td>
Configuration of server-specific settings, mainly authentication
method. This allows configuration of authentication on a
per-server
basis.
</td>
</tr>
<tr>
<td>profiles</td>
<td>
Configuration for different runtime profiles for maven itself.
For
example, this will allow plugin developers to switch from a "work"
local repository to a "testing" local repository. It may also
allow
configuration of such things as password keystore, etc. Once
again,
the active profile will be switchable via either the defaults
section
or the command line (read: system properties).
</td>
</tr>
</table>
</p>
</section>
<section name="Jdk">
<p>
<table>
<tr>
<th>Element</th>
<th>Description</th>
</tr>
<tr>
<td>active</td>
<td>Whether this JDK is the active one.</td>
</tr>
<tr>
<td>version</td>
<td>The JDK major version (eg. '1.4').</td>
</tr>
<tr>
<td>javaHome</td>
<td>The JDK home.</td>
</tr>
</table>
</p>
</section>
<section name="Proxy">
<p>
<table>
<tr>
<th>Element</th>
<th>Description</th>
</tr>
<tr>
<td>active</td>
<td>Whether this proxy configuration is the active one.</td>
</tr>
<tr>
<td>protocol</td>
<td>The proxy protocol.</td>
</tr>
<tr>
<td>username</td>
<td>The proxy user.</td>
</tr>
<tr>
<td>password</td>
<td>The proxy password.</td>
</tr>
<tr>
<td>port</td>
<td>The proxy port.</td>
</tr>
<tr>
<td>host</td>
<td>The proxy host.</td>
</tr>
<tr>
<td>nonProxyHosts</td>
<td>
The list of non-proxied hosts (usually
comma-delimited).
</td>
</tr>
</table>
</p>
</section>
<section name="Server">
<p>
<table>
<tr>
<th>Element</th>
<th>Description</th>
</tr>
<tr>
<td>id</td>
<td>
The ID of this configuration for indicating the default or
"active"
profile.
</td>
</tr>
<tr>
<td>username</td>
<td>The username used to authenticate.</td>
</tr>
<tr>
<td>password</td>
<td>
The password used in conjunction with the username to
authenticate.
</td>
</tr>
<tr>
<td>privateKey</td>
<td>The private key location used to authenticate.</td>
</tr>
<tr>
<td>passphrase</td>
<td>
The passphrase used in conjunction with the privateKey to
authenticate.
</td>
</tr>
</table>
</p>
</section>
<section name="Profile">
<p>
<table>
<tr>
<th>Element</th>
<th>Description</th>
</tr>
<tr>
<td>active</td>
<td>Whether this is the active maven profile.</td>
</tr>
<tr>
<td>localRepository</td>
<td>The local repository.</td>
</tr>
<tr>
<td>passwordStore</td>
<td>The keystore used to store passwords.</td>
</tr>
</table>
</p>
</section>
</section>
</body>
</document>
