From 642af4667ccd0b7cecb31f3b76f366a0d5333a32 Mon Sep 17 00:00:00 2001 From: Arun Prakash Jana Date: Sun, 11 Nov 2018 23:20:16 +0530 Subject: [PATCH] Update docs --- README.md | 72 +++++++++++++++++++++++---------------------- nnn.1 | 3 +- scripts/nlay/nlay | 4 +-- scripts/nlay/nlay.1 | 4 +-- src/nnn.c | 2 +- 5 files changed, 43 insertions(+), 42 deletions(-) diff --git a/README.md b/README.md index db67c26e..bb9ec323 100644 --- a/README.md +++ b/README.md @@ -36,7 +36,7 @@ It runs on Linux, OS X, Raspberry Pi, Cygwin, Linux subsystem for Windows and Te Donate via PayPal!

-### Table of Contents +#### TABLE OF CONTENTS - [Features](#features) - [Performance](#performance) @@ -71,48 +71,49 @@ It runs on Linux, OS X, Raspberry Pi, Cygwin, Linux subsystem for Windows and Te - [work faster at rename prompt](#work-faster-at-rename-prompt) - [set idle timeout](#set-idle-timeout) - [show hot plugged drives](#show-hot-plugged-drives) - - [tmux config](#tmux-config) + - [tmux configuration](#tmux-configuration) - [Why fork?](#why-fork) - [Mentions](#mentions) - [Developers](#developers) -### Features +#### FEATURES -- Modes - basic, detail (default), disk usage analyzer (du) +- Modes + - Basic, detail (default), disk usage analyzer (du) - Navigation - Familiar, easy shortcuts (arrows, `~`, `-`, `&`) - - *Navigate-as-you-type* mode with dir auto-select for the maverick - - Handy bookmarks, start at bookmark, pin and visit directory - - Multiple contexts - - Roll-over at edges, page through entries - - Show directories in custom color (default: enabled in blue) + - *Navigate-as-you-type* with auto-select directory + - Contexts (_aka_ tabs _aka_ workspaces) + - Bookmarks, pin and visit directory - Sorting - Directories always listed on top - Sort by file name, modification time, size - - Numeric order (1, 2, ... 10, 11, ...) for numeric names + - Numeric order for numeric names (visit _/proc_) - Search - - Superfast directory content filtering with *search-as-you-type* + - Instant filtering with *search-as-you-type* - Mimes - - Open with desktop opener (default) or specify a custom app - - Create, list and extract archives (needs atool/patool) - - Optionally open text files in EDITOR (fallback vi) + - Open with desktop opener or specify a custom app + - Create, list, extract archives (needs (p)atool) + - Open all text files in EDITOR (optional) - Information - Detailed stat-like file information - - Media information (needs mediainfo or exiftool, if specified) + - Media information (needs mediainfo/exiftool) - Convenience - - Copy, move, delete multiple files by selection - Create, rename files and directories - - Batch rename/move/delete current directory entries in vidir (from moreutils) - - Spawn SHELL (fallback sh) in the current directory + - Select multiple files; copy, move, delete selection + - Batch rename/move/delete (needs vidir) + - Show directories in custom color (default: blue) + - Spawn SHELL in the current directory - Run custom scripts in the current directory - Change directory at exit (*easy* shell integration) - - Open any file in EDITOR (fallback vi) or PAGER (fallback less) - - GUI app launcher (maximum 2 space-separated arguments) - - Terminal screensaver/locker integration + - Edit file in EDITOR or open in PAGER + - GUI app launcher (up to 2 space-separated args) + - Terminal locker integration - Unicode support - Highly optimized code, minimal resource usage +- Available on many distros -### Performance +#### PERFORMANCE `nnn` vs. ncdu memory usage in disk usage analyzer mode (400K files on disk): @@ -133,7 +134,7 @@ It runs on Linux, OS X, Raspberry Pi, Cygwin, Linux subsystem for Windows and Te Intrigued? Find out [HOW](https://github.com/jarun/nnn/wiki/performance-factors). -### Installation +#### INSTALLATION #### Dependencies @@ -172,11 +173,11 @@ To cook yourself, download the [latest stable release](https://github.com/jarun/ `PREFIX` is supported, in case you want to install to a different location. -### Shell completion +#### SHELL COMPLETION Search keyword and option completion scripts for Bash, Fish and Zsh can be found in respective subdirectories of [`scripts/auto-completion/`](scripts/auto-completion). Please refer to your shell's manual for installation instructions. -### Usage +#### USAGE #### Cmdline options @@ -260,7 +261,7 @@ If all the configured bookmark keys are single character, the prompt is not show #### Contexts -Contexts (aka _tabs_ aka _workspaces_) serve the purpose of exploring multiple directories simultaneously. 4 contexts are available. The status of the contexts are shown in the top left corner: +Contexts serve the purpose of exploring multiple directories simultaneously. 4 contexts are available. The status of the contexts are shown in the top left corner: - the current context is in reverse - other used contexts are underlined @@ -314,9 +315,10 @@ The following indicators are used in the detail view: | External dependency | Operation | | --- | --- | | xdg-open (Linux), open(1) (OS X), cygstart (Cygwin) | desktop opener | +| cp, mv, rm | copy, move and remove files | | mediainfo, exiftool | multimedia file details | | atool, patool ([integration](#integrate-patool)) | create, list and extract archives | -| vidir from moreutils | batch rename, move, delete dir entries | +| vidir (from moreutils) | batch rename, move, delete dir entries | | vlock (Linux), bashlock (OS X), lock(1) (BSD) | terminal locker | | $EDITOR (overridden by $VISUAL, if defined) | edit files (fallback vi) | | $PAGER | page through files (fallback less) | @@ -332,7 +334,7 @@ The following indicators are used in the detail view: $ man nnn To lookup keyboard shortcuts at runtime, press ?. -### Quickstart +#### QUICKSTART 1. Install the [utilities required](#file-handling) for your regular activities. 2. Configure [cd on quit](#cd-on-quit). @@ -343,7 +345,7 @@ To lookup keyboard shortcuts at runtime, press ?. 5. Press ? for help on keyboard shortcuts anytime. 6. For additional functionality [setup custom scripts](#run-custom-scripts). -### How to +#### HOW TO #### add bookmarks @@ -484,30 +486,30 @@ The rename prompt supports some bash-like command-line shortcuts - ^A #### set idle timeout -The terminal screensaver is disabled by default. To set the wait time in seconds, use environment variable `NNN_IDLE_TIMEOUT`. +The terminal locker is disabled by default. To set the wait time in seconds, use environment variable `NNN_IDLE_TIMEOUT`. #### show hot plugged drives Enable volume management in your DE file manager and set removable drives or media to be auto-mounted when inserted. Then visit the usual mount point location (`/mnt` or `/media/user`) in `nnn`. -#### tmux config +#### tmux configuration `nnn` might not handle keypresses correctly when used with tmux (see issue #104 for more details). Set `TERM=xterm-256color` to address it. -### Why fork? +#### WHY FORK? `nnn` was initially forked from [noice](http://git.2f30.org/noice/) but is significantly [different](https://github.com/jarun/nnn/wiki/nnn-vs.-noice) today. I chose to fork because: -- one can argue my approach deviates from the goal of the original project - keep the utility `suckless`. In my opinion evolution is the taste of time. +- one can argue my approach deviates from the goal of the original project - keep the utility `suckless`. `noice` was rudimentary. In my opinion evolution is the taste of time. - I would like to have a bit of control on what features are added in the name of desktop integration. A feature-bloat is the last thing in my mind. Check out [nnn design considerations](https://github.com/jarun/nnn/wiki/nnn-design-considerations) for more details. -### Mentions +#### MENTIONS - [FOSSMint](https://www.fossmint.com/nnn-linux-terminal-file-browser/) - [It's FOSS](https://itsfoss.com/nnn-file-browser-linux/) - [LinuxLinks](https://www.linuxlinks.com/nnn-fast-and-flexible-file-manager/) - [Ubuntu Full Circle Magazine - Issue 135](https://fullcirclemagazine.org/issue-135/) -### Developers +#### DEVELOPERS 1. Copyright © 2014-2016 Lazaros Koromilas 2. Copyright © 2014-2016 Dimitris Papastamos diff --git a/nnn.1 b/nnn.1 index e343c275..1c9b2ae2 100644 --- a/nnn.1 +++ b/nnn.1 @@ -273,8 +273,7 @@ files. export NNN_USE_EDITOR=1 .Ed .Pp -\fBNNN_IDLE_TIMEOUT:\fR set idle timeout (in seconds) to invoke terminal -screensaver. +\fBNNN_IDLE_TIMEOUT:\fR set idle timeout (in seconds) to invoke terminal locker. .Pp \fBNNN_COPIER:\fR set to a clipboard copier script. For example, on Linux: .Bd -literal diff --git a/scripts/nlay/nlay b/scripts/nlay/nlay index 1930379e..26e823fa 100755 --- a/scripts/nlay/nlay +++ b/scripts/nlay/nlay @@ -72,8 +72,8 @@ elif [ "$2" == "search" ]; then bg=(">/dev/null 2>&1 &" ">/dev/null 2>&1 &") -#--------------- SCREENSAVER ---------------- -elif [ "$2" == "screensaver" ]; then +#------------------ LOCKER ------------------ +elif [ "$2" == "locker" ]; then app=("vlock" "bashlock" "lock") diff --git a/scripts/nlay/nlay.1 b/scripts/nlay/nlay.1 index 9df0e012..0a6a7b55 100644 --- a/scripts/nlay/nlay.1 +++ b/scripts/nlay/nlay.1 @@ -22,14 +22,14 @@ supports the following options: The first argument can be the file or path to pass as an argument to the app. It can also be an empty string e.g., while locking the terminal. .Pp "type/action" - This can be any of the strings \fItext\fR, \fIsearch\fR, \fIscript\fR or \fI screensaver\fR. + This can be any of the strings \fItext\fR, \fIsearch\fR, \fIscript\fR or \fIlocker\fR. .Sh USAGE .Pp .Bd -literal $ nlay info.txt text $ nlay . search $ nlay ~/script.sh script -$ nlay "" screensaver +$ nlay "" locker .Ed .Sh AUTHOR .An Arun Prakash Jana Aq Mt engineerarun@gmail.com . diff --git a/src/nnn.c b/src/nnn.c index 852dfa87..a2bdb4b5 100644 --- a/src/nnn.c +++ b/src/nnn.c @@ -3503,7 +3503,7 @@ int main(int argc, char *argv[]) editor = xgetenv("EDITOR", "vi"); } - /* Get screensaver wait time, if set; copier used as tmp var */ + /* Get locker wait time, if set; copier used as tmp var */ copier = getenv("NNN_IDLE_TIMEOUT"); if (copier) { opt = atoi(copier);