jarun/nnn
1
1
Fork 0
mirror of https://github.com/jarun/nnn.git synced 2024-11-26 09:52:12 +03:00
Code Issues Projects Releases Wiki Activity

Updated Troubleshooting (markdown)

Mischievous Meerkat 2021-03-29 07:57:58 +05:30
parent eec6474b68
commit 7c397e70e7
1 changed files with 13 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
Troubleshooting.md

@ -8,12 +8,6 @@ Use the following command to set default applications for mimetypes when using `
e.g.
xdg-mime default sxiv.desktop image/jpeg image/png
## Batch rename limits
**TL;DR:** If you need a full-featured batch-renamer, install plugins. `nnn` auto-detects and invokes the internal plugin `.nmv` (a bash script) which is feature-complete.
The in-built batch-renamer implemented in `nnn` is a very simplified one. It's single-pass - reads the name/path of files iteratively (from a list of source files) and renames/moves them (as specified in the corresponding line number in a list of renamed/destination files). It doesn't handle deletions or perform any pre-parsing to account for rename loops, swaps, replaces, etc.
## Tmux configuration
`nnn` may not handle keypresses correctly when used with tmux (see issue #104 for more details). Set `TERM=xterm-256color` to address it.
@ -51,6 +45,19 @@ If that's the case, clear (`undef`) the setting. E.g.:
You can do this when starting `nnn`. See the [quitcd scripts](https://github.com/jarun/nnn/tree/master/misc/quitcd).
## Help not showing
If your PAGER is `less`, remove the option `-F` (automatically exit if the entire file can be displayed on the first screen). There are other screens which use `less` as well.
Note that the `less` command takes its default parameters from the `$LESS` environment variable, so you may need to remove `-F` from your shell
initialization.
## In-built batch rename limits
**TL;DR:** If you need a full-featured batch-renamer, install plugins. `nnn` auto-detects and invokes the internal plugin `.nmv` (a bash script) which is feature-complete.
The in-built batch-renamer implemented in `nnn` is a very simplified one. It's single-pass - reads the name/path of files iteratively (from a list of source files) and renames/moves them (as specified in the corresponding line number in a list of renamed/destination files). It doesn't handle deletions or perform any pre-parsing to account for rename loops, swaps, replaces, etc.
## Can't list within list
List view is a temporary view of symlinks. To avoid remembering the temporary paths to all listed views the current path is removed when the next list is loaded. This is also inline with the fact that `find` doesn't look within symlinks to directories. If you need to search the entries within a loaded list, visit the original directory and run the refined search.
@ -61,10 +68,6 @@ List view is a temporary view of symlinks. To avoid remembering the temporary pa
On OpenBSD & FreeBSD (and probably on macOS as well) `stty` maps <kbd>^Y</kbd> to `DSUSP` by default. This means that typing <kbd>^Y</kbd> will suspend `nnn` as if you typed <kbd>^Z</kbd> (you can bring `nnn` back to the foreground by issuing `fg`) instead of entering multi-selection 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 <kbd>^Y</kbd> instead.
## Help not showing
If your PAGER is `less`, remove the option `-F` (automatically exit if the entire file can be displayed on the first screen). There are other screens which use `less` as well.
## Amethyst WM
There's a known issue with Amethyst window manager on macOS - redraws do not work correctly and the screen breaks. See [issue #521](https://github.com/jarun/nnn/issues/521) for more details.