Alphabetize entries in command data file

[mudpy.git] / share / command.yaml

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

-_copy: Copyright (c) 2004-2018 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.
 


@@ -7,65 +7,79 @@ _desc: This is the standard library of command definitions.
 
 _lock: true
 
 
 _lock: true
 

-command.chat.action: command_chat(actor)

 command.chat.description: Enter and leave chat mode.
 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
 command.chat.description: Enter and leave chat mode.
 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

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

 
 

-command.create.action: command_create(actor, parameters)

 command.create.administrative: true
 command.create.description: Create a new element in the universe.
 command.create.help: Ways to create an element:$(eol)$(eol)   create
 command.create.administrative: true
 command.create.description: Create a new element in the universe.
 command.create.help: Ways to create an element:$(eol)$(eol)   create

-    actor:fred$(eol)   create other:garply foo/bar/baz
+    actor.avatar_fred_1$(eol)   create other.garply foo/bar/baz

 
 

-command.delete.action: command_delete(actor, parameters)

 command.delete.administrative: true
 command.delete.description: Delete an existing facet from an element.
 command.delete.help: You can delete any facet of an element as
 command.delete.administrative: true
 command.delete.description: Delete an existing facet from an element.
 command.delete.help: You can delete any facet of an element as

-    follows:$(eol)$(eol)   delete area:boardroom terrain
+    follows:$(eol)$(eol)   delete area.boardroom terrain

 
 

-command.destroy.action: command_destroy(actor, parameters)

 command.destroy.administrative: true
 command.destroy.description: Destroy an existing element in the universe.
 command.destroy.help: You can destroy any element in the universe as
 command.destroy.administrative: true
 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
+    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.action: command_halt(actor, parameters)

 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.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.action: command_help(actor, parameters)

 command.help.description: List commands or get help on one.
 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.
 

-command.look.action: command_look(actor, parameters)

 command.look.description: Look around.
 command.look.help: With the look command, you can see where you are.
 
 command.look.description: Look around.
 command.look.help: With the look command, you can see where you are.
 

-command.move.action: command_move(actor, parameters)

 command.move.description: Move in a specific direction.
 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
+    preferences and their values are listed. If one parameter is supplied, the
+    value of the preference with that name is displayed. If more than one
+    parameter is supplied, the first must be the name of a preference and the
+    remainder is the value to which you wish to change it.
+    Examples:$(eol)$(eol)   preferences$(eol)   preferences
+    prompt$(eol)   preferences prompt $_(time)>

 
 

-command.quit.action: command_quit(actor)

 command.quit.description: Leave the World.
 command.quit.help: This will deactivate your avatar and return you to the main
     menu.
 
 command.quit.description: Leave the World.
 command.quit.help: This will deactivate your avatar and return you to the main
     menu.
 

-command.reload.action: command_reload(actor)

 command.reload.administrative: true
 command.reload.description: Reload modules and data.
 command.reload.help: This will reload all python modules and read-only data
     files.
 
 command.reload.administrative: true
 command.reload.description: Reload modules and data.
 command.reload.help: This will reload all python modules and read-only data
     files.
 

-command.say.action: command_say(actor, parameters)

 command.say.description: State something out loud.
 command.say.help: This allows you to speak to other characters within the same
     area. If you end your sentence with punctuation, the message displayed will
 command.say.description: State something out loud.
 command.say.help: This allows you to speak to other characters within the same
     area. If you end your sentence with punctuation, the message displayed will


@@ -76,24 +90,24 @@ 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_set(actor, parameters)
+command.set.action: command.c_set

 command.set.administrative: true
 command.set.description: Set a facet of an element.
 command.set.administrative: true
 command.set.description: Set a facet of an element.

-command.set.help: Invoke it like this:$(eol)$(eol)   set actor:dominique
-    description You see nothing special.
+command.set.help: Invoke it like
+    this:$(eol)$(eol)   set actor.avatar_dominique_0 description You see
+    nothing special.

 
 

-command.show.action: command_show(actor, parameters)

 command.show.administrative: true
 command.show.description: Show various data.
 command.show.help: Here are the possible incantations (<parameter> is required,
 command.show.administrative: true
 command.show.description: Show various data.
 command.show.help: Here are the possible incantations (<parameter> is required,

-    [option] is optional, (note) is a note):$(eol)$(eol)   show groups (list
-    all element group names)$(eol)   show group <group> (list the elements in a
-    group)$(eol)   show element <element> (list facet definitions for an
-    element)$(eol)   show file <filename> (list elements in a
-    file)$(eol)   show files (list all element data files)$(eol)   show log
+    [option] is optional, (note) is a note):$(eol)$(eol)   show element
+    <element> (list facet definitions for an element)$(eol)   show file
+    <filename> (list elements in a file)$(eol)   show files (list all element
+    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
     [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)