Alphabetize entries in command data file

[mudpy.git] / share / command.yaml

diff --git a/share/command.yaml b/share/command.yaml
index e5d113f..fd78a03 100644 (file)
--- a/share/command.yaml
+++ b/share/command.yaml
@@ -1,5 +1,5 @@
 ---
 ---

-_copy: Copyright (c) 2004-2019 mudpy authors. Permission to use, copy,
+_copy: Copyright (c) 2004-2020 mudpy authors. Permission to use, copy,

     modify, and distribute this software is granted under terms
     provided in the LICENSE file distributed with this software.
 
     modify, and distribute this software is granted under terms
     provided in the LICENSE file distributed with this software.
 


@@ -12,7 +12,8 @@ command.chat.help: The chat command toggles chat mode. When in chat mode, all
     input is passed as a parameter to the say command, unless prepended by an
     exclamation mark (!). For example, to leave chat mode,
     use:$(eol)$(eol)   !chat
     input is passed as a parameter to the say command, unless prepended by an
     exclamation mark (!). For example, to leave chat mode,
     use:$(eol)$(eol)   !chat

-command.chat.see_also: say
+command.chat.see_also:
+    - say

 
 command.create.administrative: true
 command.create.description: Create a new element in the universe.
 
 command.create.administrative: true
 command.create.description: Create a new element in the universe.


@@ -29,13 +30,27 @@ command.destroy.description: Destroy an existing element in the universe.
 command.destroy.help: You can destroy any element in the universe as
     follows:$(eol)$(eol)   destroy prop.dagger
 
 command.destroy.help: You can destroy any element in the universe as
     follows:$(eol)$(eol)   destroy prop.dagger
 

+command.evaluate.debugging: true
+command.evaluate.description: Evaluate a Python expression.
+command.evaluate.help: For debugging purposes, you can use this to run certain
+    Python language expressions within the running engine's context, though for
+    safety reasons only a limited set of builtins are allowed, as well as
+    objects in the mudpy package namespace and the active universe object.
+    Expressions containing "__" or "lambda" are also prohobited for additional
+    safety. Everything following the word "evaluate" is assumed to be a Python
+    expression, and is passed to the eval() built-in, outputting a string
+    representation of whatever it returns. Any exceptions are caught in an
+    attempt to avoid accidentally crashing the engine. This command is mostly
+    useful for inspecting the contents of in-memory objects, for
+    example:$(eol)$(eol) evaluate universe.groups['actor'].keys()
+

 command.halt.administrative: true
 command.halt.description: Shut down the world.
 command.halt.help: This will save all active accounts, disconnect all clients
     and stop the entire program.
 
 command.help.description: List commands or get help on one.
 command.halt.administrative: true
 command.halt.description: Shut down the world.
 command.halt.help: This will save all active accounts, disconnect all clients
     and stop the entire program.
 
 command.help.description: List commands or get help on one.

-command.help.help: This will list all comand words available to you along with
+command.help.help: This will list all command words available to you along with

     a brief description or, alternatively, give you detailed information on one
     command.
 
     a brief description or, alternatively, give you detailed information on one
     command.
 


@@ -43,8 +58,9 @@ command.look.description: Look around.
 command.look.help: With the look command, you can see where you are.
 
 command.move.description: Move in a specific direction.
 command.look.help: With the look command, you can see where you are.
 
 command.move.description: Move in a specific direction.

-command.move.help: You move in a direction by entering:$(eol)$(eol)   move
-    north
+command.move.help: Move to another place by supplying the name of a
+    portal/direction or a suitable abbreviation for one,
+    like:$(eol)$(eol)   move north$(eol)   move s

 
 command.preferences.description: View or change your preferences.
 command.preferences.help: If invoked with no parameters, all your current
 
 command.preferences.description: View or change your preferences.
 command.preferences.help: If invoked with no parameters, all your current


@@ -74,7 +90,8 @@ command.say.help: This allows you to speak to other characters within the same
     ask, "You're sure I went the wrong way?"$(eol)$(eol)If necessary, enclose
     literal statements in quotation marks:$(eol)$(eol)   > say "youre sure i
     went teh wrong way?"$(eol)   You say, "youre sure i went teh wrong way?"
     ask, "You're sure I went the wrong way?"$(eol)$(eol)If necessary, enclose
     literal statements in quotation marks:$(eol)$(eol)   > say "youre sure i
     went teh wrong way?"$(eol)   You say, "youre sure i went teh wrong way?"

-command.say.see_also: chat
+command.say.see_also:
+    - chat

 
 command.set.action: command.c_set
 command.set.administrative: true
 
 command.set.action: command.c_set
 command.set.administrative: true


@@ -92,6 +109,5 @@ command.show.help: Here are the possible incantations (<parameter> is required,
     data files)$(eol)   show group <group> (list the elements in a
     group)$(eol)   show groups (list all element group names)$(eol)   show log
     [level [start [stop]]] (list logs above level from start to
     data files)$(eol)   show group <group> (list the elements in a
     group)$(eol)   show groups (list all element group names)$(eol)   show log
     [level [start [stop]]] (list logs above level from start to

-    stop)$(eol)   show result <expression> (evaluate a python
-    expression)$(eol)   show time (return several current timer
+    stop)$(eol)   show time (return several current timer

     values)$(eol)   show version (display running version and dependencies)
     values)$(eol)   show version (display running version and dependencies)