Automatisch erzeugte Manpages.
Damit nicht jeder sphinx auf dem Rechner haben muss,
behalten wir bis auf weiteres die aus den .rst
erzeugten Manpoages auch im Repo.
Change-Id: Id556c0d11cf5f79659d8350952ce1c014d81ea44
diff --git a/doc/props/P_GIVE_MSG b/doc/props/P_GIVE_MSG
index bd6a624..e21dbad 100644
--- a/doc/props/P_GIVE_MSG
+++ b/doc/props/P_GIVE_MSG
@@ -1,65 +1,83 @@
+
P_GIVE_MSG
-NAME:
- P_GIVE_MSG "give_message"
+**********
-DEFINIERT IN:
- /sys/living/put_and_get.h
-BESCHREIBUNG:
- Mit P_GIVE_MSG kann man die Meldung, die man beim Uebergeben eines
- Objektes bekommt, modifizieren.
+NAME
+====
- Folgende Werte sind moeglich:
+ P_GIVE_MSG "give_message"
- o 0
- Es wird eine Standardmeldung ausgegeben. Dies ist Voreinstellung.
- o NO_PNG_MSG == -1
- Es wird keinerlei Meldung ausgegeben
+DEFINIERT IN
+============
- o Ein Array aus Strings
- Der erste String wird an den Spieler ausgegeben, der zweite
- (optionale) an den Raum, der dritte (ebenfalls optionale) an den
- Empfaenger.
+ /sys/living/put_and_get.h
- Die Strings werden durch die Funktion replace_personal() geparst.
- Objekt1 - Spieler
- Objekt2 - das Objekt, das uebergeben wird
- Objekt3 - Empfaenger
- Wird der zweite String nicht angegeben, erfolgt keine Meldung an den
- Raum. Beim Fehlen des dritten gibt es keine Meldung an den Empfaenger.
+BESCHREIBUNG
+============
-BEISPIEL:
- void create() {
- ...
- SetProp( P_SHORT, "Etwas Sand" );
- SetProp( P_LONG, break_string(
- "Ein wenig magischer Sand. Sehr feinkruemelig.",78 ));
+ Mit P_GIVE_MSG kann man die Meldung, die man beim Uebergeben eines
+ Objektes bekommt, modifizieren.
- SetProp( P_NAME, "Sand" );
- AddId( ({"sand"}) );
- SetProp( P_GENDER, MALE );
+ Folgende Werte sind moeglich:
- SetProp( P_GIVE_MSG, ({
- "Du laesst @WEN2 in @WESSEN3 Haende rieseln.",
- "@WER1 laesst @WENU2 in @WESSEN3 Haende rieseln.",
- "@WER1 laesst @WENU2 in deine Haende rieseln."}));
- ...
- }
+ o 0
+ Es wird eine Standardmeldung ausgegeben. Dies ist Voreinstellung.
- Das ganze fuehrt bei Ugars "gib sand an peter" zu folgenden
- Meldungen:
+ o NO_PNG_MSG == -1
+ Es wird keinerlei Meldung ausgegeben
- Ugar: "Du laesst den Sand in Peters Haende rieseln."
- Raum: "Ugar laesst Sand in Peters Haende rieseln."
- Peter: "Ugar laesst Sand in deine Haende rieseln."
+ o Ein Array aus Strings
+ Der erste String wird an den Spieler ausgegeben, der zweite
+ (optionale) an den Raum, der dritte (ebenfalls optionale) an den
+ Empfaenger.
-SIEHE AUCH:
- Aehnliches: P_DROP_MSG, P_PUT_MSG, P_PICK_MSG, P_SHOW_MSG
- Fehler: P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_TOO_MANY_MSG,
- P_NOINSERT_MSG, P_NOLEAVE_MSG, P_NODROP, P_NOGET
- Sonstiges: replace_personal(E), give(L), give_objects(L),
- give_notify(L), /std/living/put_and_get.c
+ Die Strings werden durch die Funktion replace_personal() geparst.
+ Objekt1 - Spieler
+ Objekt2 - das Objekt, das uebergeben wird
+ Objekt3 - Empfaenger
+
+ Wird der zweite String nicht angegeben, erfolgt keine Meldung an den
+ Raum. Beim Fehlen des dritten gibt es keine Meldung an den Empfaenger.
+
+
+BEISPIEL
+========
+
+ void create() {
+ ...
+ SetProp( P_SHORT, "Etwas Sand" );
+ SetProp( P_LONG, break_string(
+ "Ein wenig magischer Sand. Sehr feinkruemelig.",78 ));
+
+ SetProp( P_NAME, "Sand" );
+ AddId( ({"sand"}) );
+ SetProp( P_GENDER, MALE );
+
+ SetProp( P_GIVE_MSG, ({
+ "Du laesst @WEN2 in @WESSEN3 Haende rieseln.",
+ "@WER1 laesst @WENU2 in @WESSEN3 Haende rieseln.",
+ "@WER1 laesst @WENU2 in deine Haende rieseln."}));
+ ...
+ }
+
+ Das ganze fuehrt bei Ugars "gib sand an peter" zu folgenden
+ Meldungen:
+
+ Ugar: "Du laesst den Sand in Peters Haende rieseln."
+ Raum: "Ugar laesst Sand in Peters Haende rieseln."
+ Peter: "Ugar laesst Sand in deine Haende rieseln."
+
+
+SIEHE AUCH
+==========
+
+ Aehnliches: P_DROP_MSG, P_PUT_MSG, P_PICK_MSG, P_SHOW_MSG
+ Fehler: P_TOO_HEAVY_MSG, P_ENV_TOO_HEAVY_MSG, P_TOO_MANY_MSG,
+ P_NOINSERT_MSG, P_NOLEAVE_MSG, P_NODROP, P_NOGET
+ Sonstiges: replace_personal(E), give(L), give_objects(L),
+ give_notify(L), /std/living/put_and_get.c
14. Maerz 2004 Gloinson