Index: xdocs/using/managing-dependencies.xml =================================================================== --- xdocs/using/managing-dependencies.xml (revision 328913) +++ xdocs/using/managing-dependencies.xml (working copy) @@ -115,10 +115,19 @@
Assuming that project is publishing a version called SNAPSHOT (which happens when the
jar:deploy-snapshot goal is called), then each time you build Maven will check the remote
- repository for changes in that JAR and download it again if a newer version is available.
+ repository for changes in that JAR and download it again if a newer SNAPSHOT is available.
+ Note: It seems to be a common misconception that Maven would
+ replace SNAPSHOT by the most current version of a project
+ that is available in the repository. This is not the case: using a
+ SNAPSHOT dependency requires that the project that you
+ depend on has actually published a SNAPSHOT,
+ and only this SNAPSHOT will get updated automatically.
+
If you are working offline Maven will warn you that your SNAPSHOT dependencies may be out of date. This is just a warning, and as the remote copy often does not change frequently can be ignored.