Update doc/efun/ aus Driversourcen.
Manpages der efuns aktualisiert, neue Manpages hinzugefuegt.
Change-Id: I7cc91684269ff56d1aef47d5c5e7c87f7fd531dc
diff --git a/doc/efun/execute_command b/doc/efun/execute_command
index 1ef2343..c0e8a0b 100644
--- a/doc/efun/execute_command
+++ b/doc/efun/execute_command
@@ -1,21 +1,27 @@
-VORLAEUFIG, GESCHUETZT
SYNOPSIS
int execute_command(string command, object origin, object player)
-BESCHREIBUNG
- Diese Funktion bietet Low-Level Zugriff auf den Kommandoparser:
- <command> wird in Verb und Rest aufgespaltet und es werden die
- entsprechenden add_actions in <origin> aufgerufen. Fuer die
- Ausfuehrung der Funktion(en) wird this_player() auf <player> gesetzt.
- execute_command() setzt auch passende Werte fuer query_command()
- und query_verb(), die dem angegebenen <command> entsprechen.
+DESCRIPTION
+ Low-level access to the command parser: take the <command>, parse it
+ into verb and argument and call the appropriate action added to
+ <origin> (read: <origin> is the object 'issuing' the command).
+ For the execution of the function(s), this_player() is set to
+ player. The function also sets results of query_command() and
+ query_verb() to match the given <command>.
- execute_command() beruecksichtigt weder den H_MODIFY_COMMAND noch den
- H_NOTIFY_FAIL Hook. Zwar kann notify_fail() verwendet werden, die
- Verarbeitung muss jedoch durch das aufrufende Objekt erfolgen.
+ The result is non-0 if the command was found and execute, and 0
+ otherwise.
-GESCHICHTE
- Eingefuehrt in LDMud 3.2.7.
+ The efun raises a privilege violation ("execute_command",
+ this_object(), origin, command).
-SIEHE AUCH
- hooks(C), command(E), notify_fail(E), command_stack(E)
+ Note that this function does not use the H_MODIFY_COMMAND
+ and H_NOTIFY_FAIL hooks; the notify_fail() efun is can be used,
+ but must be evaluated by the caller.
+
+HISTORY
+ Introduced in LDMud 3.2.7.
+
+SEE ALSO
+ hooks(C), match_command(E), command(E), notify_fail(E),
+ command_stack(E)