--- deliantra/server/pod/command_help.pod	2006/09/09 22:54:31	1.2
+++ deliantra/server/pod/command_help.pod	2007/01/05 22:46:39	1.5
@@ -1,3 +1,11 @@
+=begin comment
+***
+*** WARNING: THIS IS A GENERATED FILE - CHANGES WILL BE LOST
+*** The source for this file is in CFPlus/pod/command_help.pod
+*** Make any changes there and then run ./copy_doc
+***
+=end comment
+
 =head1 Crossfire+ Command ListingX<command>
 
 =head2 accept-invitation
@@ -395,6 +403,8 @@
 
 =head2 killpets
 
+   killpets [name]
+
 The killpets command is a quick and convenient way
 to get rid of all your pets when they are no longer
 useful or are getting in the way. Any equipment
@@ -409,7 +419,9 @@
 
 =head2 listen
 
-Listen, sets the level of messages you will hear.
+   listen <listen-level>
+
+Listen sets the level of messages you will hear.
 Priorities are defined as follows:
 
    0  - Nothing, not even "You punch kobold." or "You say: hi".
@@ -441,17 +453,39 @@
 
 =head2 maps
 
-Shows a list of maps that are currently being visited or have been visited.
-The different fields are Path, Pl, PlM, IM, TO, Dif and Reset. They mean:
+[crossfire+]
+
+   maps <mapname>
+
+Shows a list of maps matching the regex <mapname> that are currently being
+known to the server. The different fields are Pl, I, Svd, Reset and Path:
+
+=over 4
+
+=item Pl: the number of players on that map currently.
+
+=item I: B<I>n memory, B<S>wapped out or B<L>oading.
+
+The server keeps maps in memory only for a short time (by default about
+40 seconds). After that time, it saves them to disk. As the server loads
+most maps in the background it is possible that you can see a map that is
+currently being loaded, but thats rare, as loading a map is fast.
+
+=item Svd: the amount of seconds the map was last saved (++ means >99).
+
+The server by default tries to save each map at least every 20 seconds if
+it changed, so in case of a disastrous crash (one where the server cannot
+emergency save), at most 20 seconds of gameplay are lost.
+
+=item Reset: the minimum number of seconds the map will stay as is (will not reset).
+
+Most maps will not reset as long as players are on it, and usually the
+reset counter only starts going down when all players left the map.
+
+=item Path: the name that uniquely identifies the map, can be used for goto etc.
+
+=back
 
-Path: The last part of the map path
-Pl: Players on the map.
-PlM: Players on the map recounted (should be the same as Pl).
-IM: In memory means whether the map is: 1) in memory, 2) swapped to disk,
-3) currently loading or 4) currently saving.
-TO: Timeout, when the map is swapped to disk.
-Dif: Map difficulty.
-Reset: Real server time when the map is going to reset.
 
 =head2 mark
 
@@ -735,15 +769,17 @@
 
 =head2 rename
 
-Changes the custom name of an item.
-
-   rename <item name> to <new name>
+Changes/removes the custom name of given item (or the marked one).
 
-(Note: the angle brackets (<>) are mandatory and part of the syntax)
+   rename oldname to newname
+   rename "old item name" to "new item name"
 
-If '<item name>' is omitted, defaults to marked item.
+If either of the names contain spaces, you have to use the C<">-form,
+otherwise you can just write the name as-is. If you omit the old name, the
+marked item will be used instead.
 
-If 'to <new name>' is omitted, clears the custom name.
+If the new name is empty (i.e. C<"">), then the original (unrenamed) name
+will be restored.
 
 Note: maximum allowed name length is 127 characters.
 
@@ -969,6 +1005,11 @@
 
 Cancels all ignores set for the specified login. See B<ignore>.
 
+=head2 uptime
+
+Tells you something about the time the server was started and how long ago
+that was.
+
 =head2 use_skill
 
    use_skill <name of skill>