MOVE_ALL(nged)

💅 MOVE_ALL(nged) — the BRL-CAD glow-up rename command

okay so bestie, welcome to the MOVE_ALL(nged) page 💖 this is a BRL-CAD User Command, and honestly? it's the main character of renaming. take a seat, we're gonna go through it together.

---

✨ NAME ✨

move_all, mvall — rename an object and update all references throughout the database 🫶

---

🌸 SYNOPSIS 🌸

move_all [-n] from to
move_all [-n] -f mapping_file
mvall [-n] from to
mvall [-n] -f mapping_file

---

🦋 DESCRIPTION 🦋

The move_all command (also available as mvall, same energy, different name) renames a database object from from to to and then propagates that rename throughout the entire database, updating every single combination that references the old name. it's giving thorough. it's giving "i did the whole thing, not just the easy part."

that makes it a way more thorough alternative to the basic move/mv command — because that one only renames the object itself and then dips 😭

here's the full set of operations it performs, in order:

1. Object rename — renames from to to in the database directory and on disk (equivalent to move from to).
2. Combination propagation — scans every combination (comb) in the database and replaces all leaf references to from with to via db_comb_mvall.
3. Sketch/extrude cross-reference — if from is a sketch primitive, all extrude objects referencing it by name get updated too. yes, even those.
4. Display list update — scans the current display list and updates any path component that matches from — at any depth in the hierarchy, not just the top level (unlike the basic move command). she goes deep. 💅

---

🎀 Options 🎀

• -n — Dry-run mode. instead of doing the rename, it prints a list of all combination names that currently reference from. No changes are made to the database. it's the "let me just look first" option and we respect her 🙈
• -f mapping_file — Read rename pairs from a file instead of the command line. Each line of the file must contain two whitespace-separated names (from to). Lines beginning with # are treated as comments and ignored. batch mode, slay.

---

💜 Notes 💜

• Returns an error if to already exists in the database. no stealing names, periodt.
• In version 4 (v4) databases, the new name is limited to NAMESIZE characters. keep it cute, keep it short ⭐

---

🔥 EXAMPLES 🔥

Example 1. Rename and propagate throughout the database

mged> move_all old_part.s new_part.s

Renames old_part.s to new_part.s and updates every combination in the database that referenced old_part.s. one command, whole database handled 🫶

Example 2. Dry-run: find all references before renaming

mged> move_all -n wing.r fuselage_wing.r

Prints the names of all combinations that reference wing.r without making any changes. super useful for previewing the impact of the rename before you commit, ngl. vibe check first, always 💖

Example 3. Batch rename from a mapping file

mged> move_all -f renames.txt

Reads renames.txt and applies each rename pair listed. Example file contents:

# Rename all parts for new revision
old_hub.s      new_hub.s
old_spoke.s    new_spoke.s
# old_rim.s skipped intentionally

---

👑 AUTHOR 👑

BRL-CAD Team

---

🌈 BUG REPORTS 🌈

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — pls do tell them, they wanna know 💀🫶

---

okay that's the whole page, you ate that bestie 🍓 this was MOVE_ALL(nged) from the BRL-CAD crew, footer vibes and all — go rename something iconic ✨💅