Adding program specification to lb_source_hooks manpage.

1 files changed, 44 insertions, 5 deletions

diff --git a/manpages/de/lb_source_hooks.de.1 b/manpages/de/lb_source_hooks.de.1
index 51a271ce9..a48fd0589 100644
--- a/manpages/de/lb_source_hooks.de.1
+++ b/manpages/de/lb_source_hooks.de.1
@@ -27,7 +27,37 @@
 live\-build enthält die Komponenten um ein Live System von einem
 Konfigurationsverzeichnis zu erstellen.
 .PP
-Der \fBlb source_hooks\fP Befehl führt Hooks nach dem Source Stage aus.
+Der \fBlb source_hooks\fP Befehl führt Hooks Dateien nach dem Source Stage aus.
+
+.SH SPEZIFIKATION
+\fBlb source_hooks\fP führt alle Hook Dateien die sich im \fBconfig/hooks\fP
+Verzeichnis innerhalb des Konfigurationsvereichnisses befinden aus.
+.PP
+Hook Dateien benötigen weder einen speziellen Besitzer noch spezielle
+Zugriffsrechte. Sie werden automatisch als ausführbar markiert wenn sie von
+\fBlb source_hooks\fP ausgeführt werden.
+.PP
+Hook Dateien müssen entweder den Suffix \fB*.hook\fP oder \fB*.hook.source\fP
+haben.
+.PP
+Hook Dateien mit dem Suffix \fB*.hook\fP werden als erstes ausgeführt, Hook
+Dateien mit dem Suffix \fB*.hook.source\fP als zweites.
+.PP
+Hook Dateien werden von \fBlb source_hooks\fP in alphanummerischer Reihenfolge
+ausgeführt. Falls eine Hook Datei davon abhängt nach einer anderen Hook
+Datei ausgeführt zu werden, ist die empfohlene Vorgehensweise Nummern als
+Prefixes (nnnn, beginnend mit 0001) zu benutzen um die
+Ausführungsreihenfolge zu sichern.
+.PP
+Hook Dateien werden durch \fBlb source_hooks\fP in das \fBsource/live\-build\fP
+Verzeichnis kopiert. Sie werden innerhalb des source Verzeichnises
+ausgeführt und können das Konfigurationsverzeichnis in \fBlive\-build/config\fP
+innerhalb des source Verzeichnisses lesen.
+.PP
+\fBWarnung:\fP Hook Dateien werden nicht in einem Chroot sondern innerhalb des
+Kontext des Host Systems im source Vereichnis ausgeführt. Sie haben Root
+Privilegien und Zugang zu allen Ressourcen des Host Systems (Geräte,
+Dateisysteme, Netzwerk, etc.).
 
 .SH OPTIONEN
 .IP \-\-verbose 4
@@ -38,10 +68,19 @@ zeigt Hilfenachricht und beendet sich.
 zeigt Versionsnummer des Programms und beendet sich.
 
 .SH DATEIEN
-.IP \fBconfig/build\fP 4
-.IP \fBconfig/hooks/*.hook\fP 4
-.IP \fBconfig/hooks/*.hook.source\fP 4
-.IP \fBsource\fP 4
+.IP \fBconfig/build\fP: 4
+allgemeine Konfigurationsdatei.
+.IP \fBconfig/hooks/*.hook\fP: 4
+Allgemeine Hook Dateien.
+.IP \fBconfig/hooks/*.hook.source\fP: 4
+Hook Dateien spezifisch für den Source Stage.
+.IP \fBsource\fP: 4
+Verzeichnis in dem Hook Dateien ausgeführt werden.
+.IP \fBsource/live\-build/config\fP: 4
+bind mount des Konfigurationsverzeichnis innerhalb des source Verzeichnisses
+um von Hook Dateien gelesen werden zu können.
+.IP \fBsource/live\-build\fP: 4
+Verzeichnis in das die Hook Dateien kopiert werden.
 
 .SH "SIEHE AUCH"
 .IP \fIlb_bootstrap_hooks\fP(1) 4