From 2134a8688cbbd055e633ceb4e7bb0d352da5735d Mon Sep 17 00:00:00 2001
From: Yashwanth A <123303508+yashwanth2706@users.noreply.github.com>
Date: Mon, 3 Feb 2025 21:45:37 +0530
Subject: [PATCH] Update trash.1

When a file is trashed, it is moved to $XDG_DATA_HOME/Trash/files/ (typically ~/.local/share/Trash/files/)
along with its metadata stored in $XDG_DATA_HOME/Trash/info/. The metadata preserves the original path,
deletion timestamp, file permissions, and ownership information.

The command handles several edge cases: files with identical names are renamed with numerical suffixes,
symbolic links are moved without following them, files on different filesystems are copied then deleted,
and files with special characters are preserved correctly.

Unlike rm, trash provides safety features through file restoration using trash-restore, metadata
preservation, and system directory protection. It integrates with desktop environments, allowing
trashed files to be viewed and restored through file managers. Files can be permanently deleted
using trash-empty when needed.

While compatibility options (-r, -f, -i) are accepted, they have no effect since trash
always processes files recursively and does not require confirmation or force flags.
---
 man/man1/trash.1 | 67 +++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 1 deletion(-)

diff --git a/man/man1/trash.1 b/man/man1/trash.1
index 46e1fbd1..60724f70 120000
--- a/man/man1/trash.1
+++ b/man/man1/trash.1
@@ -1 +1,66 @@
-trash-put.1
\ No newline at end of file
+TH(1) General Commands Manual
+
+NAME
+    trash - Command line trash utility.
+
+SYNOPSIS
+    trash [OPTIONS] [FILE]...
+
+DESCRIPTION
+    The `trash` command is part of the trash-cli package, which provides a command-line interface
+    for moving files and directories to the trash. It follows the FreeDesktop.org Trash Specification.
+    The utility retains metadata such as the original file path, deletion date, and permissions.
+
+OPTIONS
+    -h, --help
+        Show this help message and exit.
+
+    --version
+        Show program's version number and exit.
+
+    -d, --directory
+        This option is included for compatibility with GNU rm but has no effect in trash-cli.
+
+    -f, --force
+        This option is included for compatibility with GNU rm but has no effect in trash-cli.
+
+    -i, --interactive
+        This option is included for compatibility with GNU rm but has no effect in trash-cli.
+
+    -r, -R, --recursive
+        This option is included for compatibility with GNU rm but has no effect in trash-cli.
+
+    -v, --verbose
+        Explain what is being done.
+
+ARGUMENTS
+    FILE
+        One or more files or directories to move to the trash.
+
+EXAMPLES
+    Move a file to the trash:
+        $ trash foo.txt
+
+    Move multiple files to the trash:
+        $ trash file1.txt file2.txt
+
+    Remove a file whose name starts with '-':
+        $ trash -- -foo
+        $ trash ./-foo
+
+    Display help message:
+        $ trash -h
+
+    Check the version:
+        $ trash --version
+
+BUGS
+    Report bugs at https://github.com/andreafrancia/trash-cli/issues.
+
+SEE ALSO
+    trash-list(1), trash-restore(1), trash-empty(1), trash-rm(1),
+    and the FreeDesktop.org Trash Specification: http://www.ramendik.ru/docs/trashspec.html
+
+AUTHORS
+    Originally written by Andrea Francia <andrea@andreafrancia.it>.
+    Contributions from the open-source community.