Author: brett
Date: Wed Mar 11 11:36:53 2009
New Revision: 752426
URL: http://svn.apache.org/viewvc?rev=752426&view=rev
Log:
add settings to installation instructions
Modified:
maven/site/trunk/src/site/apt/download.apt.vm
Modified: maven/site/trunk/src/site/apt/download.apt.vm
URL:
http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/download.apt.vm?rev=752426&r1=752425&r2=752426&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/download.apt.vm (original)
+++ maven/site/trunk/src/site/apt/download.apt.vm Wed Mar 11 11:36:53 2009
@@ -69,6 +69,8 @@
<Maven is a Java tool, so you must have {{{http://java.sun.com}Java}}
installed in order to proceed. More precisely,
you need a Java Development Kit (JDK), the Java Runtime Environment (JRE) is
not sufficient.>
+ Additional optional installation steps are listed after the platform
specific instructions.
+
~~ NOTE:
~~ At least Windows users seem to be confused if the instructions contain
quotation marks because people included them
~~ literally in the environment variables which does not work. For this
reason, literal values are only printed using
@@ -119,3 +121,28 @@
<<<export JAVA_HOME=/usr/java/jdk1.5.0_02>>> and that
<<<$JAVA_HOME/bin>>> is in your <<<PATH>>> environment variable.
[[7]] Run <<<mvn --version>>> to verify that it is correctly installed.
+
+** Optional configuration
+
+ Maven will work for most tasks with the above configuration, however if you
have any environmental specific configuration outside of individual
+ projects then you will need to configure settings. The following sections
refer to what is available.
+
+*** Settings
+
+ Maven has a settings file located in the Maven installation and/or user home
directory that configure environmental specifics such as:
+
+ * HTTP proxy server
+
+ * repository manager location
+
+ * server authentication and passwords
+
+ * other configuration properties
+
+ For information on this file, see the {{{settings.html} Settings reference}}
+
+*** Security
+
+ As of Maven 2.1.0+, you can encrypt passwords in your settings file, however
you must first configure a master password. For more information on
+ both server passwords and the master password, see the
{{{guides/mini/guide-encryption.html} Guide to password encryption}}.
+
