Adding program specification to lb_source_hooks manpage.

6 files changed, 567 insertions, 131 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
diff --git a/manpages/en/lb_source_hooks.1 b/manpages/en/lb_source_hooks.1
index 1f768893e..64bbad887 100644
--- a/manpages/en/lb_source_hooks.1
+++ b/manpages/en/lb_source_hooks.1
@@ -21,7 +21,22 @@
 .SH DESCRIPTION
 live\-build contains the components to build a live system from a configuration directory.
 .PP
-The \fBlb source_hooks\fR command executes hooks after the source stage.
+The \fBlb source_hooks\fR command executes hook files after the source stage.
+
+.SH SPECIFICATION
+\fBlb source_hooks\fR executes any hook files found in the \fBconfig/hooks\fR directory within the configuration directory.
+.PP
+Hook files do not require to have a specific owner nor specific permissions. They are marked executable by \fBlb source_hooks\fR automatically when they are executed.
+.PP
+Hook files must either have the suffix \fB*.hook\fR or \fB*.hook.source\fR.
+.PP
+Hook files with the suffix \fB*.hook\fR are executed first, hook files with the suffix \fB*.hook.source\fR are executed second.
+.PP
+Hook files are executed in alphanumberical order by \fBlb source_hooks\fR. If one hook file depends on being run after another, best practise is to use number prefixes (nnnn, starting with 0001) to ensure the order of execution.
+.PP
+Hook files are copied into the \fBsource/live-build\fR directory by \fBlb source_hoooks\fR. They are executed from within the source directory and can read the configuration directory in \fBlive-build/config\fR within the source directory.
+.PP
+\fBWarning:\fR hook files are not executed within a chroot but within the context of the host system in the source directory. They have root privileges and access to the all host system ressources (devices, filesystems, network, etc.).
 
 .SH OPTIONS
 .IP "\-\-verbose" 4
@@ -32,10 +47,18 @@ show help message and exit.
 show program's version number and exit.
 
 .SH FILES
-.IP "\fBconfig/build\fR" 4
-.IP "\fBconfig/hooks/*.hook\fR" 4
-.IP "\fBconfig/hooks/*.hook.source\fR" 4
-.IP "\fBsource\fR" 4
+.IP "\fBconfig/build\fR:" 4
+generic configuration file.
+.IP "\fBconfig/hooks/*.hook\fR:" 4
+generic hook files.
+.IP "\fBconfig/hooks/*.hook.source\fR:" 4
+hook files specific for the source stage.
+.IP "\fBsource\fR:" 4
+directory in which the hook files are executed.
+.IP "\fBsource/live-build/config\fR:" 4
+bind mounted configuration directory within the source directory to be read by hook files.
+.IP "\fBsource/live-build\fR:" 4
+directory in which hook files are copied.
 
 .SH SEE ALSO
 .IP "\fIlb_bootstrap_hooks\fR(1)" 4
diff --git a/manpages/es/lb_source_hooks.es.1 b/manpages/es/lb_source_hooks.es.1
index 18feb8afa..cf116995f 100644
--- a/manpages/es/lb_source_hooks.es.1
+++ b/manpages/es/lb_source_hooks.es.1
@@ -27,7 +27,34 @@
 live\-build contains the components to build a live system from a
 configuration directory.
 .PP
-The \fBlb source_hooks\fP command executes hooks after the source stage.
+The \fBlb source_hooks\fP command executes hook files after the source stage.
+
+.SH SPECIFICATION
+\fBlb source_hooks\fP executes any hook files found in the \fBconfig/hooks\fP
+directory within the configuration directory.
+.PP
+Hook files do not require to have a specific owner nor specific
+permissions. They are marked executable by \fBlb source_hooks\fP automatically
+when they are executed.
+.PP
+Hook files must either have the suffix \fB*.hook\fP or \fB*.hook.source\fP.
+.PP
+Hook files with the suffix \fB*.hook\fP are executed first, hook files with the
+suffix \fB*.hook.source\fP are executed second.
+.PP
+Hook files are executed in alphanumberical order by \fBlb source_hooks\fP. If
+one hook file depends on being run after another, best practise is to use
+number prefixes (nnnn, starting with 0001) to ensure the order of execution.
+.PP
+Hook files are copied into the \fBsource/live\-build\fP directory by \fBlb
+source_hoooks\fP. They are executed from within the source directory and can
+read the configuration directory in \fBlive\-build/config\fP within the source
+directory.
+.PP
+\fBWarning:\fP hook files are not executed within a chroot but within the
+context of the host system in the source directory. They have root
+privileges and access to the all host system ressources (devices,
+filesystems, network, etc.).
 
 .SH OPCIONES
 .IP \-\-verbose 4
@@ -38,10 +65,19 @@ muestra el mensaje de ayuda y sale.
 muestra el número de versión del programa y sale.
 
 .SH FICHEROS
-.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
+generic configuration file.
+.IP \fBconfig/hooks/*.hook\fP: 4
+generic hook files.
+.IP \fBconfig/hooks/*.hook.source\fP: 4
+hook files specific for the source stage.
+.IP \fBsource\fP: 4
+directory in which the hook files are executed.
+.IP \fBsource/live\-build/config\fP: 4
+bind mounted configuration directory within the source directory to be read
+by hook files.
+.IP \fBsource/live\-build\fP: 4
+directory in which hook files are copied.
 
 .SH "VER TAMBIÉN"
 .IP \fIlb_bootstrap_hooks\fP(1) 4
diff --git a/manpages/po/de/lb_source_hooks.1.po b/manpages/po/de/lb_source_hooks.1.po
index 6b3843f8b..9ad49b0a7 100644
--- a/manpages/po/de/lb_source_hooks.1.po
+++ b/manpages/po/de/lb_source_hooks.1.po
@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-build 4.0~alpha29-1\n"
-"POT-Creation-Date: 2013-11-04 11:34+0100\n"
+"POT-Creation-Date: 2013-11-04 12:22+0100\n"
 "PO-Revision-Date: 2010-05-24 09:59+0300\n"
 "Last-Translator: Daniel Baumann <mail@daniel-baumann.ch>\n"
 "Language-Team: none\n"
@@ -90,9 +90,15 @@ msgstr ""
 "Konfigurationsverzeichnis zu erstellen."
 
 #. type: SH
+#: en/lb_binary_hooks.1:26 en/lb_source_hooks.1:26
+#, no-wrap
+msgid "SPECIFICATION"
+msgstr "SPEZIFIKATION"
+
+#. type: SH
 #: en/lb_binary_hooks.1:41 en/lb_bootstrap_cdebootstrap.1:26
 #: en/lb_bootstrap_debootstrap.1:26 en/lb_bootstrap_hooks.1:26
-#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:26
+#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:41
 #, no-wrap
 msgid "OPTIONS"
 msgstr "OPTIONEN"
@@ -100,7 +106,7 @@ msgstr "OPTIONEN"
 #. type: IP
 #: en/lb_binary_hooks.1:42 en/lb_bootstrap_cdebootstrap.1:29
 #: en/lb_bootstrap_debootstrap.1:29 en/lb_bootstrap_hooks.1:27
-#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:27
+#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:42
 #, no-wrap
 msgid "--verbose"
 msgstr "--verbose"
@@ -108,14 +114,14 @@ msgstr "--verbose"
 #. type: Plain text
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 msgid "sets verbose option (default: False)."
 msgstr "setzt verbose Option für mehr Ausgaben (Standardwert: aus)."
 
 #. type: IP
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 #, no-wrap
 msgid "-h, --help"
 msgstr "-h, --help"
@@ -123,14 +129,14 @@ msgstr "-h, --help"
 #. type: Plain text
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 msgid "show help message and exit."
 msgstr "zeigt Hilfenachricht und beendet sich."
 
 #. type: IP
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 #, no-wrap
 msgid "-v, --version"
 msgstr "-v, --version"
@@ -138,34 +144,66 @@ msgstr "-v, --version"
 #. type: Plain text
 #: en/lb_binary_hooks.1:48 en/lb_bootstrap_cdebootstrap.1:35
 #: en/lb_bootstrap_debootstrap.1:35 en/lb_bootstrap_hooks.1:33
-#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:33
+#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:48
 msgid "show program's version number and exit."
 msgstr "zeigt Versionsnummer des Programms und beendet sich."
 
 #. type: SH
 #: en/lb_binary_hooks.1:49 en/lb_bootstrap_cdebootstrap.1:36
 #: en/lb_bootstrap_debootstrap.1:36 en/lb_bootstrap_hooks.1:34
-#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:34
+#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr "DATEIEN"
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_source_hooks.1:50
+#, no-wrap
+msgid "B<config/build>:"
+msgstr "B<config/build>:"
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr "allgemeine Konfigurationsdatei."
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+#, no-wrap
+msgid "B<config/hooks/*.hook>:"
+msgstr "B<config/hooks/*.hook>:"
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:54 en/lb_source_hooks.1:54
+msgid "generic hook files."
+msgstr "Allgemeine Hook Dateien."
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:58 en/lb_source_hooks.1:58
+msgid "directory in which the hook files are executed."
+msgstr "Verzeichnis in dem Hook Dateien ausgeführt werden."
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:62 en/lb_source_hooks.1:62
+msgid "directory in which hook files are copied."
+msgstr "Verzeichnis in das die Hook Dateien kopiert werden."
+
 #. type: SH
 #: en/lb_binary_hooks.1:63 en/lb_bootstrap_cdebootstrap.1:43
 #: en/lb_bootstrap_debootstrap.1:43 en/lb_bootstrap_hooks.1:40
-#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:40
+#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:63
 #, no-wrap
 msgid "SEE ALSO"
 msgstr "SIEHE AUCH"
 
 #. type: IP
-#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:41
+#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:64
 #, no-wrap
 msgid "I<lb_bootstrap_hooks>(1)"
 msgstr "I<lb_bootstrap_hooks>(1)"
 
 #. type: IP
-#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:42
+#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:65
 #, no-wrap
 msgid "I<lb_chroot_hooks>(1)"
 msgstr "I<lb_chroot_hooks>(1)"
@@ -173,7 +211,7 @@ msgstr "I<lb_chroot_hooks>(1)"
 #. type: SH
 #: en/lb_binary_hooks.1:68 en/lb_bootstrap_cdebootstrap.1:46
 #: en/lb_bootstrap_debootstrap.1:46 en/lb_bootstrap_hooks.1:45
-#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:45
+#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:68
 #, no-wrap
 msgid "HOMEPAGE"
 msgstr "HOMEPAGE"
@@ -181,7 +219,7 @@ msgstr "HOMEPAGE"
 #. type: Plain text
 #: en/lb_binary_hooks.1:70 en/lb_bootstrap_cdebootstrap.1:48
 #: en/lb_bootstrap_debootstrap.1:48 en/lb_bootstrap_hooks.1:47
-#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:47
+#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:70
 msgid ""
 "More information about live-build and the Live Systems project can be found "
 "on the homepage at E<lt>I<http://live-systems.org/>E<gt> and in the manual "
@@ -194,7 +232,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:71 en/lb_bootstrap_cdebootstrap.1:49
 #: en/lb_bootstrap_debootstrap.1:49 en/lb_bootstrap_hooks.1:48
-#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:48
+#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:71
 #, no-wrap
 msgid "BUGS"
 msgstr "FEHLER"
@@ -202,7 +240,7 @@ msgstr "FEHLER"
 #. type: Plain text
 #: en/lb_binary_hooks.1:73 en/lb_bootstrap_cdebootstrap.1:51
 #: en/lb_bootstrap_debootstrap.1:51 en/lb_bootstrap_hooks.1:50
-#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:50
+#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:73
 msgid ""
 "Bugs can be reported by submitting a bugreport for the live-build package in "
 "the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
@@ -219,7 +257,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:74 en/lb_bootstrap_cdebootstrap.1:52
 #: en/lb_bootstrap_debootstrap.1:52 en/lb_bootstrap_hooks.1:51
-#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:51
+#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:74
 #, no-wrap
 msgid "AUTHOR"
 msgstr "AUTOR"
@@ -227,7 +265,7 @@ msgstr "AUTOR"
 #. type: Plain text
 #: en/lb_binary_hooks.1:75 en/lb_bootstrap_cdebootstrap.1:53
 #: en/lb_bootstrap_debootstrap.1:53 en/lb_bootstrap_hooks.1:52
-#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:52
+#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:75
 msgid ""
 "live-build was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."
 msgstr ""
@@ -235,20 +273,7 @@ msgstr ""
 "geschrieben."
 
 #. type: IP
-#: en/lb_bootstrap_cdebootstrap.1:37 en/lb_bootstrap_debootstrap.1:37
-#: en/lb_bootstrap_hooks.1:35 en/lb_chroot_hooks.1:35 en/lb_source_hooks.1:35
-#, no-wrap
-msgid "B<config/build>"
-msgstr "B<config/build>"
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:36 en/lb_chroot_hooks.1:36 en/lb_source_hooks.1:36
-#, no-wrap
-msgid "B<config/hooks/*.hook>"
-msgstr "B<config/hooks/*.hook>"
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:43
+#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr "I<lb_binary_hooks>(1)"
@@ -270,17 +295,120 @@ msgstr "B<lb source_hooks> [--version]"
 
 #. type: Plain text
 #: en/lb_source_hooks.1:25
-msgid "The B<lb source_hooks> command executes hooks after the source stage."
-msgstr "Der B<lb source_hooks> Befehl führt Hooks nach dem Source Stage aus."
+msgid ""
+"The B<lb source_hooks> command executes hook files after the source stage."
+msgstr ""
+"Der B<lb source_hooks> Befehl führt Hooks Dateien nach dem Source Stage aus."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:28
+msgid ""
+"B<lb source_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+"B<lb source_hooks> führt alle Hook Dateien die sich im B<config/hooks> "
+"Verzeichnis innerhalb des Konfigurationsvereichnisses befinden aus."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb source_hooks> automatically when they are "
+"executed."
+msgstr ""
+"Hook Dateien benötigen weder einen speziellen Besitzer noch spezielle "
+"Zugriffsrechte. Sie werden automatisch als ausführbar markiert wenn sie von "
+"B<lb source_hooks> ausgeführt werden."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.source>."
+msgstr ""
+"Hook Dateien müssen entweder den Suffix B<*.hook> oder B<*.hook.source> "
+"haben."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.source> are executed second."
+msgstr ""
+"Hook Dateien mit dem Suffix B<*.hook> werden als erstes ausgeführt, Hook "
+"Dateien mit dem Suffix B<*.hook.source> als zweites."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb source_hooks>. If "
+"one hook file depends on being run after another, best practise is to use "
+"number prefixes (nnnn, starting with 0001) to ensure the order of execution."
+msgstr ""
+"Hook Dateien werden von B<lb source_hooks> 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."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:38
+msgid ""
+"Hook files are copied into the B<source/live-build> directory by B<lb "
+"source_hoooks>. They are executed from within the source directory and can "
+"read the configuration directory in B<live-build/config> within the source "
+"directory."
+msgstr ""
+"Hook Dateien werden durch B<lb source_hooks> in das B<source/live-build> "
+"Verzeichnis kopiert. Sie werden innerhalb des source Verzeichnises "
+"ausgeführt und können das Konfigurationsverzeichnis in B<live-build/config> "
+"innerhalb des source Verzeichnisses lesen."
+
+#. type: Plain text
+#: en/lb_source_hooks.1:40
+msgid ""
+"B<Warning:> hook files are not executed within a chroot but within the "
+"context of the host system in the source directory. They have root "
+"privileges and access to the all host system ressources (devices, "
+"filesystems, network, etc.)."
+msgstr ""
+"B<Warnung:> 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.)."
 
 #. type: IP
-#: en/lb_source_hooks.1:37
+#: en/lb_source_hooks.1:54
 #, no-wrap
-msgid "B<config/hooks/*.hook.source>"
-msgstr "B<config/hooks/*.hook.source>"
+msgid "B<config/hooks/*.hook.source>:"
+msgstr "B<config/hooks/*.hook.source>:"
+
+#. type: Plain text
+#: en/lb_source_hooks.1:56
+msgid "hook files specific for the source stage."
+msgstr "Hook Dateien spezifisch für den Source Stage."
 
 #. type: IP
-#: en/lb_source_hooks.1:38
+#: en/lb_source_hooks.1:56
+#, no-wrap
+msgid "B<source>:"
+msgstr "B<source>:"
+
+#. type: IP
+#: en/lb_source_hooks.1:58
+#, no-wrap
+msgid "B<source/live-build/config>:"
+msgstr "B<source/live-build/config>:"
+
+#. type: Plain text
+#: en/lb_source_hooks.1:60
+msgid ""
+"bind mounted configuration directory within the source directory to be read "
+"by hook files."
+msgstr ""
+"bind mount des Konfigurationsverzeichnis innerhalb des source Verzeichnisses "
+"um von Hook Dateien gelesen werden zu können."
+
+#. type: IP
+#: en/lb_source_hooks.1:60
 #, no-wrap
-msgid "B<source>"
-msgstr "B<source>"
+msgid "B<source/live-build>:"
+msgstr "B<source/live-build>:"
diff --git a/manpages/po/es/lb_source_hooks.1.po b/manpages/po/es/lb_source_hooks.1.po
index a0e7bc5c8..ee706b541 100644
--- a/manpages/po/es/lb_source_hooks.1.po
+++ b/manpages/po/es/lb_source_hooks.1.po
@@ -5,7 +5,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-build 4.0~alpha29-1\n"
-"POT-Creation-Date: 2013-11-04 11:34+0100\n"
+"POT-Creation-Date: 2013-11-04 12:22+0100\n"
 "PO-Revision-Date: 2010-05-24 09:59+0300\n"
 "Last-Translator: Carlos Zuferri <chals@altorricon.com>\n"
 "Language-Team: none\n"
@@ -91,9 +91,15 @@ msgstr ""
 "de un directorio de configuración."
 
 #. type: SH
+#: en/lb_binary_hooks.1:26 en/lb_source_hooks.1:26
+#, no-wrap
+msgid "SPECIFICATION"
+msgstr ""
+
+#. type: SH
 #: en/lb_binary_hooks.1:41 en/lb_bootstrap_cdebootstrap.1:26
 #: en/lb_bootstrap_debootstrap.1:26 en/lb_bootstrap_hooks.1:26
-#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:26
+#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:41
 #, no-wrap
 msgid "OPTIONS"
 msgstr "OPCIONES"
@@ -101,7 +107,7 @@ msgstr "OPCIONES"
 #. type: IP
 #: en/lb_binary_hooks.1:42 en/lb_bootstrap_cdebootstrap.1:29
 #: en/lb_bootstrap_debootstrap.1:29 en/lb_bootstrap_hooks.1:27
-#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:27
+#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:42
 #, no-wrap
 msgid "--verbose"
 msgstr "--verbose"
@@ -109,14 +115,14 @@ msgstr "--verbose"
 #. type: Plain text
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 msgid "sets verbose option (default: False)."
 msgstr "establece la opción verbose (por defecto: False)."
 
 #. type: IP
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 #, no-wrap
 msgid "-h, --help"
 msgstr "-h, --help"
@@ -124,14 +130,14 @@ msgstr "-h, --help"
 #. type: Plain text
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 msgid "show help message and exit."
 msgstr "muestra el mensaje de ayuda y sale."
 
 #. type: IP
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 #, no-wrap
 msgid "-v, --version"
 msgstr "-v, --version"
@@ -139,34 +145,66 @@ msgstr "-v, --version"
 #. type: Plain text
 #: en/lb_binary_hooks.1:48 en/lb_bootstrap_cdebootstrap.1:35
 #: en/lb_bootstrap_debootstrap.1:35 en/lb_bootstrap_hooks.1:33
-#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:33
+#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:48
 msgid "show program's version number and exit."
 msgstr "muestra el número de versión del programa y sale."
 
 #. type: SH
 #: en/lb_binary_hooks.1:49 en/lb_bootstrap_cdebootstrap.1:36
 #: en/lb_bootstrap_debootstrap.1:36 en/lb_bootstrap_hooks.1:34
-#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:34
+#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr "FICHEROS"
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_source_hooks.1:50
+#, no-wrap
+msgid "B<config/build>:"
+msgstr "B<config/build>:"
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr ""
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+#, no-wrap
+msgid "B<config/hooks/*.hook>:"
+msgstr "B<config/hooks/*.hook>:"
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:54 en/lb_source_hooks.1:54
+msgid "generic hook files."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:58 en/lb_source_hooks.1:58
+msgid "directory in which the hook files are executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:62 en/lb_source_hooks.1:62
+msgid "directory in which hook files are copied."
+msgstr ""
+
 #. type: SH
 #: en/lb_binary_hooks.1:63 en/lb_bootstrap_cdebootstrap.1:43
 #: en/lb_bootstrap_debootstrap.1:43 en/lb_bootstrap_hooks.1:40
-#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:40
+#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:63
 #, no-wrap
 msgid "SEE ALSO"
 msgstr "VER TAMBIÉN"
 
 #. type: IP
-#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:41
+#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:64
 #, no-wrap
 msgid "I<lb_bootstrap_hooks>(1)"
 msgstr "I<lb_bootstrap_hooks>(1)"
 
 #. type: IP
-#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:42
+#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:65
 #, no-wrap
 msgid "I<lb_chroot_hooks>(1)"
 msgstr "I<lb_chroot_hooks>(1)"
@@ -174,7 +212,7 @@ msgstr "I<lb_chroot_hooks>(1)"
 #. type: SH
 #: en/lb_binary_hooks.1:68 en/lb_bootstrap_cdebootstrap.1:46
 #: en/lb_bootstrap_debootstrap.1:46 en/lb_bootstrap_hooks.1:45
-#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:45
+#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:68
 #, no-wrap
 msgid "HOMEPAGE"
 msgstr "PÁGINA WEB"
@@ -182,7 +220,7 @@ msgstr "PÁGINA WEB"
 #. type: Plain text
 #: en/lb_binary_hooks.1:70 en/lb_bootstrap_cdebootstrap.1:48
 #: en/lb_bootstrap_debootstrap.1:48 en/lb_bootstrap_hooks.1:47
-#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:47
+#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:70
 msgid ""
 "More information about live-build and the Live Systems project can be found "
 "on the homepage at E<lt>I<http://live-systems.org/>E<gt> and in the manual "
@@ -195,7 +233,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:71 en/lb_bootstrap_cdebootstrap.1:49
 #: en/lb_bootstrap_debootstrap.1:49 en/lb_bootstrap_hooks.1:48
-#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:48
+#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:71
 #, no-wrap
 msgid "BUGS"
 msgstr "ERRORES"
@@ -203,7 +241,7 @@ msgstr "ERRORES"
 #. type: Plain text
 #: en/lb_binary_hooks.1:73 en/lb_bootstrap_cdebootstrap.1:51
 #: en/lb_bootstrap_debootstrap.1:51 en/lb_bootstrap_hooks.1:50
-#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:50
+#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:73
 msgid ""
 "Bugs can be reported by submitting a bugreport for the live-build package in "
 "the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
@@ -218,7 +256,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:74 en/lb_bootstrap_cdebootstrap.1:52
 #: en/lb_bootstrap_debootstrap.1:52 en/lb_bootstrap_hooks.1:51
-#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:51
+#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:74
 #, no-wrap
 msgid "AUTHOR"
 msgstr "AUTOR"
@@ -226,7 +264,7 @@ msgstr "AUTOR"
 #. type: Plain text
 #: en/lb_binary_hooks.1:75 en/lb_bootstrap_cdebootstrap.1:53
 #: en/lb_bootstrap_debootstrap.1:53 en/lb_bootstrap_hooks.1:52
-#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:52
+#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:75
 msgid ""
 "live-build was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."
 msgstr ""
@@ -234,20 +272,7 @@ msgstr ""
 "ch>E<gt>."
 
 #. type: IP
-#: en/lb_bootstrap_cdebootstrap.1:37 en/lb_bootstrap_debootstrap.1:37
-#: en/lb_bootstrap_hooks.1:35 en/lb_chroot_hooks.1:35 en/lb_source_hooks.1:35
-#, no-wrap
-msgid "B<config/build>"
-msgstr "B<config/build>"
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:36 en/lb_chroot_hooks.1:36 en/lb_source_hooks.1:36
-#, no-wrap
-msgid "B<config/hooks/*.hook>"
-msgstr "B<config/hooks/*.hook>"
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:43
+#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr "I<lb_binary_hooks>(1)"
@@ -270,19 +295,101 @@ msgstr "B<lb source_hooks> [--version]"
 #. type: Plain text
 #: en/lb_source_hooks.1:25
 #, fuzzy
-msgid "The B<lb source_hooks> command executes hooks after the source stage."
+msgid ""
+"The B<lb source_hooks> command executes hook files after the source stage."
 msgstr ""
 "El programa B<lb source_hooks> preinstala el source del sistema con "
 "I<debootstrap>(8)."
 
+#. type: Plain text
+#: en/lb_source_hooks.1:28
+msgid ""
+"B<lb source_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb source_hooks> automatically when they are "
+"executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.source>."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.source> are executed second."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb source_hooks>. If "
+"one hook file depends on being run after another, best practise is to use "
+"number prefixes (nnnn, starting with 0001) to ensure the order of execution."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:38
+msgid ""
+"Hook files are copied into the B<source/live-build> directory by B<lb "
+"source_hoooks>. They are executed from within the source directory and can "
+"read the configuration directory in B<live-build/config> within the source "
+"directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:40
+msgid ""
+"B<Warning:> hook files are not executed within a chroot but within the "
+"context of the host system in the source directory. They have root "
+"privileges and access to the all host system ressources (devices, "
+"filesystems, network, etc.)."
+msgstr ""
+
 #. type: IP
-#: en/lb_source_hooks.1:37
-#, no-wrap
-msgid "B<config/hooks/*.hook.source>"
+#: en/lb_source_hooks.1:54
+#, fuzzy, no-wrap
+#| msgid "B<config/hooks/*.hook.source>"
+msgid "B<config/hooks/*.hook.source>:"
 msgstr "B<config/hooks/*.hook.source>"
 
+#. type: Plain text
+#: en/lb_source_hooks.1:56
+msgid "hook files specific for the source stage."
+msgstr ""
+
 #. type: IP
-#: en/lb_source_hooks.1:38
-#, no-wrap
-msgid "B<source>"
+#: en/lb_source_hooks.1:56
+#, fuzzy, no-wrap
+#| msgid "B<source>"
+msgid "B<source>:"
 msgstr "B<source>"
+
+#. type: IP
+#: en/lb_source_hooks.1:58
+#, fuzzy, no-wrap
+#| msgid "B<binary/live-build/config>:"
+msgid "B<source/live-build/config>:"
+msgstr "B<binary/live-build/config>:"
+
+#. type: Plain text
+#: en/lb_source_hooks.1:60
+msgid ""
+"bind mounted configuration directory within the source directory to be read "
+"by hook files."
+msgstr ""
+
+#. type: IP
+#: en/lb_source_hooks.1:60
+#, fuzzy, no-wrap
+#| msgid "B<binary/live-build>:"
+msgid "B<source/live-build>:"
+msgstr "B<binary/live-build>:"
diff --git a/manpages/pot/lb_source_hooks.1.pot b/manpages/pot/lb_source_hooks.1.pot
index bd1875e5c..9105ded66 100644
--- a/manpages/pot/lb_source_hooks.1.pot
+++ b/manpages/pot/lb_source_hooks.1.pot
@@ -7,7 +7,7 @@
 msgid ""
 msgstr ""
 "Project-Id-Version: live-build VERSION\n"
-"POT-Creation-Date: 2013-11-04 11:34+0100\n"
+"POT-Creation-Date: 2013-11-04 12:22+0100\n"
 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
 "Language-Team: LANGUAGE <LL@li.org>\n"
@@ -89,9 +89,15 @@ msgid ""
 msgstr ""
 
 #. type: SH
+#: en/lb_binary_hooks.1:26 en/lb_source_hooks.1:26
+#, no-wrap
+msgid "SPECIFICATION"
+msgstr ""
+
+#. type: SH
 #: en/lb_binary_hooks.1:41 en/lb_bootstrap_cdebootstrap.1:26
 #: en/lb_bootstrap_debootstrap.1:26 en/lb_bootstrap_hooks.1:26
-#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:26
+#: en/lb_chroot_hooks.1:26 en/lb_source_hooks.1:41
 #, no-wrap
 msgid "OPTIONS"
 msgstr ""
@@ -99,7 +105,7 @@ msgstr ""
 #. type: IP
 #: en/lb_binary_hooks.1:42 en/lb_bootstrap_cdebootstrap.1:29
 #: en/lb_bootstrap_debootstrap.1:29 en/lb_bootstrap_hooks.1:27
-#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:27
+#: en/lb_chroot_hooks.1:27 en/lb_source_hooks.1:42
 #, no-wrap
 msgid "--verbose"
 msgstr ""
@@ -107,14 +113,14 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 msgid "sets verbose option (default: False)."
 msgstr ""
 
 #. type: IP
 #: en/lb_binary_hooks.1:44 en/lb_bootstrap_cdebootstrap.1:31
 #: en/lb_bootstrap_debootstrap.1:31 en/lb_bootstrap_hooks.1:29
-#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:29
+#: en/lb_chroot_hooks.1:29 en/lb_source_hooks.1:44
 #, no-wrap
 msgid "-h, --help"
 msgstr ""
@@ -122,14 +128,14 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 msgid "show help message and exit."
 msgstr ""
 
 #. type: IP
 #: en/lb_binary_hooks.1:46 en/lb_bootstrap_cdebootstrap.1:33
 #: en/lb_bootstrap_debootstrap.1:33 en/lb_bootstrap_hooks.1:31
-#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:31
+#: en/lb_chroot_hooks.1:31 en/lb_source_hooks.1:46
 #, no-wrap
 msgid "-v, --version"
 msgstr ""
@@ -137,34 +143,66 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:48 en/lb_bootstrap_cdebootstrap.1:35
 #: en/lb_bootstrap_debootstrap.1:35 en/lb_bootstrap_hooks.1:33
-#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:33
+#: en/lb_chroot_hooks.1:33 en/lb_source_hooks.1:48
 msgid "show program's version number and exit."
 msgstr ""
 
 #. type: SH
 #: en/lb_binary_hooks.1:49 en/lb_bootstrap_cdebootstrap.1:36
 #: en/lb_bootstrap_debootstrap.1:36 en/lb_bootstrap_hooks.1:34
-#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:34
+#: en/lb_chroot_hooks.1:34 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr ""
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_source_hooks.1:50
+#, no-wrap
+msgid "B<config/build>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr ""
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_source_hooks.1:52
+#, no-wrap
+msgid "B<config/hooks/*.hook>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:54 en/lb_source_hooks.1:54
+msgid "generic hook files."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:58 en/lb_source_hooks.1:58
+msgid "directory in which the hook files are executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:62 en/lb_source_hooks.1:62
+msgid "directory in which hook files are copied."
+msgstr ""
+
 #. type: SH
 #: en/lb_binary_hooks.1:63 en/lb_bootstrap_cdebootstrap.1:43
 #: en/lb_bootstrap_debootstrap.1:43 en/lb_bootstrap_hooks.1:40
-#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:40
+#: en/lb_chroot_hooks.1:40 en/lb_source_hooks.1:63
 #, no-wrap
 msgid "SEE ALSO"
 msgstr ""
 
 #. type: IP
-#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:41
+#: en/lb_binary_hooks.1:64 en/lb_chroot_hooks.1:41 en/lb_source_hooks.1:64
 #, no-wrap
 msgid "I<lb_bootstrap_hooks>(1)"
 msgstr ""
 
 #. type: IP
-#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:42
+#: en/lb_binary_hooks.1:65 en/lb_bootstrap_hooks.1:41 en/lb_source_hooks.1:65
 #, no-wrap
 msgid "I<lb_chroot_hooks>(1)"
 msgstr ""
@@ -172,7 +210,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:68 en/lb_bootstrap_cdebootstrap.1:46
 #: en/lb_bootstrap_debootstrap.1:46 en/lb_bootstrap_hooks.1:45
-#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:45
+#: en/lb_chroot_hooks.1:45 en/lb_source_hooks.1:68
 #, no-wrap
 msgid "HOMEPAGE"
 msgstr ""
@@ -180,7 +218,7 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:70 en/lb_bootstrap_cdebootstrap.1:48
 #: en/lb_bootstrap_debootstrap.1:48 en/lb_bootstrap_hooks.1:47
-#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:47
+#: en/lb_chroot_hooks.1:47 en/lb_source_hooks.1:70
 msgid ""
 "More information about live-build and the Live Systems project can be found "
 "on the homepage at E<lt>I<http://live-systems.org/>E<gt> and in the manual "
@@ -190,7 +228,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:71 en/lb_bootstrap_cdebootstrap.1:49
 #: en/lb_bootstrap_debootstrap.1:49 en/lb_bootstrap_hooks.1:48
-#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:48
+#: en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:71
 #, no-wrap
 msgid "BUGS"
 msgstr ""
@@ -198,7 +236,7 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:73 en/lb_bootstrap_cdebootstrap.1:51
 #: en/lb_bootstrap_debootstrap.1:51 en/lb_bootstrap_hooks.1:50
-#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:50
+#: en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:73
 msgid ""
 "Bugs can be reported by submitting a bugreport for the live-build package in "
 "the Bug Tracking System at E<lt>I<http://bugs.debian.org/>E<gt> or by "
@@ -209,7 +247,7 @@ msgstr ""
 #. type: SH
 #: en/lb_binary_hooks.1:74 en/lb_bootstrap_cdebootstrap.1:52
 #: en/lb_bootstrap_debootstrap.1:52 en/lb_bootstrap_hooks.1:51
-#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:51
+#: en/lb_chroot_hooks.1:51 en/lb_source_hooks.1:74
 #, no-wrap
 msgid "AUTHOR"
 msgstr ""
@@ -217,26 +255,13 @@ msgstr ""
 #. type: Plain text
 #: en/lb_binary_hooks.1:75 en/lb_bootstrap_cdebootstrap.1:53
 #: en/lb_bootstrap_debootstrap.1:53 en/lb_bootstrap_hooks.1:52
-#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:52
+#: en/lb_chroot_hooks.1:52 en/lb_source_hooks.1:75
 msgid ""
 "live-build was written by Daniel Baumann E<lt>I<mail@daniel-baumann.ch>E<gt>."
 msgstr ""
 
 #. type: IP
-#: en/lb_bootstrap_cdebootstrap.1:37 en/lb_bootstrap_debootstrap.1:37
-#: en/lb_bootstrap_hooks.1:35 en/lb_chroot_hooks.1:35 en/lb_source_hooks.1:35
-#, no-wrap
-msgid "B<config/build>"
-msgstr ""
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:36 en/lb_chroot_hooks.1:36 en/lb_source_hooks.1:36
-#, no-wrap
-msgid "B<config/hooks/*.hook>"
-msgstr ""
-
-#. type: IP
-#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:43
+#: en/lb_bootstrap_hooks.1:42 en/lb_chroot_hooks.1:42 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr ""
@@ -258,17 +283,95 @@ msgstr ""
 
 #. type: Plain text
 #: en/lb_source_hooks.1:25
-msgid "The B<lb source_hooks> command executes hooks after the source stage."
+msgid ""
+"The B<lb source_hooks> command executes hook files after the source stage."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:28
+msgid ""
+"B<lb source_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb source_hooks> automatically when they are "
+"executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.source>."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.source> are executed second."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb source_hooks>. If "
+"one hook file depends on being run after another, best practise is to use "
+"number prefixes (nnnn, starting with 0001) to ensure the order of execution."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:38
+msgid ""
+"Hook files are copied into the B<source/live-build> directory by B<lb "
+"source_hoooks>. They are executed from within the source directory and can "
+"read the configuration directory in B<live-build/config> within the source "
+"directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:40
+msgid ""
+"B<Warning:> hook files are not executed within a chroot but within the "
+"context of the host system in the source directory. They have root "
+"privileges and access to the all host system ressources (devices, "
+"filesystems, network, etc.)."
 msgstr ""
 
 #. type: IP
-#: en/lb_source_hooks.1:37
+#: en/lb_source_hooks.1:54
 #, no-wrap
-msgid "B<config/hooks/*.hook.source>"
+msgid "B<config/hooks/*.hook.source>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:56
+msgid "hook files specific for the source stage."
 msgstr ""
 
 #. type: IP
-#: en/lb_source_hooks.1:38
+#: en/lb_source_hooks.1:56
+#, no-wrap
+msgid "B<source>:"
+msgstr ""
+
+#. type: IP
+#: en/lb_source_hooks.1:58
+#, no-wrap
+msgid "B<source/live-build/config>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_source_hooks.1:60
+msgid ""
+"bind mounted configuration directory within the source directory to be read "
+"by hook files."
+msgstr ""
+
+#. type: IP
+#: en/lb_source_hooks.1:60
 #, no-wrap
-msgid "B<source>"
+msgid "B<source/live-build>:"
 msgstr ""