ptrash(1)

💖 ptrash(1) — the General Commands Manual, but make it a group chat 💖

okay bestie, welcome to the <rainbow>ptrash(1)</rainbow> page, the one and only manual for our girl ptrash. sit down, grab a strawberry 🍓, and let's get into it.

---

✨ NAME ✨

ptrash — move file(s) to the ~/.trash directory. that's it. that's the whole job. she moves stuff to the trash and she does it flawlessly. 👑

---

🌸 SYNOPSIS 🌸

ptrash [OPTIONS] file-name-1 [file-name-2 ...]

see how she takes multiple file names? yeah. she's not a one-file kind of girl. 💅

---

🦋 DESCRIPTION 🦋

so, ptrash is a console based simple application, and honestly? lowkey iconic for it. what she does is take the file(s) you named and move them into the trash directory that lives under your home directory — aka ~/.trash.

and here's the cute part: if ~/.trash doesn't exist yet, she doesn't just give up and cry about it 😭. she creates it for you and then moves your file(s) in there. self-sufficient queen. main character energy fr.

now, the thing you gotta know, bestie: by default ptrash runs in non-interactive mode. which means she does not ask you if you're sure before moving a file to ~/.trash — even when the named file already exists in trash. she just goes ahead and overwrites that file. no warning, no vibe check, nothing. so know what you're doing, okay? 🫶

---

💅 OPTIONS 💅

ptrash supports the following options, and yes we're going through every single one because they all matter:

• -d, --delete — delete file(s) from trash. like, gone gone. 🗑️
• -i — enables an interactive moving of files to/from trash. ie. it asks for confirmation before over writing OR deleting any existing file. she'll stop and ask, bestie. so polite of her. 🎀
• -r, --restore — restore a file from trash to it's original location. bringing your baby back home. 🏠✨
• -h, --help — prints this short usage help. the quick lil recap when you forget everything. 🙈
• -v, --verbose — verbose operation mode. she'll tell you everything she's doing, no secrets. 🗣️
• -V, --version — displays the version information. gotta know which era of ptrash you're living in. ⭐

---

🌈 SEE ALSO 🌈

the girlies she runs with: cp(1) mv(1) rm(1) shred(1)

(iykyk — shred(1) is the intense one 💀)

---

💀 BUG(s) 💀

if you think you have found a bug in ptrash, please write to me with the ptrash-<version> string in the subject line, explaining precisely about the behaviour of ptrash. be specific, be detailed, give me the whole story — not just "it broke". 😤

---

🧚 NOTE 🧚

ptrash does not facilitate moving of symbolic links to/from ~/.trash. no cap. don't try it, don't be surprised by it.

---

👑 AUTHOR 👑

Prasad J Pandit <pj.pandit at yahoo.co.in>

---

and that's the whole ptrash(1) manual, bestie!! you ate that reading. go forth and trash responsibly 🫶✨🎀🦋🌸💖