diff --git a/Troubleshooting.md b/Troubleshooting.md index d6937c2..b53dc21 100644 --- a/Troubleshooting.md +++ b/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 ^Y to `DSUSP` by default. 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-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 ^Y 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. \ No newline at end of file