.\"load a copy of an object
.TH clone_object 3

.SH NAME
clone_object() - load a copy of an object

.SH SYNOPSIS
object clone_object( string name );

.SH DESCRIPTION
Load a new object from definition <name>, and give it a new unique
name.  Returns the new object.  An object with a nonzero environment()
cannot be cloned.

.SH SEE ALSO
destruct(3), move_object(3)