svn commit: r783773 - /maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt

[be...@apache.org]

Author: bentmann
Date: Thu Jun 11 13:58:30 2009
New Revision: 783773

URL: http://svn.apache.org/viewvc?rev=783773&view=rev
Log:
[MNG-2562] expose current time as a property for POM interpolation

o Added documentation

Modified:
    maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt

Modified: maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt
URL: http://svn.apache.org/viewvc/maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt?rev=783773&r1=783772&r2=783773&view=diff
==============================================================================
--- maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt (original)
+++ maven/site/trunk/src/site/apt/guides/introduction/introduction-to-the-pom.apt Thu Jun 11 13:58:30 2009
@@ -40,7 +40,7 @@
 
   * {{{./introduction-to-the-pom.html#Project_Interpolation}Project Interpolation and Expressions}}
 
-    * {{{./introduction-to-the-pom.html#Available_Expressions}Available Expressions}}
+    * {{{./introduction-to-the-pom.html#Available_Variables}Available Variables}}
 
     []
 
@@ -489,13 +489,32 @@
 
   These variables are all referenced by the prefix "<<<project.>>>". You may also see references with <<<pom.>>> as the prefix, or the prefix omitted entirely - these forms are now deprecated and should not be used.
 
-*** Special Project Variables
+*** Special Variables
 
 *-----------------------------------+--------------------------------------+
 | <<<basedir>>>                     | The directory that the current project resides in. |
 *-----------------------------------+--------------------------------------+
-| <<<project.baseUri>>>             | The directory that the current project resides in, represented as an URI. |
+| <<<project.baseUri>>>             | The directory that the current project resides in, represented as an URI. <Since Maven 2.1.0> |
 *-----------------------------------+--------------------------------------+
+| <<<maven.build.timestamp>>>       | The timestamp that denotes the start of the build. <Since Maven 2.1.0-M1> |
+*-----------------------------------+--------------------------------------+
+
+  The format of the build timestamp can be customized by declaring the property <<<maven.build.timestamp.format>>> as
+  shown in the example below:
+
++----+
+<project>
+  ...
+  <properties>
+    <maven.build.timestamp.format>yyyyMMdd-HHmm</maven.build.timestamp.format>
+  </properties>
+  ...
+</project>
++----+
+
+  The format pattern has to comply with the rules given in the API documentation for
+  {{{http://java.sun.com/javase/6/docs/api/java/text/SimpleDateFormat.html}SimpleDateFormat}}.
+  If the property is not present, the format defaults to the value already given in the example.
 
 *** Properties