--- deliantra/server/pod/objects.pod	2006/12/18 16:53:04	1.4
+++ deliantra/server/pod/objects.pod	2006/12/19 13:41:45	1.5
@@ -116,6 +116,16 @@
 Sets the flag FLAG_AUTO_APPLY.
 See Flags section below.
 
+=item activate_on_push (0|1) (default: 1)
+
+Sets the flag FLAG_ACTIVATE_ON_PUSH.
+See Flags section below.
+
+=item activate_on_release (0|1) (default: 1)
+
+Sets the flag FLAG_ACTIVATE_ON_RELEASE.
+See Flags section below.
+
 =item editable (more than deprecated)
 
 This field had a special meaning for crossedit, which used parts
@@ -165,6 +175,22 @@
 
 This flag has currently only meaning for the TREASURE type, see below.
 
+=item FLAG_ACTIVATE_ON_PUSH
+
+This flag has only meaning for objects that can be linked together
+with the 'connected' field and controls wether the object should
+be activated when the connection is 'pushed' or it is 'released'.
+
+This flag is by default on.
+
+=item FLAG_ACTIVATE_ON_RELEASE
+
+This flag has only meaning for objects that can be linked together
+with the 'connected' field and controls wether the object should
+be activated when the connection is 'pushed' or it is 'released'.
+
+This flag is by default on.
+
 =back
 
 =head2 Description of type specific attributes
@@ -480,10 +506,57 @@
    FLAG_SEE_IN_DARK
    FLAG_UNDEAD
 
+=head3 HOLE - type 94 - Holes
+
+Holes are holes in the ground where objects can fall through.  When the hole
+opens and/or is completly open all objects above it fall through (more
+precisely: if their head is above the hole).
+
+Trapdoors can only transfer the one who falls through to other coordinates
+on the B<same> map.
+
+=over 4
+
+=item maxsp (0|1)
+
+This field negates the state of the connection: When maxsp is 1 the pit will
+open/close when the connection is deactivated.  Otherwise it will open/close
+when the connection is activated. This field only has effect when the
+connection is triggered. So if you put a closed hole on a map, and the
+connection is deactivated, and maxsp is 1 the hole will remain closed until the
+connection was triggered once.
+
+=item connected <connection id>
+
+This is the connection id, which lets the hole opening or closing when
+activated. The flags FLAG_ACTIVATE_ON_PUSH and FLAG_ACTIVATE_ON_RELEASE control
+at which connection state the object is activated.
+
+For example: if FLAG_ACTIVATE_ON_RELEASE is set to 0 the hole won't react when
+the connection is released.
+
+=item wc <number> (internal)
+
+This is an internal flag. If it is greater than 0 it means that the hole is not
+yet fully open. More preciesly: this field is the animation-step and if it is
+set to the 'closed' step of the animation the hole is closed and if it is on
+the 'open' animation step (wc = 0), the hole is open.
+
+=item sp <number>
+
+The destination y coordinates on the same map.
+
+=item hp <number>
+
+The destination x coordinates on the same map.
+
+=back
+
 =head3 FORCE - type 114 - Forces
 
 Forces are a very 'thin' type. They don't have much behaviour other than
-disappearing after a time and/or affecting the player if they are in his inventory.
+disappearing after a time and/or affecting the player if they are in his
+inventory.
 
 Forces only take effect on the player if they have set FLAG_APPLIED.
 
@@ -495,8 +568,8 @@
 
 =item duration
 
-While this field is greater than 0 the force/object is not destroyed.
-It is decreased each tick by 1.
+While this field is greater than 0 the force/object is not destroyed.  It is
+decreased each tick by 1.
 
 If it reaches 0 the force/object is destroyed.
 
@@ -508,10 +581,11 @@
 
 =head3 POTION_EFFECT - type 115 - Potion effects (resistancies)
 
-This object is generated by the POTION code when the potion is a
-resistance giving potion. It has mainly the same behaviour as a FORCE.
+This object is generated by the POTION code when the potion is a resistance
+giving potion. It has mainly the same behaviour as a FORCE.
 
 The specialty of the potion effect is that the resistancy it gives is absolute,
-so if you drin a resistancy potion of fire+60 you will get 60% resistancy to fire.
+so if you drin a resistancy potion of fire+60 you will get 60% resistancy to
+fire.
 
 Multiple potion effects only give you the maximum of their resistancy.