2 files changed, 14 insertions, 4 deletions

diff --git a/doc/ranger.1 b/doc/ranger.1
index d2a25aaa..ead041f7 100644
--- a/doc/ranger.1
+++ b/doc/ranger.1
@@ -889,8 +889,13 @@ Creates a directory with the name \fIdirname\fR.
 .IP "open_with [\fIapplication\fR] [\fIflags\fR] [\fImode\fR]" 2
 .IX Item "open_with [application] [flags] [mode]"
 Open the selected files with the given application, unless it is omitted, in
-which case the default application is used.  \fIflags\fR and \fImode\fR have their
-own section in the man page.
+which case the default application is used.  \fIflags\fR change the way the
+application is executed and are described in their own section in this man
+page.  The \fImode\fR is a number that specifies which application to use.  The list
+of applications is generated by the external file opener \*(L"rifle\*(R" and can be
+displayed when pressing \*(L"r\*(R" in ranger.
+.Sp
+Note that if you specify an application, the mode is ignored.
 .IP "pmap \fIkey\fR \fIcommand\fR" 2
 .IX Item "pmap key command"
 Binds keys for the pager. Works like the \f(CW\*(C`map\*(C'\fR command.
diff --git a/doc/ranger.pod b/doc/ranger.pod
index 3a3c9052..3100ad9d 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -920,8 +920,13 @@ Creates a directory with the name I<dirname>.
 =item open_with [I<application>] [I<flags>] [I<mode>]
 
 Open the selected files with the given application, unless it is omitted, in
-which case the default application is used.  I<flags> and I<mode> have their
-own section in the man page.
+which case the default application is used.  I<flags> change the way the
+application is executed and are described in their own section in this man
+page.  The I<mode> is a number that specifies which application to use.  The list
+of applications is generated by the external file opener "rifle" and can be
+displayed when pressing "r" in ranger.
+
+Note that if you specify an application, the mode is ignored.
 
 =item pmap I<key> I<command>