1
1
mirror of https://github.com/jarun/nnn.git synced 2024-11-22 15:20:59 +03:00

Updated Concepts (markdown)

Arun 2022-06-14 13:24:11 +05:30
parent 99965c9971
commit cb6eb71ef3

@ -86,6 +86,23 @@ Special keys at **_empty filter prompt_**:
| <kbd>Bksp</kbd> | Stay at filter prompt and refresh dir |
| <kbd>Del</kbd> | Stay at filter prompt and refresh dir |
#### Common regex use cases
- to list all matches starting with the filter expression, start with a `^` (caret)
- type `\.mkv` to list all MKV files
- use `.*` to match any character (_sort of_ fuzzy search)
- exclude filenames having `nnn` ([with PCRE](https://github.com/jarun/nnn/wiki/Developer-guides#compile-with-pcre)): `^(?!nnn)`
#### Limitation
Use regex for case-sensitive filtering with wide chars as the function [`strcasestr`](https://manpages.ubuntu.com/manpages/bionic/en/man3/strcasestr.3.html) (used for string filters) does not work with multibyte locales ([ref1](https://www.gnu.org/software/libunistring/manual/libunistring.html#char-_002a-strings), [ref2](https://www.gnu.org/software/gnulib/manual/html_node/c_002dstrcasestr.html)).
## Type-to-nav
In this mode directories are opened in filter mode, allowing continuous navigation.
To start in _type-to-nav_ mode, use the program option `-n` or press <kbd>^N</kbd>.
Additional special keys at **_empty filter prompt_** in **_type-to-nav_** mode:
<table>
@ -114,23 +131,6 @@ Additional special keys at **_empty filter prompt_** in **_type-to-nav_** mode:
</td></tr> </table>
#### Common regex use cases
- to list all matches starting with the filter expression, start with a `^` (caret)
- type `\.mkv` to list all MKV files
- use `.*` to match any character (_sort of_ fuzzy search)
- exclude filenames having `nnn` ([with PCRE](https://github.com/jarun/nnn/wiki/Developer-guides#compile-with-pcre)): `^(?!nnn)`
#### Limitation
Use regex for case-sensitive filtering with wide chars as the function [`strcasestr`](https://manpages.ubuntu.com/manpages/bionic/en/man3/strcasestr.3.html) (used for string filters) does not work with multibyte locales ([ref1](https://www.gnu.org/software/libunistring/manual/libunistring.html#char-_002a-strings), [ref2](https://www.gnu.org/software/gnulib/manual/html_node/c_002dstrcasestr.html)).
## Type-to-nav
In this mode directories are opened in filter mode, allowing continuous navigation.
To start in _type-to-nav_ mode, use the program option `-n` or press <kbd>^N</kbd>.
## Selection
`nnn` allows file selection across directories and contexts!