--- deliantra/server/pod/objects.pod	2006/12/19 15:30:01	1.6
+++ deliantra/server/pod/objects.pod	2006/12/19 21:06:08	1.7
@@ -96,6 +96,10 @@
 equal to 0 the absolute value of the speed field is added to speed_left
 on the end of the tick.
 
+This means: the lower the speed field is (but still above MIN_ACTIVE_SPEED)
+the more seldom the object is processed. And the higher the speed field is
+the more often the object is processed.
+
 =item no_drop (0|1)
 
 Sets the flag FLAG_NO_DROP.
@@ -329,8 +333,7 @@
 
 =item on_use_yield <archetype>
 
-When this object is applied this object will be created.
-This field is also used by FOOD and POISON.
+When this object is applied an instance of <archetype> will be created.
 
 =item subtypes <potion subtype>
 
@@ -360,6 +363,42 @@
 
 =back
 
+=head3 FOOD - type 6 - Eatable stuff
+
+This is for objects that are representing general eatables like
+beef or bread.
+
+The main difference between FOOD, FLESH and DRINK is that they
+give different messages.
+
+The specialty of FLESH is that it inherits the resistancies of the
+monsters it was generated in and will let dragons raise their resistancies
+with that.
+
+If a player runs low on food he will grab for FOOD, DRINK and POISON
+and if he doesn't find any of that he will start eating FLESH.
+
+=over 4
+
+=item title <string>
+
+If the food has a title or is cursed it is considered 'special', which means that the
+fields Str, Dex, Con, Int, Wis, Pow, resist_<resistancy>, hp and sp
+are interpreted and have further effects on the player.
+
+The higher the food field is the longer the improvement of the player lasts
+(except for hp and sp).
+
+=item food <number>
+
+This is the amount of food points the player gets when he eats this.
+
+=item on_use_yield <archetype>
+
+When this object is applied an instance of <archetype> will be created.
+
+=back
+
 =head3 WEAPON - type 15 - Weapons
 
 This type is for general hack and slash weapons like swords, maces
@@ -506,6 +545,10 @@
    FLAG_SEE_IN_DARK
    FLAG_UNDEAD
 
+=head3 DRINK - type 54 - Drinkable stuff
+
+See FOOD description.
+
 =head3 CHECK_INV - type 64 - Inventory checkers
 
 This object checks whether the player has a specific item in his
@@ -561,6 +604,10 @@
 
 =back
 
+=head3 FLESH - type 72 - Organs and body parts
+
+See FOOD description.
+
 =head3 HOLE - type 94 - Holes
 
 Holes are holes in the ground where objects can fall through.  When the hole
@@ -619,6 +666,12 @@
 speed and speed_left field. Look above at the generic description of these
 fields.
 
+NOTE: Setting FLAG_IS_USED_UP on an force will also consider the 'food' field
+like stated above in the FLAG_IS_USED_UP description. BUT: If the food field reaches
+0 before duration and FLAG_APPLIED is set, the force will last for 'duration'.
+If the FLAG_APPLIED is not set the force is removed when food reaches 0.
+Generally this means: FLAG_IS_USED_UP doesn't have good semantics on forces.
+
 =over 4
 
 =item duration