--- deliantra/server/pod/events.pod	2007/01/07 02:39:14	1.14
+++ 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
@@ -289,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>.
@@ -298,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 --)
@@ -362,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 -- )