diff --git a/cruisecontrol/xdocs/changes.xml b/cruisecontrol/xdocs/changes.xml
index 6c5e55e3..27f78afd 100644
--- a/cruisecontrol/xdocs/changes.xml
+++ b/cruisecontrol/xdocs/changes.xml
@@ -26,6 +26,7 @@
+ Deprecate the cruisecontrol:run goal. It doesn't work with recent versions of cruisecontrol.
Replace deprecated <currentbuildstatusbootstrapper>, <currentbuildstatuspublisher> and <currentbuildstatusftppublisher> by <currentbuildstatuslistener> and <currentbuildstatusftplistener>.
Add missing documentation for several properties.
Default for maven.cruisecontrol.logs.mergedirectory is incorrect on the Properties page.
diff --git a/cruisecontrol/xdocs/goals.xml b/cruisecontrol/xdocs/goals.xml
index b16d4eba..714d5fdb 100644
--- a/cruisecontrol/xdocs/goals.xml
+++ b/cruisecontrol/xdocs/goals.xml
@@ -34,7 +34,13 @@
cruisecontrol:run
- Run Cruise Control
+
+ Run Cruise Control.
+ DEPRECATED: this goal does not work anymore
+ with recent versions of cruisecontrol. It is recommended to
+ start cruisecontrol with one of the scripts provided
+ in the distribution.
+
cruisecontrol:install-local