Imported from archive.
[mudpy.git] / command
diff --git a/command b/command
index a9ec05e..17ac3e3 100644 (file)
--- a/command
+++ b/command
@@ -1,33 +1,81 @@
-[control]
+# Copyright (c) 2004-2009 Jeremy Stanley <fungi@yuggoth.org>. Permission
+# to use, copy, modify, and distribute this software is granted under
+# terms provided in the LICENSE file distributed with this software.
+
+[__control__]
 read_only = yes
 
-[command:quit]
-action = command_quit(user, command, parameters)
-description = Leave Example.
-help = This will save your account and disconnect your client connection.
+[command:chat]
+action = command_chat(actor)
+description = Enter and leave chat mode.
+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
+see_also = say
+
+[command:create]
+action = command_create(actor, parameters)
+administrative = yes
+description = Create a new element in the universe.
+help = Ways to create an element:$(eol)$(eol)   create actor:fred$(eol)   create other:garply foo/bar/baz
+
+[command:delete]
+action = command_delete(actor, parameters)
+administrative = yes
+description = Delete an existing facet from an element.
+help = You can delete any facet of an element as follows:$(eol)$(eol)   delete location:boardroom terrain
+
+[command:destroy]
+action = command_destroy(actor, parameters)
+administrative = yes
+description = Destroy an existing element in the universe.
+help = You can destroy any element in the universe as follows:$(eol)$(eol)   destroy prop:dagger
 
 [command:halt]
-action = command_halt(user, command, parameters)
+action = command_halt(actor, parameters)
+administrative = yes
 description = Shut down the world.
 help = This will save all active accounts, disconnect all clients and stop the entire program.
 
 [command:help]
-action = command_help(user, command, parameters)
+action = command_help(actor, parameters)
 description = List commands or get help on one.
 help = This will list all comand words available to you along with a brief description or, alternatively, give you detailed information on one command.
 
-[command:show]
-action = command_show(user, command, parameters)
-description = Show program data.
-help = For now, this is used to show things like "avatars", "time" and "universe".
+[command:look]
+action = command_look(actor, parameters)
+description = Look around.
+help = With the look command, you can see where you are.
+
+[command:move]
+action = command_move(actor, parameters)
+description = Move in a specific direction.
+help = You move in a direction by entering:$(eol)$(eol)   move north
+
+[command:quit]
+action = command_quit(actor)
+description = Leave Example.
+help = This will deactivate your avatar and return you to the main menu.
 
 [command:reload]
-action = command_reload(user, command, parameters)
-description = Reload code modules and data.
-help = This will reload all python code modules, reload configuration files and re-read data files.
+action = command_reload(actor)
+administrative = yes
+description = Reload modules and data.
+help = This will reload all python modules and read-only data files.
 
 [command:say]
-action = command_say(user, command, parameters)
+action = command_say(actor, parameters)
 description = State something out loud.
-help = This allows you to speak to other characters within the same room. If you end your sentence with specific punctuation, the aparent speech action (ask, exclaim, et cetera) will be adapted accordingly. It will also add punctuation and capitalize your message where needed.
+help = This allows you to speak to other characters within the same room. If you end your sentence with punctuation, the message displayed will incorporate an appropriate action (ask, exclaim, et cetera). It will also correct common typographical errors, add punctuation and capitalize your sentence as needed (assuming you speak one sentence per line). For example:$(eol)$(eol)   > say youre sure i went teh wrong way?$(eol)   You ask, "You're sure I went the wrong way?"
+see_also = chat
+
+[command:set]
+action = command_set(actor, parameters)
+administrative = yes
+description = Set a facet of an element.
+help = Invoke it like this:$(eol)$(eol)   set actor:dominique description You see nothing special.
+
+[command:show]
+action = command_show(actor, parameters)
+administrative = yes
+description = Show various data.
+help = Here are the possible incantations (<parameter> is required, [option] is optional, (note) is a note):$(eol)$(eol)   show categories (list all element category names)$(eol)   show category <category> (list the elements in a category)$(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 [level [start [stop]]] (list logs above level from start to stop)$(eol)   show result <expression> (evaluates a python expression)$(eol)   show time (returns several current timer values)