aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGravatar Tim Chase <github@tim.thechases.com>2018-11-22 14:08:50 -0600
committerGravatar GitHub <noreply@github.com>2018-11-22 14:08:50 -0600
commit458f12a97987af67831b1f33730ddc16bcb4ff04 (patch)
tree0349a1fc98ed86540659d2876a95aeb8e566514b
parent3297366b6536d252dff24c9926d3b414648409da (diff)
downloadnnn-458f12a97987af67831b1f33730ddc16bcb4ff04.tar.gz
Annotate ^Y/DSUSP issue on BSDs caused by `stty`
On at least FreeBSD & OpenBSD, typing `^Y` will send a `DSUSP` signal, suspending the process. Annotate the issue along with a solution to allow `^Y` to work on these. There may be similar issues on NetBSD or possibly on OSX, but I don't have either available for testing.
-rw-r--r--README.md4
1 files changed, 4 insertions, 0 deletions
diff --git a/README.md b/README.md
index b7c7781..c81b91b 100644
--- a/README.md
+++ b/README.md
@@ -504,6 +504,10 @@ Enable volume management in your DE file manager and set removable drives or med
`nnn` might not handle keypresses correctly when used with tmux (see issue #104 for more details). Set `TERM=xterm-256color` to address it.
+#### BSD terminal issue
+
+By default in OpenBSD & FreeBSD, `stty` maps `^Y` to `DSUSP`. This means that typing `^Y` will suspend `nnn` as if you typed `^Z` (you can bring `nnn` back to the foreground by issuing `fg`) instead of entering multi-copy mode. You can check this with `stty -a`. If it includes the text "`dsusp = ^Y`", issuing `stty dsusp undef` will disable this `DSUSP` and let `nnn` receive the `^Y` instead.
+
#### WHY FORK?
`nnn` was initially forked from [noice](http://git.2f30.org/noice/) but is significantly [different](https://github.com/jarun/nnn/wiki/nnn-vs.-noice) today. I chose to fork because: