diff --git a/doc_src/cmds/complete.rst b/doc_src/cmds/complete.rst
index 9133ecf42..5c5784a3a 100644
--- a/doc_src/cmds/complete.rst
+++ b/doc_src/cmds/complete.rst
@@ -53,6 +53,8 @@ The following options are available:
 
 **-r** or **--require-parameter**
     This completion must have an option argument, i.e. may not be followed by another option.
+    This means that the next argument is the argument to the option.
+    If this is *not* given, the option argument must be attached like ``-xFoo`` or ``--color=auto``.
 
 **-x** or **--exclusive**
     Short for **-r** and **-f**.