Dokumentationsupdate Angel-Properties

Change-Id: Id129cdd826061093955e48753265258e9d749cdb
diff --git a/doc/props/P_FISH b/doc/props/P_FISH
index 5449da9..d11bf01 100644
--- a/doc/props/P_FISH
+++ b/doc/props/P_FISH
@@ -30,6 +30,9 @@
      F_NOROTTEN
        Fisch fault nicht; ggf. sollte hier auch gleich F_NOHEAL gesetzt
        werden, weil sonst eine unverderbliche tragbare Tanke erzeugt wuerde.
+       Wenn sie verderben koennen, beginnen Fische nach 10 min zu verderben
+       und werden danach alle 2 Minuten schlechter, d.h. reduzieren ihren
+       Heilwert. Nach vier Schritten ist ein Fisch komplett vergammelt.
      F_NOTHUNGRY
        Fisch frisst Koeder nur, wenn er auch wirklich nachher an der Angel
        haengt. Ist er zu schwer fuer die Angel und reisst ab, bleibt der
@@ -41,7 +44,13 @@
        Verwandlung kuemmert (z.B. Monster clonen und Fisch zerstoeren,
        Beispiel siehe unten).
      F_NOHEAL
-       Fisch heilt nicht bei Verzehr
+       Fisch heilt nicht bei Verzehr.
+       Wenn er heilt, ist die Heilung ist abhaengig vom Gewicht des Fisches
+       und limitiert auf den Wertebereich 0-40 LP. Der maximale Heilwert
+       ist bei 1280 g Gewicht erreicht und skaliert in Schritten von 32 g
+       linear. Pro LP, der geheilt wird, muss der Spieler Platz fuer 3
+       Food haben (ueber eat_food() realisiert). Die Heilung wird ueber
+       buffer_hp() mit einer Rate von 5 LP pro Heartbeat.
 
    Raum (OPTIONAL):
    ****************
@@ -62,8 +71,6 @@
    P_WATER in der Angel und/oder P_WATER im Koeder nicht zum aktuellen
    Gewaesser passen. Der Malus betraegt jeweils 60+random(60) Sekunden.
 
-
-
    Der Standardwert fuer P_FISH im Raum ist 0 und bedeutet 100 % Bestand.
    Positive Werte erhoehen die Dichte, negative senken sie. Positive Werte
    sollten nicht >100 sein.
@@ -73,8 +80,6 @@
    Boni auf Angel oder Koeder kompensiert werden. Ausserdem ist zu
    bedenken, dass es keine Boni fuer richtige Gewaesserwahl gibt.
 
-
-
    Koeder (OPTIONAL):
    ******************
    Ein Koeder kann mittels P_FISH die Fischdichte modifizieren, um hierueber
@@ -112,7 +117,9 @@
 SIEHE AUCH
 ==========
 
-   Properties: P_WATER
-   Methoden:   GetAquarium(L)
+   Properties:   P_WATER, P_FOOD
+   Basisobjekte: /std/items/fishing/fish.c, /std/items/fishing/haken.c
+                 /std/items/fishing/koeder.c /std/items/fishing/angel.c
+   Methoden:     GetAquarium(L), eat_food(), buffer_hp()
 
-Zuletzt geaendert: 2018-Jul-18, Arathorn
+Zuletzt geaendert: 2020-Mar-09, Arathorn
diff --git a/doc/props/P_WATER b/doc/props/P_WATER
index 79742c1..06e4025 100644
--- a/doc/props/P_WATER
+++ b/doc/props/P_WATER
@@ -28,17 +28,12 @@
      diesem Typ haengt ab, welche Arten von Fischen es hier standardmaessig
      gibt und welche Arten von Angeln verwendet werden koennen.
 
-
-
      Beispiel:
 
      SetProp(P_WATER, W_HARBOR);
 
-
-
-     Folgende
-     Typen stehen zur Verfuegung, von denen in Raeumen nur einer gesetzt
-     werden darf:
+     Folgende Typen stehen zur Verfuegung, von denen in Raeumen nur einer
+     gesetzt werden darf:
 
      Salzwasser:
        W_BEACH   Strand: Scholle, Flunder, Rochen, Seezunge, Katzenhai
@@ -77,8 +72,6 @@
      Verwendung einer fuer das oertliche Gewaesser ungeeigneten Angel fuehrt
      zu einer um 60+random(60) Sekunden verlaengerten Wartezeit beim Angeln.
 
-
-
      Beispiel: Setzt man den Gewaessertyp mit
 
        SetProp(P_WATER, W_HARBOR|W_OCEAN);
@@ -112,7 +105,8 @@
      ein Mehlwurm hingegen fuer Suesswasser. Gesetzt wird P_WATER hierfuer
      auf die oben aufgefuehrten Werte.
      Verwendung eines ungeeigneten Koeders fuehrt zu einer um 60+random(60)
-     Sekunden laengeren Wartezeit beim Angeln.
+     Sekunden laengeren Wartezeit beim Angeln. Angeln in Gewaessern des
+     Typs W_USER fuehrt nie zu einer verlaengerten Wartezeit.
 
    Wasserbehaelter:
    ****************
@@ -127,4 +121,4 @@
    Properties: P_FISH
    Methoden:   GetAquarium(L)
 
-Zuletzt geaendert: 2014-Aug-21, Arathorn
+Zuletzt geaendert: 2020-Mar-08, Arathorn
diff --git a/doc/sphinx/props/P_FISH.rst b/doc/sphinx/props/P_FISH.rst
index 20f7199..7eba22a 100644
--- a/doc/sphinx/props/P_FISH.rst
+++ b/doc/sphinx/props/P_FISH.rst
@@ -29,6 +29,9 @@
       F_NOROTTEN
         Fisch fault nicht; ggf. sollte hier auch gleich F_NOHEAL gesetzt 
         werden, weil sonst eine unverderbliche tragbare Tanke erzeugt wuerde.
+        Wenn sie verderben koennen, beginnen Fische nach 10 min zu verderben
+        und werden danach alle 2 Minuten schlechter, d.h. reduzieren ihren
+        Heilwert. Nach vier Schritten ist ein Fisch komplett vergammelt.
       F_NOTHUNGRY
         Fisch frisst Koeder nur, wenn er auch wirklich nachher an der Angel
         haengt. Ist er zu schwer fuer die Angel und reisst ab, bleibt der
@@ -40,7 +43,13 @@
         Verwandlung kuemmert (z.B. Monster clonen und Fisch zerstoeren,
         Beispiel siehe unten).
       F_NOHEAL
-        Fisch heilt nicht bei Verzehr
+        Fisch heilt nicht bei Verzehr. 
+        Wenn er heilt, ist die Heilung ist abhaengig vom Gewicht des Fisches
+        und limitiert auf den Wertebereich 0-40 LP. Der maximale Heilwert
+        ist bei 1280 g Gewicht erreicht und skaliert in Schritten von 32 g
+        linear. Pro LP, der geheilt wird, muss der Spieler Platz fuer 3
+        Food haben (ueber eat_food() realisiert). Die Heilung wird ueber
+        buffer_hp() mit einer Rate von 5 LP pro Heartbeat.
 
     Raum (OPTIONAL):
     ****************
@@ -61,8 +70,6 @@
     P_WATER in der Angel und/oder P_WATER im Koeder nicht zum aktuellen 
     Gewaesser passen. Der Malus betraegt jeweils 60+random(60) Sekunden.
 
-    
-
     Der Standardwert fuer P_FISH im Raum ist 0 und bedeutet 100 % Bestand.
     Positive Werte erhoehen die Dichte, negative senken sie. Positive Werte 
     sollten nicht >100 sein.
@@ -72,8 +79,6 @@
     Boni auf Angel oder Koeder kompensiert werden. Ausserdem ist zu
     bedenken, dass es keine Boni fuer richtige Gewaesserwahl gibt.
 
- 
-
     Koeder (OPTIONAL):
     ******************
     Ein Koeder kann mittels P_FISH die Fischdichte modifizieren, um hierueber
@@ -112,9 +117,11 @@
 ----------
 ::
 
-    Properties: P_WATER
-    Methoden:   GetAquarium(L)
+    Properties:   P_WATER, P_FOOD
+    Basisobjekte: /std/items/fishing/fish.c, /std/items/fishing/haken.c
+                  /std/items/fishing/koeder.c /std/items/fishing/angel.c
+    Methoden:     GetAquarium(L), eat_food(), buffer_hp()
 
 
-Zuletzt geaendert: 2018-Jul-18, Arathorn
+Zuletzt geaendert: 2020-Mar-09, Arathorn
 
diff --git a/doc/sphinx/props/P_WATER.rst b/doc/sphinx/props/P_WATER.rst
index cc2d399..b5ebae3 100644
--- a/doc/sphinx/props/P_WATER.rst
+++ b/doc/sphinx/props/P_WATER.rst
@@ -27,17 +27,12 @@
       diesem Typ haengt ab, welche Arten von Fischen es hier standardmaessig
       gibt und welche Arten von Angeln verwendet werden koennen. 
 
-      
-
       Beispiel:
 
       SetProp(P_WATER, W_HARBOR);
 
-      
-
-      Folgende
-      Typen stehen zur Verfuegung, von denen in Raeumen nur einer gesetzt
-      werden darf:
+      Folgende Typen stehen zur Verfuegung, von denen in Raeumen nur einer 
+      gesetzt werden darf:
 
       Salzwasser:
         W_BEACH   Strand: Scholle, Flunder, Rochen, Seezunge, Katzenhai
@@ -76,8 +71,6 @@
       Verwendung einer fuer das oertliche Gewaesser ungeeigneten Angel fuehrt
       zu einer um 60+random(60) Sekunden verlaengerten Wartezeit beim Angeln.
 
-      
-
       Beispiel: Setzt man den Gewaessertyp mit 
 
         SetProp(P_WATER, W_HARBOR|W_OCEAN);
@@ -111,7 +104,8 @@
       ein Mehlwurm hingegen fuer Suesswasser. Gesetzt wird P_WATER hierfuer
       auf die oben aufgefuehrten Werte.
       Verwendung eines ungeeigneten Koeders fuehrt zu einer um 60+random(60)
-      Sekunden laengeren Wartezeit beim Angeln.
+      Sekunden laengeren Wartezeit beim Angeln. Angeln in Gewaessern des
+      Typs W_USER fuehrt nie zu einer verlaengerten Wartezeit.
 
     Wasserbehaelter:
     ****************
@@ -127,5 +121,5 @@
     Methoden:   GetAquarium(L)
 
 
-Zuletzt geaendert: 2014-Aug-21, Arathorn
+Zuletzt geaendert: 2020-Mar-08, Arathorn