Document file path copy usage sans clipboard

diff --git a/README.md b/README.md
index 7dbc6687edd0cf8b98a11fb7966ac1940ecc7d6d..7a567ed62485dd636c037efd911620d5a03dc75a 100644 (file)
--- a/README.md
+++ b/README.md
@@ -68,6 +68,7 @@ Have fun with it! PRs are welcome. Check out [#1](https://github.com/jarun/nnn/i
   - [use cd .....](#use-cd-)
   - [cd on quit](#cd-on-quit)
   - [copy file paths to clipboard](#copy-file-paths-to-clipboard)
+  - [copy file paths when X is missing](#copy-file-paths-when-x-is-missing)
   - [change dir color](#change-dir-color)
   - [file copy, move, delete](#file-copy-move-delete)
   - [boost chdir prompt](#boost-chdir-prompt)
@@ -376,6 +377,34 @@ To wrap each file path within single quotes, export `NNN_QUOTE_ON`:
     export NNN_QUOTE_ON=1
 This is particularly useful if you are planning to copy the whole string to the shell to run a command. Quotes can be toggled at runtime using <kbd>^T</kbd>.
 
+#### copy file paths when X is missing
+
+A very common scenario on headless remote servers connected via SSH. As the clipboard is missing, `nnn` copies the path names to the tmp file `/tmp/nnncp`.
+
+To use the copied paths from the cmdline, use command substitution:
+
+    # bash/zsh
+    ls -ltr `cat /tmp/nnncp`
+    ls -ltr $(cat /tmp/nnncp)
+
+    # fish
+    ls -ltr (cat /tmp/nnncp)
+
+An alias may be handy:
+
+    alias ncp='cat /tmp/nnncp'
+
+so you can -
+
+    # bash/zsh
+    ls -ltr `ncp`
+    ls -ltr $(ncp)
+
+    # fish
+    ls -ltr (ncp)
+
+Note that you may want to keep quotes disabled in this case.
+
 #### change dir color
 
 The default color for directories is blue. Option `-c` accepts color codes from 0 to 7 to use a different color:

diff --git a/nnn.1 b/nnn.1
index 98931843814d955c5ab07d12c517a7765537fdd6..d895828d8d3007076ef4ac7cd7f8240b3d538225 100644 (file)
--- a/nnn.1
+++ b/nnn.1
@@ -245,6 +245,11 @@ screensaver.
     -------------------------------------
 .Ed
 .Pp
+\fBNNN_NO_X:\fR X display is unavailable. Copy file path(s) to \fI/tmp/nnncp\fR.
+.Bd -literal
+    export NNN_NO_X=1
+.Ed
+.Pp
 \fBNNN_NOWAIT:\fR necessary only if nnn blocks while a file is open.
 .Bd -literal
     export NNN_NOWAIT=1