Expand :trash docs

1 files changed, 8 insertions, 3 deletions

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>