aboutsummaryrefslogtreecommitdiffstats
path: root/nnn.1
diff options
context:
space:
mode:
authorGravatar Anna Arad <4895022+annagrram@users.noreply.github.com>2019-10-19 01:11:39 +0300
committerGravatar Mischievous Meerkat <engineerarun@gmail.com>2019-10-19 03:41:39 +0530
commit60dac94a5e3727d7c8bf0f02f3d6f8b53f8d1d02 (patch)
tree3db311f182889799ef16a16c05d87644e84c61ca /nnn.1
parent2da5602a4f7bff17d43c939e7329aab34e2a85f9 (diff)
downloadnnn-60dac94a5e3727d7c8bf0f02f3d6f8b53f8d1d02.tar.gz
Implementing sessions support (#360)
* Initial commit of sessions implementation * Reduce code duplication * Move load session to program flag -e * Fix context initialization problem when loading session * Add pinned directory to session and reduce session file size * Make load_session print an error if exists and few minor adjustments * Refactor session's file structure * Initialize required structures in load_session before loading * Add load session dynamically, restore last session, and extra fixes * Fix indentation * Add sessions documentation to man page * Update fish completions with sessions and make some improvements * Move to single keybinding session management and add help info * ESC when asked to insert session name behaves better * Add sessions completion for bash * Remove pinned dir from session and minor code refactors
Diffstat (limited to 'nnn.1')
-rw-r--r--nnn.118
1 files changed, 18 insertions, 0 deletions
diff --git a/nnn.1 b/nnn.1
index 24b5eae..1add630 100644
--- a/nnn.1
+++ b/nnn.1
@@ -10,6 +10,7 @@
.Op Ar -b key
.Op Ar -c
.Op Ar -d
+.Op Ar -e name
.Op Ar -f
.Op Ar -H
.Op Ar -i
@@ -52,6 +53,9 @@ supports the following options:
.Fl d
detail mode
.Pp
+.Fl "e name"
+ Load a session by name
+.Pp
.Fl f
run filter as command when the prompt key is pressed
.Pp
@@ -108,6 +112,20 @@ are available. The status of the contexts are shown in the top left corner:
On context creation, the state of the previous context is copied. Each context remembers its last visited directory.
.Pp
Each context can have its own directory color specified. See ENVIRONMENT section below.
+.Sh SESSIONS
+Sessions are a way to save and restore states of work. A session stores the settings and contexts.
+.Pp
+Sessions can be loaded dynamically from within a running
+.Nm
+instance, or with a flag to
+.Nm .
+.Pp
+When a session is loaded dynamically, the last working session is saved automatically to a dedicated
+-- "last session" -- session file.
+.Pp
+All the session files are located in \fBnnn\fR's
+configuration directory under the "sessions" directory and named after the session.
+"@" is the "last session" file.
.Sh FILTERS
Filters support regexes (default) to instantly (search-as-you-type) list the matching
entries in the current directory.