Doku fuer H_HOOK_CONSUME erstellt.
Change-Id: Ic8b1caae696755d3cf79984622fb0d4c7fdf5b9a
diff --git a/doc/libhooks/H_HOOK_CONSUME b/doc/libhooks/H_HOOK_CONSUME
new file mode 100644
index 0000000..0394b86
--- /dev/null
+++ b/doc/libhooks/H_HOOK_CONSUME
@@ -0,0 +1,50 @@
+H_HOOK_CONSUME
+==============
+
+HOOK
+----
+ H_HOOK_CONSUME
+
+DEFINIERT IN
+------------
+
+ /sys/hook.h
+
+GERUFEN VON
+-----------
+
+ /std/living/life.c
+
+BESCHREIBUNG
+------------
+
+ Wird ausgeloest, wenn ein Lebewesen etwas per consume() konsumiert.
+
+HOOK-DATEN
+----------
+
+ Es wird ein Array uebergeben:
+ ({mapping cinfo, int testonly})
+ Die Elemente des Arrays entsprechen den Argumenten von consume(), siehe
+ dort fuer ausfuehrliche Dokumentation.
+
+BEMERKUNGEN
+-----------
+
+ Die in "man consume" erwaehnte alte Form des Mappings wird leider noch
+ benutzt, Stand heute (16.02.2018) u.A. von /std/pub. Beruecksichtigt das
+ in eurem Code.
+
+RUECKGABEWERTE
+--------------
+
+ ({ <status>, <daten> })
+ <status> : H_NO_MOD, H_CANCELLED, H_ALTERED
+ <daten> : wie uebergebenes Datenarray
+
+SIEHE AUCH
+----------
+
+ HRegisterToHook(), HUnregisterFromHook(), HookFlow(), consume()
+
+Letzte Aenderung: 16.02.2018, Bugfix