set_light()
===========

SYNOPSIS
--------
::

        int set_light(int n)

DESCRIPTION
-----------
::

        An object is by default dark. It can be set to not dark by
        calling set_light(1). The environment will then also get this
        light. The returned value is the total number of lights in
        this room. So if you call set_light(0) it will return the
        light level of the current object.

        

        Note that the value of the argument is added to the light of
        the current object.

BUGS
----
::

	This handling of light by the parser is inappropriate for most
	purposes: If you put a burning candle into a safe, the safe
	will start to emit light.