Syntaxhilfe fuer Objekte eingebaut
Objekte koennen mit der Property P_SYNTAX_HELP explizite
Hilfen zur Syntax ihrer Kommandos anbieten.
Change-Id: Ib27a77b020d53fca411d83f0e02d85476ca62341
diff --git a/doc/hilfe.spieler b/doc/hilfe.spieler
index a2072f8..21a32fa 100644
--- a/doc/hilfe.spieler
+++ b/doc/hilfe.spieler
@@ -5,23 +5,23 @@
Erlaeuterung angezeigt werden:
Einfuehrung und erste Schritte:
- Grundlegend:
- syntax, bewegung, regeln, einfuehrung
+ Grundlegend:
+ syntax, bewegung, regeln, einfuehrung, syntaxhilfe
Charakter:
attribute, zaubertraenke, stufen, stufenpunkte
- Spiel:
+ Spiel:
abenteuer, gilden, zauberei
- Neuspieler:
+ Neuspieler:
cicerones, tutorial
Kommunikation:
- Im Raum:
+ Im Raum:
sage, gespraech, frage, antworte
- Privat:
+ Privat:
teile (mit), erzaehle, erwidere, fluestere,
- MUD-weit:
+ MUD-weit:
rufe, ebenen, post, mrufe
- Anderes:
+ Anderes:
ignoriere, kobold, weg, parties, senderwiederholung, klingelton
teamspeak
diff --git a/doc/pcmd/syntaxhilfe b/doc/pcmd/syntaxhilfe
new file mode 100644
index 0000000..59596f6
--- /dev/null
+++ b/doc/pcmd/syntaxhilfe
@@ -0,0 +1,19 @@
+
+syntaxhilfe
+-----------
+
+ KOMMANDO:
+ syntaxhilfe <objekt>
+
+ ARGUMENTE:
+
+ <objekt>
+ Eine Bezeichnung fuer das Objekt, zu dem man eine Syntaxhilfe will
+
+ BESCHREIBUNG:
+ Wenn das gewuenschte Objekt gefunden wird und eine Syntaxhilfe anbietet,
+ wird diese angezeigt.
+
+ Hierbei kann es sein, dass die Syntaxhilfe nur unter bestimmten
+ Bedingungen (z.B. Gildenmitgliedschaft, Seher, etc.) angezeigt wird.
+
diff --git a/doc/props/P_SYNTAX_HELP b/doc/props/P_SYNTAX_HELP
new file mode 100644
index 0000000..13344f1
--- /dev/null
+++ b/doc/props/P_SYNTAX_HELP
@@ -0,0 +1,44 @@
+NAME:
+ P_SYNTAX_HELP "lib_p_syntax_help"
+
+DEFINIERT IN:
+ /sys/thing/commands.h
+
+BESCHREIBUNG:
+ In dieser Property kann man fuer Spieler eine ausfuehrliche Syntaxhilfe zu
+ den Kommandos eines Objektes ablegen. Diese wird angezeigt, wenn der
+ Spieler das Kommando "synxtaxhilfe <objekt>" eingibt.
+ Die Property kann verschiedene Datenstrukturen enthalten:
+
+ 1) ein String
+ Der String wird angezeigt, hierbei ggf. umgebrochen, vorhandene
+ Zeilenumbrueche werden beibehalten.
+
+ 2) ein Array: ({hilfetext, bedingungen})
+
+ <hilfetext>:
+ * ein string:
+ Der String wird angezeigt, hierbei ggf. umgebrochen, vorhandene
+ Zeilenumbrueche werden beibehalten.
+ * eine lfun-closure:
+ Diese erhaelt beim Aufruf das betreffende Objekt als Argument.
+ Wenn diese dann einen String zurueckliefert, wird dieser dem Spieler
+ angezeigt. Hierbei wird ggf. umgebrochen, vorhandene Zeilenumbrueche
+ werden beibehalten.
+
+ <bedingungen>, welche erfuellt sein muessen, damit dem Spieler die Hilfe
+ angezeigt wird. Die Bedingungen sind entweder:
+ * ein Mapping fuer check_restriction()
+ * eine lfun-closure
+ Diese erhaelt beim Aufruf das betreffende Objekt als Argument und darf
+ eine 0 fuer 'erlaubt', 1 fuer 'nicht erlaubt (mit Standardtext)' oder
+ einen string fuer 'nicht erlaubt mit individuellem Text' sein.
+
+BEMERKUNGEN:
+ Hat ein Objekt keine Syntaxhilfe, wird das Kommando "syntaxhilfe" aus dem
+ Objekt wieder entfernt (d.h. die Property muss gesetzt sein, bevor der
+ erste Spieler das Kommando eingibt).
+
+SIEHE AUCH:
+ AddCmd
+