svn commit: r1364633 - in /maven/site/trunk/src/site/apt/guides/getting-started: maven-in-five-minutes.apt windows-prerequisites.apt

[bi...@apache.org]

Author: bimargulies
Date: Mon Jul 23 13:55:05 2012
New Revision: 1364633

URL: http://svn.apache.org/viewvc?rev=1364633&view=rev
Log:
Try to make it even clearer how to get Maven working on WIndows.

Added:
    maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt   (with props)
Modified:
    maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt

Modified: maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt?rev=1364633&r1=1364632&r2=1364633&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt (original)
+++ maven/site/trunk/src/site/apt/guides/getting-started/maven-in-five-minutes.apt Mon Jul 23 13:55:05 2012
@@ -10,7 +10,8 @@ Maven in 5 Minutes
 
 * Installation
 
-  <Maven is a Java tool, so you must have {{{http://java.sun.com}Java}} installed in order to proceed.>
+  <Maven is a Java tool, so you must have {{{http://www.oracle.com/technetwork/java/javase/downloads/index.html}Java}}
+ installed in order to proceed.>
 
   First, {{{../../download.html}download Maven}} and follow the {{{../../download.html#Installation}installation instructions}}.
   After that, type the following in a terminal or in a command prompt:
@@ -33,6 +34,9 @@ OS name: "windows 7", version: "6.1", ar
   Depending upon your network setup, you may require extra configuration. Check out the
   {{{../mini/guide-configuring-maven.html}Guide to Configuring Maven}} if necessary.
 
+  <<If you are using Windows, you should look at>> {{{./windows-prerequisites.html}Windows Prerequisites}}
+  <<to ensure that you are prepared to use Maven on Windows.>>
+
 * Creating a Project
 
   On your command line, execute the following Maven goal:

Added: maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt?rev=1364633&view=auto
==============================================================================
--- maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt (added)
+++ maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt Mon Jul 23 13:55:05 2012
@@ -0,0 +1,44 @@
+ ----
+ Maven on Windows
+ -----
+ Benson Margulies
+ -----
+ July 2012
+ -----
+
+Maven on Windows
+
+  Maven is a command-line tool for building Java (and other) programs. The Maven project provides a simple ZIP 
+  file containing a precompiled version of Maven for your convenience. There is no installer. It's up to you
+  to set up your prerequisites and environment to run Maven on Windows.
+
+* Spaces in Pathnames
+
+  Maven, like many cross-platform tools, can encounter problems when there are space characters in important pathnames.
+  The instructions below will remind you of this for several particular items.
+
+* Prerequisites
+
+  Maven is written in Java (and primarily used to build Java programs). Thus, the major prerequisite is the Java SDK.
+  You need to install the Java SDK (e.g. from {{http://www.oracle.com/technetwork/java/javase/downloads/index.html}
+  Oracle's download site}}, and you should install it to a pathname without spaces, such as <<<c:\j2se1.6>>>.
+
+  Once Java is installed, you must ensure that the commands from the Java SDK are in your PATH environment variable.
+  Running, for example,
+
++-------+
+java -version
++-------+
+
+  must show the right version number.
+
+* Maven Unpacked
+
+  You need to unpack the Maven distribution. Don't unpack it in the middle of your source code; pick some location
+  (with no spaces in the path!) and unpack it there. Let's assume that the path is <<<c:\mvn3.0.4>>>.
+
+* Maven in PATH
+
+  You run Maven by invoking a command-line tool: <<<mvn.bat>>> from the <<<bin>>> directory of the Maven. To do this conveniently,
+  <<<c:\mvn3.0.4\bin>>> must be in your PATH, just like the J2SE SDK commands. You can add directories to your PATH
+  in the control panel; the details vary by Windows version.

Propchange: maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt
------------------------------------------------------------------------------
    svn:eol-style = native

Propchange: maven/site/trunk/src/site/apt/guides/getting-started/windows-prerequisites.apt
------------------------------------------------------------------------------
    svn:mime-type = text/plain