MVALL(nged)

Changes the name of old_name to new_name wherever it occurs in the database.

📅 published 7.44.0, from nixpkgs unstable

💅 MVALL(nged) — the rename-everywhere slayer ✨

okay so this is MVALL from the BRL-CAD User Commands lineup, and it’s an nged command. Think of it as the group-chat announcement that changes a name everywhere in the database, not just in one little corner. no cap.

🎀 NAME 🎀

mvall — Changes the name of old_name to new_name wherever it occurs in the database. 💖

✨ SYNOPSIS ✨

mvall [-n] [(-f mapping_file) | (old_name new_name)]

💖 DESCRIPTION 💖

okay bestie, here’s the tea: mvall changes the name of old_name to new_name. This will also change any references to old_name that may occur in other combinations in the database. It’s giving full-database ripple effect, not just a tiny local rename. 🌊

If the -f variation of the command is used, all old_name new_name pairings are read from the mapping_file and processed as previously stated. Like, the whole mapping file gets its moment. 🎀

The flags, bestie:

  • -n — returns all groups that will be affected if the command were run but without changing the name, essentially running a dbfind on old_name. It’s the “show me the receipts first” mode. 👀
  • -f mapping_file — uses the mapping_file variation, where all old_name new_name pairings are read from the file and processed as described above. very organized of you. 🗂️

🦋 EXAMPLES 🦋

Example 1 — rename everywhere, slay everywhere 👑

Change the name of an object everywhere it occurs in the database.

mged>mvall shapea shapeb

Changes the name of shapea to shapeb everywhere it occurs in the database. periodt. 💅

Example 2 — the mapping file moment 🎀

This example shows a simple mapping file.

# this line is a comment
old_name new_name
foo bar # another comment, replacing foo with bar
bad_name good_name

🔥 SEE ALSO 🔥

Go give some love to mv and prefix too — those are the SEE ALSO besties. 🫶

👑 AUTHOR 👑

BRL-CAD Team 👑✨

🐛 BUG REPORTS 🐛

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org. Don’t be shy, bestie — bug reports are how we keep the vibe immaculate. 📬💖

okay that’s the whole page! 💖 Source/version: BRL-CAD. Manual: MVALL(nged). Date: not shown in the footer, bestie — so here’s your cute sign-off: may your names always resolve and your references stay updated. 🌈🫶💅

📦 where this page comes from