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
