--- deliantra/server/pod/events.pod	2007/01/02 11:08:36	1.13
+++ deliantra/server/pod/events.pod	2007/05/18 19:46:22	1.18
@@ -205,9 +205,17 @@
 moving onto it. This includes not just traps, but also buttons, holes,
 signs and similar stuff.
 
+=head3 open (container who -- )
+
+Invoked whenever a container gets opened. When overriden, the container will not
+get opened, but you must tell op about the reason.
+
 =head3 close (container who -- )
 
-Invoked whenever a container gets closed (this event is not yet reliable!).
+Invoked whenever a container gets closed. When overriden, the container
+will not get closed, but you must tell op about the reason. This event
+is not crash-safe, i.e. containers might be closed due to a server crash
+without this event being invoked.
 
 
 =head2 GLOBAL EVENTS
@@ -237,20 +245,21 @@
 
 =head3 kick (player params -- )
 
-Invoked when the given plaer is being kicked, before the kick is executed.
+Invoked when the given player is being kicked, before the kick is
+executed.
 
-=head3 load (player)
+=head3 load (player -- )
 
 Invoked whenever a player has been loaded from disk, but before
 actual login.
 
-=head3 save (player path -- )
+=head3 save (player -- )
 
-Invoked just before a player gets saved.
+Invoked just before a player gets serialised.
 
-=head3 save_done (player path -- )
+=head3 save_done (player -- )
 
-Invoked just after a player was saved.
+Invoked just after a player was serialised.
 
 =head3 connect (player -- )
 
@@ -288,6 +297,12 @@
 
 =head3 move (player direction -- )
 
+Called whenever the player is supposed to move or attack. The handler
+must handle the cases of speed_left or weapon_sp_left being negative,
+fire being on, is responsible for decreaseing the speed_left value
+on successful moves etc. etc.. When overriden, must return a boolean
+indicating wether a move could be effected.
+
 =head3 pray_altar (player altar skill -- )
 
 Invoked whenever the B<player> prays over an B<altar>, using the given B<skill>.
@@ -297,6 +312,11 @@
 Invoked whenever the player uses the B<tell> or B<reply> command, before
 it gets processed.
 
+=head3 told (player player message -- )
+
+Invoked right before a message is being told to a player using B<tell> or
+B<reply>.
+
 =head3 say (player message --)
 
 =head3 chat (player message --)
@@ -361,10 +381,15 @@
 Called as soon as a new connection to the server is established. Should
 not be overriden.
 
+=head3 setup (client string -- )
+
+Client sent the setup command to negotiate parameters. Handling is
+mandatory and done by F<login.ext>.
+
 =head3 addme (client -- )
 
-The client sent an addme, thus ending the initial handshaking. If overriden, the server
-will not send any response.
+The client sent an addme, thus ending the initial handshaking. Handling is mandatory
+and done by F<login.ext>.
 
 =head3 reply (client replystring -- )