From 9fafae7a8a3656c20dadf533ed0c2d056b4b5b88 Mon Sep 17 00:00:00 2001
From: Fabian Boehm <FHomborg@gmail.com>
Date: Sun, 15 Sep 2024 09:44:09 +0200
Subject: [PATCH] docs/complete: Explain `-r` a bit better

---
 doc_src/cmds/complete.rst | 2 ++
 1 file changed, 2 insertions(+)

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**.