diff --git a/docs/content/docs.md b/docs/content/docs.md
index 9fdfbf750..4afa72cb0 100644
--- a/docs/content/docs.md
+++ b/docs/content/docs.md
@@ -501,6 +501,12 @@ to reduce the value so rclone moves on to a high level retry (see the
 
 Disable low level retries with `--low-level-retries 1`.
 
+### --max-delete=N ###
+
+This tells rclone not to delete more than N files.  If that limit is
+exceeded then a fatal error will be generated and rclone will stop the
+operation in progress.
+
 ### --max-depth=N ###
 
 This modifies the recursion depth for all the commands except purge.