KILLTREE
nged
BRL-CAD
BRL-CAD User Commands

# killtree

Deletes the specified objects from the current database and recursively deletes all objects referenced by any of those objects.

        killtree
          objects

## DESCRIPTION

Deletes the specified objects from the current database and recursively deletes all objects referenced by any of those objects. If one of the objects listed is a combination, then that combination as well as any objects that are members of that combination will be deleted. If a member of that combination is itself a combination, then all of its members will also be destroyed. This continues recursively until the primitive shapes are reached and destroyed. Note that the objects are killed immediately. There is no need for a `write file` command in MGED, and there is no `undo` command. Use this command with extreme caution. Other commands that remove objects from the database are `kill` and `killall`.

## EXAMPLES

The example shows the use of the `killtree` command to delete specified objects and all references to them from the current database.

### Delete objects and all references to them from the database.

mged> `killtree group1 region2 shapeb`

  Destroys group1, region2, and shapeb and removes all references to these objects from the database.

## AUTHOR

BRL-CAD Team

## BUG REPORTS

Reports of bugs or problems should be submitted via electronic mail to <devs@brlcad.org>, or via the "cadbug.sh" script.