Update documentation

NEWS

@@ -12,16 +12,20 @@ Unreleased
    rather than by the full height of the terminal.
 
  * Added an sdn-edit script analogous to sdn-view, bound it to F4,
-   and moved the original key binding to F14.
+   and moved the original key binding to S-F4 (F14/F16).
 
  * Moved the & binding to @, and added . as an alias to M-.
 
  * Renamed "ic" and "dc" keys to "insert" and "delete" respectively.
 
+ * Fixed the intended S-F3 binding to work in other terminal types than rxvt.
+
  * Fixed zsh 5.9.2 compatibility in sdn-install.
 
  * Fixed configuration initialisation possibly not working the first time.
 
+ * Fixed shell quoting of the tilde character.
+
  * Fixed %view{hex} not working in the mc.ext.ini parser.
 
 

README.adoc

@@ -104,10 +104,10 @@ normal l enter
 
 Helper programs
 ~~~~~~~~~~~~~~~
-The F3, F13, F4, F14 keys are normally bound to actions 'view', 'view-raw',
-'edit', and 'edit-raw', 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, S-F3 (F13/F15), F4, S-F4 (F14/F16) keys are normally bound to actions
+'view', 'view-raw', 'edit', and 'edit-raw', 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' and 'edit' find Midnight Commander, they will make use of its
 configuration to apply any matching filter, such as to produce archive listings,

sdn.1

@@ -90,14 +90,32 @@ and you can use the
 .Xr dircolors 1
 utility to initialize this variable.
 .It Ev PAGER
-The viewer program to be launched by the F3 and F13 key bindings as well as
-to show the internal help message.
-If none is set, it defaults to
+The viewer program to be launched by the
+.Ic view
+and
+.Ic view-raw
+actions, normally bound to F3 and S-F3 (F13/F15) respectively,
+as well as to show the internal help message.
+If not set, it defaults to
 .Xr less 1 .
 .It Ev VISUAL , Ev EDITOR
-The editor program to be launched by the F4 key binding.
+The editor program to be launched by the
+.Ic edit
+and
+.Ic edit-raw
+actions, normally bound to F4 and S-F4 (F14/F16) respectively.
 If neither variable is set, it defaults to
 .Xr vi 1 .
+.It Ev SDN_OPENER , Ev SDN_VIEWER , Ev SDN_EDITOR
+Overrides for the programs used by the
+.Ic open , Ic view ,
+and
+.Ic edit
+actions before they try
+.Xr sdn-open 1 , Xr sdn-view 1 ,
+or
+.Xr sdn-edit 1
+respectively.
 .El
 .Sh FILES
 .Bl -tag -width 25n -compact
@@ -132,7 +150,7 @@ normal M-f4 quit
 Midnight Commander binds the same traversal actions to sequences normally
 unknown to ncurses, due to them being missing from terminfo.
 You'll need to define them manually to match your terminal.
-For rxvt, that would be (note that the escape is a control character here):
+For rxvt, that would be:
 .Bd -literal -offset indent
 define C-ppage ^[[5^
 define C-npage ^[[6^
@@ -155,6 +173,17 @@ bar 16 255 ul
 input
 cmdline 145
 .Ed
+.Sh SEE ALSO
+.Xr dircolors 1 ,
+.Xr git-config 1 ,
+.Xr less 1 ,
+.Xr sdn-edit 1 ,
+.Xr sdn-install 1 ,
+.Xr sdn-open 1 ,
+.Xr sdn-view 1 ,
+.Xr vi 1 ,
+.Xr dir_colors 5 ,
+.Xr terminfo 5
 .Sh REPORTING BUGS
 Use
 .Lk https://git.janouch.name/p/sdn

sdn.cpp

@@ -1630,7 +1630,7 @@ fun enter (const entry &entry) {
 	// Dive into directories and accessible symlinks to them
 	if (!S_ISDIR (entry.info.st_mode)
 	 && !S_ISDIR (entry.target_info.st_mode)) {
-		// This could rather launch ${SDN_OPEN:-xdg-open} or something
+		// This could rather launch ${SDN_OPENER:-xdg-open} or something
 		choose (entry, false);
 	} else {
 		change_dir (entry.filename);