Doku fuer Hooks

Hook-Funktionen und weitere Libhooks.

Ausserdem ein paar Typos und Klarstellungen in aelteren Manpages zu
Libhooks.

Change-Id: I27de063d852ccb3971379503ab041682d711be9c
diff --git a/doc/libhooks/H_HOOK_POISON b/doc/libhooks/H_HOOK_POISON
new file mode 100644
index 0000000..cf0cedc
--- /dev/null
+++ b/doc/libhooks/H_HOOK_POISON
@@ -0,0 +1,45 @@
+H_HOOK_POISON
+=============
+
+HOOK
+----
+
+  H_HOOK_POISON
+
+DEFINIERT IN
+------------
+
+  /sys/hook.h
+
+GERUFEN VON
+-----------
+
+  /std/living/life.c
+
+BESCHREIBUNG
+------------
+
+  Wird bei Veraenderung von P_POISON im Lebewesen ausgegeben. Aenderung der
+  Daten und Abbruch sind moeglich.
+  Wenn eine Set-Methode auf P_POISON existiert, kann das Ausloesen des Hooks
+  verhindert werden.
+
+HOOK-DATEN
+----------
+
+  int poison
+  Der Neue Wert der Property.
+
+RUECKGABEWERTE
+--------------
+
+  ({ <status>, <daten> })
+  <status>  : H_NO_MOD, H_ALTERED, H_CANCELLED
+  <daten>   : int poison
+
+SIEHE AUCH
+----------
+
+  HRegisterToHook(), HUnregisterFromHook(), HookFlow(), P_POISON
+
+Letzte Aenderung: 06.10.2022, Bugfix