2 files changed, 8 insertions, 14 deletions
diff --git a/doc/ranger.1 b/doc/ranger.1
index 10a5e765..c5bef68f 100644
--- a/doc/ranger.1
+++ b/doc/ranger.1
@@ -433,13 +433,10 @@ the end of the line automatically.
 .PP
 To write a literal %, you need to escape it by writing %%.
 .PP
-For adding a space character after a chained command, you also need to escape
-% by writing %% instead:
- chain command1 %%space; command2
-.PP
-This is because the chain command is a macro-expanding command itself. In the
-previous example, chain expands %%space to \f(CW%space\fR, which is then expanded to
-the space character by command1.
+Note that macros are expanded twice when using chain.  For example, to insert
+a space character in a chained command, you would write %%space. This is
+because the chain command is a macro-expanding command itself.
+ chain command1; command2%%space
 .SS "\s-1BOOKMARKS\s0"
 .IX Subsection "BOOKMARKS"
 Type \fBm<key>\fR to bookmark the current directory. You can re-enter this
diff --git a/doc/ranger.pod b/doc/ranger.pod
index fc385334..e178bf04 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -328,13 +328,10 @@ the end of the line automatically.
 
 To write a literal %, you need to escape it by writing %%.
 
-For adding a space character after a chained command, you also need to escape
-% by writing %% instead:
- chain command1 %%space; command2
-
-This is because the chain command is a macro-expanding command itself. In the
-previous example, chain expands %%space to %space, which is then expanded to
-the space character by command1.
+Note that macros are expanded twice when using chain.  For example, to insert
+a space character in a chained command, you would write %%space. This is
+because the chain command is a macro-expanding command itself.
+ chain command1; command2%%space
 
 =head2 BOOKMARKS