SHTOOL-MOVE.TMP(1)

💅 SHTOOL-MOVE.TMP(1) — GNU Portable Shell Tool 💅

okay bestie, so this is shtool-move, from the GNU Portable Shell Tool situation. it's literally the manual page for it, and no cap, it's giving "mv but with ✨extras✨". let's get into it 🫶

---

✨ NAME ✨

shtool-move — the GNU shtool glow-up version of mv(1), an enhanced replacement for it, periodt 💖

---

🌸 SYNOPSIS 🌸

shtool move [-v|--verbose] [-t|--trace] [-e|--expand] [-p|--preserve]
src-file dst-file

---

🦋 DESCRIPTION 🦋

so this is a mv(1) style command, right? but it ate and left no crumbs, because it comes with two extra superpowers:

• it can rename multiple files in a single operation 💫
• it can detect when the destination file already exists with the exact same content, and then simply not touch it — which means timestamps stay preserved 👑

---

🎀 OPTIONS 🎀

here's the full lineup, no skipping, every single one matters:

• -v, --verbose — shows you some processing info while it's doing its thing. it's giving "keep me posted bestie" 🗣️
• -t, --trace — turns on output of the essential shell commands that actually get executed. full transparency, iykyk 🔍
• -e, --expand — expands the asterisk in src so it can be used as ""%"n" (where n is 1,2,...) inside dst-file. this is the moment for renaming a whole pile of files at once, iconic behavior 🎯
• -p, --preserve — detects when src-file and dst-file have equal content and refuses to touch the existing destination file, which preserves the timestamps. this one's for the apps that monitor timestamps — i.e. it stops make(1L) from repeating actions for files that haven't changed. so considerate 💖

---

🌈 EXAMPLE 🌈

 #   shell script
 shtool move -v -e '*.txt' %1.asc

 #   Makefile
 scanner.c: scanner.l
     lex scanner.l
     shtool move -t -p lex.yy.c scanner.c

like, look at her go 💅

---

👑 HISTORY 👑

the GNU shtool move command was originally written by Ralf S. Engelschall <rse@engelschall.com> in 1999 for GNU shtool. a real one, fr fr 🫡

---

💜 SEE ALSO 💜

shtool(1), mv(1), make(1).

---

and that's the whole vibe check, bestie ✨ this page is from shtool 2.0.8, dated 18-Jul-2008 — yeah she's been around a minute and she still slays 🎀💖 go forth and move those files, main character 💅