NAME
	compile_object - compile an object

SYNOPSIS
	object compile_object(string file)


DESCRIPTION
	Compile an object from a LPC file, specified by the argument string
	with ".c" appended.  The returned object will have the argument string
	as name.
	If the object to be compiled already exists and is not inherited by
	any other object, it and all of its clones will be upgraded to the
	new version.  Variables will be preserved only if they also exist in
	the new version and have the same type; new variables will be
	initialized to nil.  The actual upgrading is done immediately upon
	completion of the current thread.
	If the new object has "lib" as a path component, it can only be
	inherited and nil is returned.  Otherwise, if the object has "obj" as a
	path component, it can be cloned.

ACCESS
	The current object must have write access to the file to be compiled.

SEE ALSO
	kfun/object_name
