about summary refs log tree commit diff stats
path: root/doc
diff options
context:
space:
mode:
authortoonn <toonn@toonn.io>2019-10-02 19:44:10 +0200
committertoonn <toonn@toonn.io>2019-10-02 20:24:01 +0200
commit1120aa45bfaad7cbfd18669f71446b9d14c448be (patch)
tree020f761e2ca854a9bb2fe6c6508a4ead87f3fdca /doc
parent13311da4b1d238ac8e330bcc7a8edc6506ad0244 (diff)
downloadranger-1120aa45bfaad7cbfd18669f71446b9d14c448be.tar.gz
Expand :trash docs
Diffstat (limited to 'doc')
-rw-r--r--doc/ranger.111
-rw-r--r--doc/ranger.pod11
2 files changed, 16 insertions, 6 deletions
diff --git a/doc/ranger.1 b/doc/ranger.1
index bf390a95..3521d762 100644
--- a/doc/ranger.1
+++ b/doc/ranger.1
@@ -1570,9 +1570,14 @@ Spawns the \fIx\-terminal-emulator\fR starting in the current directory.
 Creates an empty file with the name \fIfilename\fR, unless it already exists.
 .IP "trash" 2
 .IX Item "trash"
-Move all files in the selection to the trash using rifle. ranger will ask for
-a confirmation if you attempt to trash multiple (marked) files or non-empty
-directories. This can be changed by modifying the setting \*(L"confirm_on_delete\*(R".
+Move all files in the selection to the trash using rifle. Rifle tries to use a
+trash manager like \fItrash-cli\fR if available but will fall back to moving files
+to either \fI\f(CI$XDG_DATA_HOME\fI/ranger\-trash\fR or \fI~/.ranger/ranger\-trash\fR. This is
+a less permanent version of \fIdelete\fR, relying on the user to clear out the
+trash whenever it's convenient. While having the possibility of restoring
+trashed files until this happens. ranger will ask for a confirmation if you
+attempt to trash multiple (marked) files or non-empty directories. This can be
+changed by modifying the setting \*(L"confirm_on_delete\*(R".
 .IP "travel \fIpattern\fR" 2
 .IX Item "travel pattern"
 Filters the current directory for files containing the letters in the
diff --git a/doc/ranger.pod b/doc/ranger.pod
index 4bd99781..be964b37 100644
--- a/doc/ranger.pod
+++ b/doc/ranger.pod
@@ -1659,9 +1659,14 @@ Creates an empty file with the name I<filename>, unless it already exists.
 
 =item trash
 
-Move all files in the selection to the trash using rifle. ranger will ask for
-a confirmation if you attempt to trash multiple (marked) files or non-empty
-directories. This can be changed by modifying the setting "confirm_on_delete".
+Move all files in the selection to the trash using rifle. Rifle tries to use a
+trash manager like I<trash-cli> if available but will fall back to moving files
+to either F<$XDG_DATA_HOME/ranger-trash> or F<~/.ranger/ranger-trash>. This is
+a less permanent version of I<delete>, relying on the user to clear out the
+trash whenever it's convenient. While having the possibility of restoring
+trashed files until this happens. ranger will ask for a confirmation if you
+attempt to trash multiple (marked) files or non-empty directories. This can be
+changed by modifying the setting "confirm_on_delete".
 
 =item travel I<pattern>