TRASH-PUT(1)

💅 TRASH-PUT(1) — the manual page, but make it make sense

okay bestie, welcome to trash-put, from the General Commands Manual section. it's the command line trash utility and it's literally about to change your whole terminal life. let's get into it 🗑️✨

---

✨ NAME ✨

trash-put — Command line trash utility. that's it, that's the name, and it ate 💅

---

🦋 SYNOPSIS 🦋

trash [OPTION] ...  [ARGUMENTS] ...
trash-put [OPTION] ...  [ARGUMENTS] ...

two ways in, same energy. pick your fave 🫶

---

🌸 DESCRIPTION 🌸

so the Trash-cli package gives you a whole command line interface trashcan utility, and it's compliant with the FreeDesktop.org Trash Specification — yes, actual spec, actual standards, we love a girl who follows the rules. 👑

and the way it's thoughtful?? it remembers the name, original path, deletion date, and permissions of each trashed file. so when you go to restore something later you're not just digging through a mystery pile. she kept receipts, fr fr. 📝

now, where do the files actually go? depends on where they came from:

Files trashed from the home partition end up in either:

• $XDG_DATA_HOME/Trash
• or ~/.local/share/Trash/ (and that second one is used if $XDG_DATA_HOME is not defined or empty)

Files trashed from other partitions go to one of these two places:

• $top_dir/.Trash/$uid
• $top_dir/.Trash-$uid

and because i know you're gonna ask what those mean:

• $top_dir is the mount point of the volume containing the file to be removed
• $uid is the numeric ID of the deleting user

heads up on the picking logic: the first option, $top_dir/.Trash/$uid, works only when the .Trash dir has the sticky bit set. the second option, $top_dir/.Trash-$uid, is used when the first is not viable. so it's a fallback situation, not a choose-your-own-adventure 🧚

---

🎀 ARGUMENTS 🎀

• Names of files or directories to move to the trash can. that's the whole vibe. you hand her stuff, she trashes it. iconic behavior honestly. 💖

---

👑 OPTIONS 👑

• -f — silently ignore any files or directories that do not exist. no error messages printed, and no nonzero status returned to the caller because of any such nonexistent arguments. so if it's not there, she's just not gonna make it a whole thing. drama-free. 🙈
• -h, --help — show help message and exit. classic. 🫶
• --trash-dir=TRASHDIR — use TRASHDIR as the trash folder. you pick the spot, she respects the spot. ✨
• -v, --verbose — explain what is being done. she will narrate. commentary mode activated. 🗣️
• --version — show the program's version number and exit. 🏷️

---

🌈 EXAMPLES 🌈

$ trash-put foo   # trashes foo

look at that. one line. foo is gone. slay. 💅

---

💀 BUGS 💀

found something cursed? please, report bugs to https://github.com/andreafrancia/trash-cli/issues. the maintainers wanna know, bestie, don't gatekeep 🐛

---

💖 IF YOU WANT SAY THANKS 💖

feeling grateful? the options are:

• tweet (to @andreafrancia or #trash-cli)
• or donate 1, 2 or 5 euros using paypal: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=93L6PYT4WBN5A

yes the link is that long. copy it carefully. 😭

---

🌟 CREDITS 🌟

• Trash was written by Andrea Francia <andrea@andreafrancia.it>
• The original version of trash-empty was contributed by Einar Orn Olason <eoo@hi.is>
• The first version of manual pages was written by Steve Stalcup <vorian@ubuntu.com> and was modified by Massimo Cavalleri <submax@tiscalinet.it>

legends, all of them, no cap 🫡

---

🔥 SEE ALSO 🔥

• trash-list(1)
• trash-restore(1)
• trash-empty(1)
• trash-rm(1)
• and the FreeDesktop.org Trash Specification at https://specifications.freedesktop.org/trash-spec/trashspec-1.0.html

Both are released under the GNU General Public License, version 2 or later. 📜

---

and that's the whole page, bestie 🎀 footer says TRASH-PUT(1) and it's a General Commands Manual situation — go forth and trash responsibly, you absolute main character 💜