svn commit: r799533 - /maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt

[lt...@apache.org]

Author: ltheussl
Date: Fri Jul 31 07:41:25 2009
New Revision: 799533

URL: http://svn.apache.org/viewvc?rev=799533&view=rev
Log:
[MSITE-177] Document: changing site.xml requires a clean build

Modified:
    maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt

Modified: maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt
URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt?rev=799533&r1=799532&r2=799533&view=diff
==============================================================================
--- maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt (original)
+++ maven/plugins/trunk/maven-site-plugin/src/site/apt/usage.apt Fri Jul 31 07:41:25 2009
@@ -55,6 +55,14 @@
   '<<<mvn site:stage>>>' instead. You can read more about that goal further down on
   this page in the section called '<Staging a Site>'.
 
+  <<Note:>> For peformance reasons, Maven compares the timestamps of generated
+  files and corresponding source documents, and only regenerates documents
+  that have changed since the last build.
+  However, this only applies to documentation source documents (apt, xdoc,...).
+  If you change anything in your <<<site.xml>>>, any relevant sections in your
+  pom, or any relevant properties or resource files, you should generate the
+  site from scratch to make sure all references and links are correct.
+
 * Deploying a Site
 
   To be able to deploy the site, you must first specify where the site will be