<!-- Converted by db4-upgrade version 1.0 -->

<refentry xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="killtree">

<refmeta>
  <refentrytitle>KILLTREE</refentrytitle>
  <manvolnum>nged</manvolnum>
  <refmiscinfo class="source">BRL-CAD</refmiscinfo>
  <refmiscinfo class="manual">BRL-CAD User Commands</refmiscinfo>
</refmeta>

<refnamediv xml:id="name">
  <refname>killtree</refname>
  <refpurpose>Deletes the specified <emphasis>objects</emphasis> from the current database and
recursively deletes all objects referenced by any of those objects.</refpurpose>
</refnamediv>

<!-- body begins here -->
<refsynopsisdiv xml:id="synopsis">
  <cmdsynopsis sepchar=" ">
    <command>killtree</command>    
      <arg choice="req" rep="norepeat"><replaceable>objects</replaceable></arg>
    </cmdsynopsis>
</refsynopsisdiv>

<refsection xml:id="description"><info><title>DESCRIPTION</title></info>
  
  <para>Deletes the specified <emphasis>objects</emphasis> from the current database and
	recursively deletes all objects referenced by any of those objects. If one of the 	<emphasis>objects</emphasis> listed is a combination, then that <emphasis>combination	</emphasis> as well as any objects that are members of that <emphasis>combination	</emphasis> will be deleted. If a member of that <emphasis>combination</emphasis> is 	itself a <emphasis>combination</emphasis>, then all of its members will also be destroyed. 	This continues recursively until the primitive shapes are reached and destroyed. Note that 	the <emphasis>objects</emphasis> are killed immediately. There is no need for a <command>	write file</command> command in MGED, and there is no <command>undo</command> command.  	<emphasis remap="B" role="bold">Use this command with extreme caution.</emphasis> Other 	commands that remove objects from the database are <command>kill</command> and <command>	killall</command>.    
    </para>
</refsection>

<refsection xml:id="examples"><info><title>EXAMPLES</title></info>
  
  <para>The example shows the use of the <command>killtree</command> command to delete specified 	objects and all references to them from the current database.
  </para>
  <example><info><title>Delete objects and all references to them from the database.</title></info>
    
    <variablelist>
      <varlistentry>
	   <term><prompt>mged&gt;</prompt> <userinput>killtree group1 region2 shapeb</userinput>			</term>
	   <listitem>
	     <para>Destroys <emphasis>group1</emphasis>, <emphasis>region2</emphasis>, and 					<emphasis>shapeb</emphasis> and removes all references to these objects
			from the database.
	     </para>
	   </listitem>
      </varlistentry>
    </variablelist>
  </example>
  
</refsection>

<info><corpauthor>BRL-CAD Team</corpauthor></info>

<refsection xml:id="bug_reports"><info><title>BUG REPORTS</title></info>
  
  <para>
    Reports of bugs or problems should be submitted via electronic
    mail to &lt;devs@brlcad.org&gt;, or via the "cadbug.sh" script.
  </para>
</refsection>
</refentry>
