svn commit: r1346704 - /maven/site/trunk/src/site/apt/pom.apt

[hb...@apache.org]

Author: hboutemy
Date: Wed Jun  6 01:56:15 2012
New Revision: 1346704

URL: http://svn.apache.org/viewvc?rev=1346704&view=rev
Log:
[MNGSITE-136] improved POM reference for <properties> which was found misleading

Modified:
    maven/site/trunk/src/site/apt/pom.apt

Modified: maven/site/trunk/src/site/apt/pom.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/pom.apt?rev=1346704&r1=1346703&r2=1346704&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/pom.apt (original)
+++ maven/site/trunk/src/site/apt/pom.apt Wed Jun  6 01:56:15 2012
@@ -568,14 +568,16 @@ mvn install:install-file -Dfile=non-mave
   Properties are the last required piece in understanding POM basics. Maven properties
   are value placeholder, like properties in Ant. Their values are accessible anywhere
   within a POM by using the notation <<<$\{X\}>>>, where <<<X>>> is the property.
+
   They come in five different styles:
 
   [[1]]  <<<env.X>>>: Prefixing a variable with "env." will return the shell's environment variable. For example,
   <<<$\{env.PATH\}>>> contains the PATH environment variable.
+
   <Note:> While environment variables themselves are case-insensitive on Windows, lookup of properties is
   case-sensitive. In other words, while the Windows shell returns the same value for <<<%PATH%>>> and <<<%Path%>>>,
-  Maven distinguishes between <<<$\{env.PATH\}>>> and <<<$\{env.Path\}>>>. As of Maven 2.1.0, the names of environment
-  variables are normalized to all upper-case for the sake of reliability.
+  Maven distinguishes between <<<$\{env.PATH\}>>> and <<<$\{env.Path\}>>>. As of Maven 2.1.0, <<the names of environment
+  variables are normalized to all upper-case>> for the sake of reliability.
 
   [[2]]  <<<project.x>>>: A dot (.) notated path in the POM will contain the corresponding element's value.
   For example: <<<\<project\>\<version\>1.0\</version\>\</project\>>>> is accessible via
@@ -588,7 +590,8 @@ mvn install:install-file -Dfile=non-mave
   [[4]]  Java System Properties: All properties accessible via <<<java.lang.System.getProperties()>>> are
   available as POM properties, such as <<<$\{java.home\}>>>.
 
-  [[5]]  <<<x>>>: Set within a \<properties /\> element. The value may be used as <<<$\{someVar\}>>>.
+  [[5]]  <<<x>>>: Set within a <<<\<properties /\>>>> element in the POM. The value of
+  <<<\<properties\>\<someVar\>value\</someVar\>\</properies\>>>> may be used as <<<$\{someVar\}>>>.
 
   []