--- cf.schmorp.de/server/pod/objects.pod	2006/12/20 21:30:42	1.16
+++ cf.schmorp.de/server/pod/objects.pod	2006/12/20 22:54:59	1.17
@@ -240,7 +240,23 @@
 =item FLAG_CHANGING
 
 If the I<state> field of the object is 0 the object will be processed periodically
-(if speed is set). If the I<state> field is 1 it won't be processed.
+(if I<speed> is set). If the I<state> field is 1 it won't be processed.
+
+This flag indicates that the object is changing into a different object.
+The object has to have the I<other_arch> field set. The object the changing object
+changes into is derived from the archetype in I<other_arch>.
+
+When the object does not have FLAG_ALIVE set the I<food> field will be decremented
+each time the object is processed, and if I<food> reaches 0 one new object will be generated.
+
+When the object has FLAG_ALIVE set the I<food> field is the number of objects that
+will be generated.
+
+After the new object is created the I<hp> field from the old object is copied into
+the new one.
+
+When the old object was a B<LAMP> it's I<food> fields value less 1 will be copied
+to the new object.
 
 =item FLAG_IS_A_TEMPLATE (internal use)
 
@@ -1014,7 +1030,47 @@
 
 =head3 B<LAMP> - type 82 - A lamp
 
-This object makes light.
+This object represents a lamp, that can be carried and switched
+on and off and has a certain amount of fuel in it.
+
+A lamp consists of two archetypes: the 'on' archetype and the 'off' archetype.
+Each of them should point at the other one with it's I<other_arch> field.
+
+See the I<other_arch> field for the behaviour of a lamp object when it is applied.
+
+=over 4
+
+=item I<speed> <number>
+
+If FLAG_CHANGING is set the I<speed> field will indicate how fast the
+lamp burns it's fuel (I<food>).
+
+Setting FLAG_CHANGING makes only sense on the archetype which represents
+the 'on' state of the lamp.
+
+See also the description of FLAG_CHANGING.
+
+Lamps which have no FLAG_CHANGING set would also make sense and represent
+lamps that never burn up.
+
+=item I<other_arch> <number>
+
+This is the field that points to the 'other' archetype which represents the
+opposite state of the lamp. The newly from I<other_arch> derived object will
+replace the current object and will get the value of I<food> of the replaced object.
+
+Rationale:
+
+When the lamp (on) is applied a new object is derived from the archetype
+in I<other_arch> and the I<food> value is copied to it ('the fuel is
+transferred'). The new lamp (off) object has to have a I<other_arch> field
+which points to the archetype from which a lamp (on) can be derived.
+
+=item I<food> <number>
+
+This fields stands for the fuel of the lamp.
+
+=back
 
 =head3 B<DUPLICATOR> - type 83 - Duplicators or: Multiplicators