Dokumentationsupdate

Change-Id: I21e8fead2af8ef9a186be90bdc75f35168e9bf3a
diff --git a/doc/lfun/AddDrink b/doc/lfun/AddDrink
index 4d722ec..08af745 100644
--- a/doc/lfun/AddDrink
+++ b/doc/lfun/AddDrink
@@ -2,6 +2,9 @@
 AddDrink()
 **********
 
+   void AddDrink(string nameOfDrink, mixed ids, int price, int heal,
+                 int strength, int soak, mixed myFunction);
+
 
 BEMERKUNGEN
 ===========
@@ -9,10 +12,17 @@
    Die Funktion AddDrink() sollte NICHT MEHR BENUTZT werden.
    Bitte AddToMenu() verwenden.
 
+   Bestehende Aufrufe koennen wie folgt ersetzt werden:
+
+   AddToMenu(nameOfDrink, ids,
+     ([ P_VALUE : price, P_DRINK : soak, P_ALCOHOL : strength,
+        P_HP : heal/2, P_SP : heal/2 ]),
+        min(heal/2, 5), myFunction, 0, 0, 0);
+
 
 SIEHE AUCH
 ==========
 
-   AddToMenu(), RemoveFromMenu()
+   AddToMenu(), RemoveFromMenu(), AddFood()
 
 Last modified: Fri Mar 03 13:23:00 2000 by Paracelsus
diff --git a/doc/lfun/AddFood b/doc/lfun/AddFood
index b870a5e..dc50d94 100644
--- a/doc/lfun/AddFood
+++ b/doc/lfun/AddFood
@@ -2,6 +2,9 @@
 AddFood()
 *********
 
+   void AddFood(string nameOfFood, mixed ids, int price, int heal,
+                mixed myFunction)
+
 
 BEMERKUNGEN
 ===========
@@ -9,10 +12,16 @@
    Die Funktion AddFood() sollte NICHT MEHR BENUTZT werden.
    Bitte AddToMenu() verwenden.
 
+   Bestehende Aufrufe koennen wie folgt ersetzt werden:
+
+   AddToMenu( nameOfFood,ids,
+       ([ P_VALUE : price, P_FOOD : heal, P_HP : heal, P_SP : heal ]),
+       ( min(heal, 5), myFunction, 0,0,0);
+
 
 SIEHE AUCH
 ==========
 
-   AddToMenu(), RemoveFromMenu()
+   AddToMenu(), RemoveFromMenu(), AddDrink()
 
 Last modified: Fri Mar 03 13:23:00 2000 by Paracelsus
diff --git a/doc/lfun/AddToMenu b/doc/lfun/AddToMenu
index c983647..01d0364 100644
--- a/doc/lfun/AddToMenu
+++ b/doc/lfun/AddToMenu
@@ -199,8 +199,6 @@
 
    4) Heilung pro Heartbeat (in diesem Beispiel je 5 KP/LP).
 
-
-
       5,
 
    5) Meldungen fuer Spieler und Umstehende die bei Genuss ausgege-
@@ -213,8 +211,6 @@
       als Objekt an replace_personal() uebergeben. Fuer die
       moeglichen Platzhalter siehe dort.
 
-
-
    6) Die Speise ist in ihrer Anzahl begrenzt. Fuer jeden Spieler
       sind 4 Keulen pro reset() da. Ausserdem gibt es noch einen
       "Notvorrat" von 20 Keulen, der alle 3 reset()s aufgefuellt
@@ -223,23 +219,18 @@
 
       ([ PR_USER : 4; 1 , PR_ALL : 20; 3 ]),
 
-
-
       HINWEIS: bei Benutzung des Mappings muss <pub.h> inkludiert
       werden!
 
-
-
       Wenn man keine reset-abhaengigen Speisen haben moechte, traegt
       man hier eine 0 ein.
 
+
    7) Die Zahl ist die Wartezeit in Sekunden, die der Wirt z.B. fuer
       die Zubereitung und Auslieferung an den Spieler braucht.
 
       9,
 
-
-
    8) Letztendlich die Meldungen an Spieler und Umstehende, die bei Be-
       stellung (hier 'kaufe keule') ausgegeben werden.
 
@@ -253,17 +244,24 @@
 LISTE DER ALTEN PLATZHALTER (DEPRECATED):
 =========================================
 
-::
-   &&  - pl->name(WER,2) &1& - pl->name(WER,2) &2& -
-   pl->name(WESSEN,2) &3& - pl->name(WEM,2) &4& - pl->name(WEN,2) &1#
-   - capitalize(pl->name(WER,2)) &2# - capitalize(pl->name(WESSEN,2))
-   &3# - capitalize(pl->name(WEM,2)) &4# - capitalize(pl->name(WEN,2))
-   &!  - pl->QueryPronoun(WER) &5& - pl->QueryPronoun(WE); &6& -
-   pl->QueryPronoun(WESSEN) &7& - pl->QueryPronoun(WEM) &8& -
-   pl->QueryPronoun(WEN) &5# - capitalize(pl->QueryPronoun(WER)) &6# -
-   capitalize(pl->QueryPronoun(WESSEN)) &7# -
-   capitalize(pl->QueryPronoun(WEM)) &8# -
-   capitalize(pl->QueryPronoun(WEN))
+   &&  - pl->name(WER,2)
+   &1& - pl->name(WER,2)
+   &2& - pl->name(WESSEN,2)
+   &3& - pl->name(WEM,2)
+   &4& - pl->name(WEN,2)
+   &1# - capitalize(pl->name(WER,2))
+   &2# - capitalize(pl->name(WESSEN,2))
+   &3# - capitalize(pl->name(WEM,2))
+   &4# - capitalize(pl->name(WEN,2))
+   &!  - pl->QueryPronoun(WER)
+   &5& - pl->QueryPronoun(WE);
+   &6& - pl->QueryPronoun(WESSEN)
+   &7& - pl->QueryPronoun(WEM)
+   &8& - pl->QueryPronoun(WEN)
+   &5# - capitalize(pl->QueryPronoun(WER))
+   &6# - capitalize(pl->QueryPronoun(WESSEN))
+   &7# - capitalize(pl->QueryPronoun(WEM))
+   &8# - capitalize(pl->QueryPronoun(WEN))
 
 
 SIEHE AUCH
diff --git a/doc/props/P_KEEP_ON_SELL b/doc/props/P_KEEP_ON_SELL
index ce5feba..b0e694c 100644
--- a/doc/props/P_KEEP_ON_SELL
+++ b/doc/props/P_KEEP_ON_SELL
@@ -18,4 +18,20 @@
 BESCHREIBUNG
 ============
 
-   Bei "verkaufe alles" wird das Objekt behalten.
+   Die Property enthaelt die UID des Spielers, der "behalte <name>"
+   eingegeben hat.
+
+   Bei "verkaufe alles" wird das Objekt behalten, wenn die Property
+   die UID des verkaufenden Spielers enthaelt. Es ist also durchaus
+   moeglich, auf diese Weise Objekte zu verkaufen, die auf andere
+   Spieler markiert wurden.
+
+
+BEMERKUNGEN
+===========
+
+   Es ist nicht noetig, P_KEEP_ON_SELL zusaetzlich zu P_NODROP oder
+   P_NOSELL zu setzen, denn jede dieser beiden verhindert bereits
+   das Verkaufen.
+
+Letzte Aenderung: 11. Aug. 2020, Arathorn
diff --git a/doc/sphinx/lfun/AddDrink.rst b/doc/sphinx/lfun/AddDrink.rst
index 7ced4bb..7330ba9 100644
--- a/doc/sphinx/lfun/AddDrink.rst
+++ b/doc/sphinx/lfun/AddDrink.rst
@@ -1,18 +1,31 @@
 AddDrink()
 ==========
+::
+
+    void AddDrink(string nameOfDrink, mixed ids, int price, int heal,
+                  int strength, int soak, mixed myFunction);
+
 
 BEMERKUNGEN
 -----------
 ::
 
-        Die Funktion AddDrink() sollte NICHT MEHR BENUTZT werden.
-        Bitte AddToMenu() verwenden.
+    Die Funktion AddDrink() sollte NICHT MEHR BENUTZT werden.
+    Bitte AddToMenu() verwenden.
+
+    Bestehende Aufrufe koennen wie folgt ersetzt werden:
+
+    AddToMenu(nameOfDrink, ids,
+      ([ P_VALUE : price, P_DRINK : soak, P_ALCOHOL : strength,
+         P_HP : heal/2, P_SP : heal/2 ]),
+         min(heal/2, 5), myFunction, 0, 0, 0);
+
 
 SIEHE AUCH
 ----------
 ::
 
-	AddToMenu(), RemoveFromMenu()
+    AddToMenu(), RemoveFromMenu(), AddFood()
 
 
 Last modified: Fri Mar 03 13:23:00 2000 by Paracelsus
diff --git a/doc/sphinx/lfun/AddFood.rst b/doc/sphinx/lfun/AddFood.rst
index 30bea9d..e430fed 100644
--- a/doc/sphinx/lfun/AddFood.rst
+++ b/doc/sphinx/lfun/AddFood.rst
@@ -1,19 +1,30 @@
 AddFood()
 =========
+::
+
+      void AddFood(string nameOfFood, mixed ids, int price, int heal,
+                   mixed myFunction)
+
 
 BEMERKUNGEN
 -----------
 ::
 
-        Die Funktion AddFood() sollte NICHT MEHR BENUTZT werden.
-        Bitte AddToMenu() verwenden.
+      Die Funktion AddFood() sollte NICHT MEHR BENUTZT werden.
+      Bitte AddToMenu() verwenden.
+
+      Bestehende Aufrufe koennen wie folgt ersetzt werden:
+
+      AddToMenu( nameOfFood,ids,
+          ([ P_VALUE : price, P_FOOD : heal, P_HP : heal, P_SP : heal ]),
+          ( min(heal, 5), myFunction, 0,0,0);
+
 
 SIEHE AUCH
 ----------
 ::
 
-        AddToMenu(), RemoveFromMenu()
-
+        AddToMenu(), RemoveFromMenu(), AddDrink()
 
 Last modified: Fri Mar 03 13:23:00 2000 by Paracelsus
 
diff --git a/doc/sphinx/lfun/AddToMenu.rst b/doc/sphinx/lfun/AddToMenu.rst
index d2ae21f..9703f2c 100644
--- a/doc/sphinx/lfun/AddToMenu.rst
+++ b/doc/sphinx/lfun/AddToMenu.rst
@@ -200,8 +200,6 @@
 
         4) Heilung pro Heartbeat (in diesem Beispiel je 5 KP/LP).
 
-    
-
            5,
 
         5) Meldungen fuer Spieler und Umstehende die bei Genuss ausgege-
@@ -214,8 +212,6 @@
            als Objekt an replace_personal() uebergeben. Fuer die
            moeglichen Platzhalter siehe dort.
 
-          
-
         6) Die Speise ist in ihrer Anzahl begrenzt. Fuer jeden Spieler
            sind 4 Keulen pro reset() da. Ausserdem gibt es noch einen
            "Notvorrat" von 20 Keulen, der alle 3 reset()s aufgefuellt
@@ -224,23 +220,18 @@
 
            ([ PR_USER : 4; 1 , PR_ALL : 20; 3 ]),
 
-           
-
            HINWEIS: bei Benutzung des Mappings muss <pub.h> inkludiert 
            werden!
 
-           
-
            Wenn man keine reset-abhaengigen Speisen haben moechte, traegt
            man hier eine 0 ein.
 
+
         7) Die Zahl ist die Wartezeit in Sekunden, die der Wirt z.B. fuer
            die Zubereitung und Auslieferung an den Spieler braucht.
 
            9,
 
-         
-
         8) Letztendlich die Meldungen an Spieler und Umstehende, die bei Be-
            stellung (hier 'kaufe keule') ausgegeben werden.
 
@@ -250,9 +241,11 @@
            "Der unsichtbare Kneipier schneidet einem hilflosen Opa ein "
            "Stueck aus dessen Keule und braet diese fuer @WEN1."}));
 
+
 LISTE DER ALTEN PLATZHALTER (DEPRECATED):
 -----------------------------------------
 ::
+
            &&  - pl->name(WER,2)
            &1& - pl->name(WER,2)
            &2& - pl->name(WESSEN,2)
diff --git a/doc/sphinx/props/P_KEEP_ON_SELL.rst b/doc/sphinx/props/P_KEEP_ON_SELL.rst
index d7897e8..ccc592b 100644
--- a/doc/sphinx/props/P_KEEP_ON_SELL.rst
+++ b/doc/sphinx/props/P_KEEP_ON_SELL.rst
@@ -17,5 +17,21 @@
 ------------
 ::
 
-     Bei "verkaufe alles" wird das Objekt behalten.
+     Die Property enthaelt die UID des Spielers, der "behalte <name>"
+     eingegeben hat.
 
+     Bei "verkaufe alles" wird das Objekt behalten, wenn die Property
+     die UID des verkaufenden Spielers enthaelt. Es ist also durchaus
+     moeglich, auf diese Weise Objekte zu verkaufen, die auf andere
+     Spieler markiert wurden.
+
+BEMERKUNGEN
+-----------
+::
+
+     Es ist nicht noetig, P_KEEP_ON_SELL zusaetzlich zu P_NODROP oder
+     P_NOSELL zu setzen, denn jede dieser beiden verhindert bereits
+     das Verkaufen.
+
+
+Letzte Aenderung: 11. Aug. 2020, Arathorn