From fe9e8a62bfa784e9cb20cb77d7ccbeefed278db2 Mon Sep 17 00:00:00 2001 From: Arun Prakash Jana Date: Thu, 8 Nov 2018 18:29:38 +0530 Subject: [PATCH] Update docs on contexts --- README.md | 26 +++++++++++++------------- nnn.1 | 16 +++++++++++++++- 2 files changed, 28 insertions(+), 14 deletions(-) diff --git a/README.md b/README.md index 838fa76b..f6abc30c 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,7 @@ Have fun with it! Missing a feature? Want to contribute? Head to the rolling [To - [Usage](#usage) - [Cmdline options](#cmdline-options) - [Keyboard shortcuts](#keyboard-shortcuts) + - [Contexts](#contexts) - [Filters](#filters) - [Navigate-as-you-type mode](#navigate-as-you-type-mode) - [File indicators](#file-indicators) @@ -57,7 +58,6 @@ Have fun with it! Missing a feature? Want to contribute? Head to the rolling [To - [Quickstart](#quickstart) - [How to](#how-to) - [add bookmarks](#add-bookmarks) - - [contexts](#contexts) - [copy file paths](#copy-file-paths) - [selection shortcuts](#selection-shortcuts) - [default copy](#default-copy) @@ -258,6 +258,18 @@ optional args: Help & settings, file details, media info and archive listing are shown in the PAGER. Please use the PAGER-specific keys in these screens. +#### Contexts + +Contexts (aka _tabs_ aka _workspaces_) serve the purpose of exploring multiple directories in parallel. `nnn` provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner: + +- the current context is in reverse +- other used contexts are underlined +- rest are unused + +The bookmark prompt understands contexts. To switch contexts press `^B` and enter the context number (1-4). + +The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory. + #### Filters Filters support regexes to instantly (search-as-you-type) list the matching entries in the current directory. @@ -343,18 +355,6 @@ Set environment variable `NNN_BMS` as a string of `key:location` pairs (max 10) The bookmark prompt also understands the ~ (HOME), - (last visited directory) and & (start directory) shortcuts. -#### contexts - -Contexts (aka _tabs_ aka _workspaces_) serve the purpose of exploring multiple directories in parallel. `nnn` provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner: - -- the current context is in reverse -- other used contexts are underlined -- rest are unused - -The bookmark prompt understands contexts. To switch contexts press `^B` and enter the context number (1-4). - -The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory. - #### copy file paths ##### selection shortcuts diff --git a/nnn.1 b/nnn.1 index 73183d34..37ca998e 100644 --- a/nnn.1 +++ b/nnn.1 @@ -166,7 +166,7 @@ supports the following options: uses \fIxdg-open\fR (on Linux) and \fIopen(1)\fR (on OS X) as the desktop opener. It invokes .Pa nlay -to run desktop search utility or terminal locker. Read more on +to run the terminal locker. Read more on .Pa nlay at: .br @@ -180,6 +180,20 @@ Configuring to change to the last visited directory on quit requires shell integration in a few easy steps. Please visit the project page (linked below) for the instructions. +.Sh CONTEXTS +Contexts (aka \fItabs\fR aka \fIworkspaces\fR) serve the purpose of exploring multiple directories in parallel. +.Nm +provides 4 contexts simultaneously. The status of the contexts are shown in the top left corner: +.Pp +- the current context is in reverse +.br +- other used contexts are underlined +.br +- rest are unused +.Pp +The bookmark prompt understands contexts. To switch contexts press \fI^B\fR and enter the context number (1-4). +.Pp +The first time a context is entered, it copies the state of the last visited context. Each context remembers its start directory and last visited directory. .Sh FILTERS Filters support regexes to instantly (search-as-you-type) list the matching entries in the current directory.