KILLREFS(nged)

💅 KILLREFS(nged) — the BRL-CAD User Commands glow-up

okay so bestie, welcome to KILLREFS, straight out of the BRL-CAD User Commands lineup. she's a little dangerous, she's a little iconic, and she's gonna clean up your combination references whether you're ready or not 🎀

---

✨ NAME ✨

killrefs — removes all references to the specified objects from all combinations in the database. no crumbs left, periodt.

---

🦋 SYNOPSIS 🦋

killrefs [-n] {objects}

---

💖 DESCRIPTION 💖

So here's the tea: killrefs removes all references to the specified objects from all combinations in the database. like, every combination that's holding onto those objects? it's letting them go. moving on. main character energy only 💅

Big important note though — the references are removed immediately unless you pass the -n flag. The -n flag makes the command return a string of the objects that would be affected, in a scriptable list format, without actually editing them. so it's the "let me just look, not touch" flag. window shopping. very demure, very mindful ✨

Also peep the killall command — that one's in the same family, iykyk.

⚠️ Use this command with caution. Killed objects cannot be recovered, so keep a backup. fr fr, back it up first. this is not the moment to be brave 😭

---

🌸 EXAMPLES 🌸

This example shows the use of the killrefs command to remove all references to the specified objects from the database.

⭐ Example 1. Remove all references to the specified objects from the database.

mged> killref group1
    Removes all references to group1 from the database.

This example shows the use of the killrefs command to list all references to the specified objects in the database.

🎀 Example 2. List all references to the specified objects in the database.

mged> killref -n group1
    Lists all references to group1 in the database.

---

🫶 SEE ALSO 🫶

• kill(nged)
• killtree(nged)

go read those too, they're the supporting cast and they ate 💅

---

👑 AUTHOR 👑

BRL-CAD Team — the icons behind the whole thing 🌈

---

🐛 BUG REPORTS 🐛

Reports of bugs or problems should be submitted via electronic mail to devs@brlcad.org — don't be shy, they wanna know 🍓

---

and that's the whole page bestie, no cap 🧚‍♀️ this came to you from BRL-CAD — KILLREFS(nged), BRL-CAD User Commands. stay safe, back up your stuff, and slay your references responsibly 💜✨