-
-
-
-
-
navigate-as-you-type & du analyzer mode (click on the image for a demo video)
- -
navigate-as-you-type & du analyzer mode
## Index @@ -56,7 +50,8 @@ 1. [Wiki](https://github.com/jarun/nnn/wiki) (concepts, how-tos, use cases, chronology and insights) 2. [Performance numbers](https://github.com/jarun/nnn/wiki/Performance) 3. [Plugin repository and docs](https://github.com/jarun/nnn/tree/master/plugins) 4. [(neo)vim plugin](https://github.com/mcchrish/nnn.vim) -5. [nnn on Android](https://www.youtube.com/watch?v=AbaauM7gUJw) +5. [Demo video](https://www.youtube.com/watch?v=U2n5aGqou9E) (v2.1) +6. [nnn on Android](https://www.youtube.com/watch?v=AbaauM7gUJw) ## Features @@ -119,7 +114,7 @@ ## Installation #### Library dependencies -A curses library with wide character support (like ncursesw), libreadline and standard libc. It's possible to drop libreadline using the Makefile target `norl`. +A curses library with wide char support (e.g. ncursesw), libreadline and standard libc. Makefile target `norl` drops libreadline. #### Utility dependencies @@ -177,7 +172,9 @@ ## Usage #### Configuration -`nnn` supports the following environment variables for configuration. All of them are optional (set if you need). There is no config file. Associated files are stored under `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/`. +There is no config file. Associated files are stored under `${XDG_CONFIG_HOME:-$HOME/.config}/nnn/`. + +`nnn` supports the following optional (set if you need) environment variables. | Example `export` | Description | | --- | --- | @@ -257,7 +254,7 @@ c SSHFS mount u Unmount ^P Prompt/run expr L Lock ``` -Note: Help & settings, file details and archive listing are shown in the PAGER. +Note: Help & settings, file details and archive listing are shown in the `$PAGER`. | Mouse click | Function | |---| --- | @@ -303,8 +300,8 @@ - [Ubuntu Full Circle Magazine - Issue 135](https://fullcirclemagazine.org/issue-135/) ## Developers +- Copyright © 2016-2019 [Arun Prakash Jana](https://github.com/jarun) - Copyright © 2014-2016 Lazaros Koromilas - Copyright © 2014-2016 Dimitris Papastamos -- Copyright © 2016-2019 [Arun Prakash Jana](https://github.com/jarun) Contributions are welcome. Head to the [ToDo list](https://github.com/jarun/nnn/issues/332). diff --git a/nnn.1 b/nnn.1 index d74b84865f28b16431b6adbdfda80844d9de41b9..478cb9893478f5fc7e565d6b1fa0076460450d45 100644 --- a/nnn.1 +++ b/nnn.1 @@ -125,7 +125,9 @@ .Pp In the \fInavigate-as-you-type\fR mode directories are opened in filter mode, allowing continuous navigation. Works best with the \fBarrow keys\fR. .br -When there's a unique match and it's a directory, `nnn` auto selects the directory and enters it in this mode. +When there's a unique match and it's a directory, +.Nm +auto selects the directory and enters it in this mode. .Sh SELECTION Use \fI^K\fR to select the file under the cursor. .Pp @@ -196,10 +198,16 @@ .Bd -literal export NNN_TRASH=1 .Ed .Sh KNOWN ISSUES -If you are using urxvt you might have to set backspace key to DEC. +.Nm +may not handle keypresses correctly when used with tmux (see issue #104 for more details). Set \fBTERM=xterm-256color\fR to address it. +.Pp +Use the keybind \fBK\fR to toggle selection if you are having issues with \fB^Y\fR on *BSD or macOS. To use \fB^Y\fR, run: +.Bd -literal + stty dsusp undef +.Ed .Sh AUTHORS +.An Arun Prakash Jana Aq Mt engineerarun@gmail.com , .An Lazaros Koromilas Aq Mt lostd@2f30.org , -.An Dimitris Papastamos Aq Mt sin@2f30.org , -.An Arun Prakash Jana Aq Mt engineerarun@gmail.com . +.An Dimitris Papastamos Aq Mt sin@2f30.org . .Sh HOME .Em https://github.com/jarun/nnn