From 43fcd2e02e113a55f673f266ad28b53858500022 Mon Sep 17 00:00:00 2001 From: NRK Date: Fri, 19 Nov 2021 16:08:39 +0600 Subject: set env var NSXIV_USING_NULL for key-handler and update docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Berke Kocaoğlu --- nsxiv.1 | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) (limited to 'nsxiv.1') diff --git a/nsxiv.1 b/nsxiv.1 index f968f3b..f63994c 100644 --- a/nsxiv.1 +++ b/nsxiv.1 @@ -439,14 +439,20 @@ located in The handler is invoked by pressing .BR Ctrl-x . The next key combo is passed as its first argument. Passed via stdin are the -images to act upon, one path per line: all marked images, if in thumbnail mode -and at least one image has been marked, otherwise the current image. -nsxiv(1) will block until the handler terminates. It then checks which images -have been modified and reloads them. +images to act upon: all marked images, if in thumbnail mode and at least one +image has been marked, otherwise the current image. nsxiv(1) will block until +the handler terminates. It then checks which images have been modified and +reloads them. + +By default nsxiv(1) will send one image per-line to stdin, however when using +\-0 the image list will be NULL separated and the enviornment variable +"$NSXIV_USING_NULL" will be set to 1. The key combo argument has the following form: "[C-][M-][S-]KEY", where C/M/S indicate Ctrl/Meta(Alt)/Shift modifier states and KEY is the X keysym as listed in /usr/include/X11/keysymdef.h without the "XK_" prefix. +If KEY has an uppercase equivalent, S-KEY is resolved into it. For instance, +K replaces S-k and Scedilla replaces S-scedilla, but S-Delete is sent as-is. There is also an example script installed together with nsxiv as .IR EGPREFIX/key-handler . -- cgit v1.2.3