svn commit: r1647903 - /maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm

[mi...@apache.org]

Author: michaelo
Date: Thu Dec 25 15:37:30 2014
New Revision: 1647903

URL: http://svn.apache.org/r1647903
Log:
[MSITE-708] Doc about filtering incorrect about macros rules

Modified:
    maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm

Modified: maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm?rev=1647903&r1=1647902&r2=1647903&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/apt/examples/creating-content.apt.vm Thu Dec 25 15:37:30 2014
@@ -165,9 +165,9 @@ Creating Content
   property set in the
   {{{http://svn.apache.org/repos/asf/maven/site/trunk/pom.xml}POM}}.
 
-  <<Note:>> {{{http://velocity.apache.org/}Velocity}} is used to apply the
-  filtering. Because Velocity uses a dot-notation internally you can <<not>>
-  use dots in your properties.
+  <<Note:>> {{{http://velocity.apache.org/}Apache Velocity}} is used to apply the
+  filtering. Because Velocity uses a dot-notation to traverse beans you can <<not>>
+  use dots in your properties defined in <<<\<properties\>>>>.
 
   If you declare these properties in your POM
 
@@ -182,11 +182,12 @@ Creating Content
 
   and then use the expression <<<$\{my.property\}>>> in your document, it will
   <<not>> work. If you instead use the expression <<<$\{myProperty\}>>> it will
-  work just fine.
+  work just fine. Alternatively, you can say <<<${project.properties.get("my.property")}>>>
+  which is cumbersome to write.
 
   Some properties are defined by default: see
   {{{/doxia/doxia-sitetools/doxia-site-renderer/#Velocity_processing} Doxia Site Renderer's Velocity processing reference}}
-  for more information. 
+  for more information. For a complete usage overview, see Velocity's {{{http://velocity.apache.org/engine/devel/user-guide.html}user guide}}.
 
 * Internationalization