From 977d1a7120ae66ba40abb770bb00e99bc23d6b0b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?P=C5=99emysl=20Eric=20Janouch?= <p@janouch.name>
Date: Mon, 30 Dec 2024 19:36:51 +0100
Subject: [PATCH] Update documentation

---
 README.adoc | 18 ++++++++++++------
 sdn-view.1  |  5 +++--
 sdn.1       |  7 ++++---
 3 files changed, 19 insertions(+), 11 deletions(-)

diff --git a/README.adoc b/README.adoc
index 8789821..b7aeecf 100644
--- a/README.adoc
+++ b/README.adoc
@@ -5,7 +5,8 @@ sdn
 'sdn' is a simple directory navigator that you can invoke while editing shell
 commands.  It enables you to:
 
- * take a quick peek at directory contents without running `ls`
+ * take a quick peek at directory contents without running `ls`;
+ * select files to insert into the command line;
  * browse the filesystem without all the mess that Midnight Commander does:
    there's no need to create a subshell in a new pty.  The current command line
    can be simply forwarded if it is to be edited.  What's more, it will always
@@ -75,6 +76,7 @@ that of git, only named colours aren't supported:
 
 ....
 cursor 231 202
+select 202 bold
 bar 16 255 ul
 cwd bold
 input
@@ -91,15 +93,19 @@ To obtain more vifm-like controls, you may write the following to your
 
 ....
 normal h parent
-normal l choose
+normal l enter
 ....
 
 Helper programs
 ~~~~~~~~~~~~~~~
-The F3 and F4 keys are normally bound to actions 'view' and 'edit', similarly to
-Norton Commander and other orthodox file managers.  The helper programs used
-here may be changed by setting the PAGER and VISUAL (or EDITOR) environment
-variables.
+The F3, F13 and F4 keys are normally bound to actions 'view', 'view-raw',
+and 'edit', similarly to Norton Commander and other orthodox file managers.
+The helper programs used here may be changed by setting the PAGER and VISUAL
+(or EDITOR) environment variables.
+
+If 'view' finds Midnight Commander, it will make use of its configuration
+to apply any matching filter, such as to produce archive listings,
+or it will run the respective command.
 
 While it is mostly possible to get 'mcview' working using an invocation like
 `PAGER='mcview -u' sdn`, beware that this helper cannot read files from its
diff --git a/sdn-view.1 b/sdn-view.1
index d78d325..b8c26c9 100644
--- a/sdn-view.1
+++ b/sdn-view.1
@@ -1,4 +1,4 @@
-.Dd December 28, 2024
+.Dd December 30, 2024
 .Dt SDN-VIEW 1
 .Os
 .Sh NAME
@@ -16,7 +16,8 @@ or a fallback pager on the passed filename.
 If it succeeds in finding a
 .Xr mc 1
 .Pa mc.ext.ini
-file, it will first process it, and apply any matching filter.
+file, it will first process it, and apply any matching filter,
+or run the respective command.
 .Sh REPORTING BUGS
 Use
 .Lk https://git.janouch.name/p/sdn
diff --git a/sdn.1 b/sdn.1
index 0c9ee8d..8e76708 100644
--- a/sdn.1
+++ b/sdn.1
@@ -1,5 +1,5 @@
 \" https://mandoc.bsd.lv/man/roff.7.html#Sentence_Spacing
-.Dd October 27, 2020
+.Dd December 30, 2024
 .Dt SDN 1
 .Os
 .Sh NAME
@@ -95,7 +95,7 @@ names are used for special keys.
 To obtain more vifm-like controls and Windows-like quit abilities:
 .Bd -literal -offset indent
 normal h parent
-normal l choose
+normal l enter
 normal M-f4 quit
 .Ed
 .Pp
@@ -107,7 +107,7 @@ For rxvt, that would be:
 define C-ppage ^[[5^
 define C-npage ^[[6^
 normal C-ppage parent
-normal C-npage choose
+normal C-npage enter
 .Ed
 .Pp
 Escape characters must be inserted verbatim, e.g., by pressing C-v ESC in vi,
@@ -120,6 +120,7 @@ For a black-on-white terminal supporting 256 colours, a theme such as the
 following may work:
 .Bd -literal -offset indent
 cursor 231 202
+select 202 bold
 bar 16 255 ul
 cwd bold
 input