Adding program specification to lb_chroot_hooks manpage.

6 files changed, 534 insertions, 144 deletions

diff --git a/manpages/de/lb_chroot_hooks.de.1 b/manpages/de/lb_chroot_hooks.de.1
index 12f3731e7..2bcb7dd76 100644
--- a/manpages/de/lb_chroot_hooks.de.1
+++ b/manpages/de/lb_chroot_hooks.de.1
@@ -27,7 +27,32 @@
 live\-build enthält die Komponenten um ein Live System von einem
 Konfigurationsverzeichnis zu erstellen.
 .PP
-Der \fBlb chroot_hooks\fP Befehl führt Hooks nach dem Chroot Stage aus.
+Der \fBlb chroot_hooks\fP Befehl führt Hook Dateien nach dem Chroot Stage aus.
+
+.SH SPEZIFIKATION
+\fBlb chroot_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 chroot_hooks\fP ausgeführt werden.
+.PP
+Hook Dateien müssen entweder den Suffix \fB*.hook\fP oder \fB*.hook.chroot\fP
+haben.
+.PP
+Hook Dateien mit dem Suffix \fB*.hook\fP werden als erstes ausgeführt, Hook
+Dateien mit dem Suffix \fB*.hook.chroot\fP als zweites.
+.PP
+Hook Dateien werden von \fBlb chroot_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 chroot_hooks\fP in das \fBchroot/live\-build\fP
+Verzeichnis kopiert. Sie werden innerhalb des chroot Verzeichnises
+ausgeführt und können das Konfigurationsverzeichnis in \fB/live\-build/config\fP
+innerhalb des chroot Verzeichnisses lesen.
 
 .SH OPTIONEN
 .IP \-\-verbose 4
@@ -38,10 +63,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.chroot\fP 4
-.IP \fBchroot\fP 4
+.IP \fBconfig/build\fP: 4
+allgemeine Konfigurationsdatei.
+.IP \fBconfig/hooks/*.hook\fP: 4
+Allgemeine Hook Dateien.
+.IP \fBconfig/hooks/*.hook.chroot\fP: 4
+Hook Dateien spezifisch für den Chroot Stage.
+.IP \fBchroot\fP: 4
+Verzeichnis in dem Hook Dateien ausgeführt werden.
+.IP \fBchroot/live\-build/config\fP: 4
+bind mount des Konfigurationsverzeichnis innerhalb des chroot Verzeichnisses
+um von Hook Dateien gelesen werden zu können.
+.IP \fBchroot/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_chroot_hooks.1 b/manpages/en/lb_chroot_hooks.1
index 33bd3f24b..6ab570523 100644
--- a/manpages/en/lb_chroot_hooks.1
+++ b/manpages/en/lb_chroot_hooks.1
@@ -21,7 +21,20 @@
 .SH DESCRIPTION
 live\-build contains the components to build a live system from a configuration directory.
 .PP
-The \fBlb chroot_hooks\fR command executes hooks after the chroot stage.
+The \fBlb chroot_hooks\fR command executes hook files after the chroot stage.
+
+.SH SPECIFICATION
+\fBlb chroot_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 chroot_hooks\fR automatically when they are executed.
+.PP
+Hook files must either have the suffix \fB*.hook\fR or \fB*.hook.chroot\fR.
+.PP
+Hook files with the suffix \fB*.hook\fR are executed first, hook files with the suffix \fB*.hook.chroot\fR are executed second.
+.PP
+Hook files are executed in alphanumberical order by \fBlb chroot_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 \fBchroot/live-build\fR directory by \fBlb chroot_hoooks\fR. They are executed from within the chroot directory (chrooted) and can read the configuration directory in \fB/live-build/config\fR within the chroot directory.
 
 .SH OPTIONS
 .IP "\-\-verbose" 4
@@ -32,10 +45,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.chroot\fR" 4
-.IP "\fBchroot\fR" 4
+.IP "\fBconfig/build\fR:" 4
+generic configuration file.
+.IP "\fBconfig/hooks/*.hook\fR:" 4
+generic hook files.
+.IP "\fBconfig/hooks/*.hook.chroot\fR:" 4
+hook files specific for the chroot stage.
+.IP "\fBchroot\fR:" 4
+directory in which the hook files are executed.
+.IP "\fBchroot/live-build/config\fR:" 4
+bind mounted configuration directory within the chroot directory to be read by hook files.
+.IP "\fBchroot/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_chroot_hooks.es.1 b/manpages/es/lb_chroot_hooks.es.1
index b8211c668..a26305a8a 100644
--- a/manpages/es/lb_chroot_hooks.es.1
+++ b/manpages/es/lb_chroot_hooks.es.1
@@ -27,7 +27,29 @@
 live\-build contains the components to build a live system from a
 configuration directory.
 .PP
-The \fBlb chroot_hooks\fP command executes hooks after the chroot stage.
+The \fBlb chroot_hooks\fP command executes hook files after the chroot stage.
+
+.SH SPECIFICATION
+\fBlb chroot_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 chroot_hooks\fP automatically
+when they are executed.
+.PP
+Hook files must either have the suffix \fB*.hook\fP or \fB*.hook.chroot\fP.
+.PP
+Hook files with the suffix \fB*.hook\fP are executed first, hook files with the
+suffix \fB*.hook.chroot\fP are executed second.
+.PP
+Hook files are executed in alphanumberical order by \fBlb chroot_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 \fBchroot/live\-build\fP directory by \fBlb
+chroot_hoooks\fP. They are executed from within the chroot directory
+(chrooted) and can read the configuration directory in \fB/live\-build/config\fP
+within the chroot directory.
 
 .SH OPCIONES
 .IP \-\-verbose 4
@@ -38,10 +60,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.chroot\fP 4
-.IP \fBchroot\fP 4
+.IP \fBconfig/build\fP: 4
+generic configuration file.
+.IP \fBconfig/hooks/*.hook\fP: 4
+generic hook files.
+.IP \fBconfig/hooks/*.hook.chroot\fP: 4
+hook files specific for the chroot stage.
+.IP \fBchroot\fP: 4
+directory in which the hook files are executed.
+.IP \fBchroot/live\-build/config\fP: 4
+bind mounted configuration directory within the chroot directory to be read
+by hook files.
+.IP \fBchroot/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_chroot_hooks.1.po b/manpages/po/de/lb_chroot_hooks.1.po
index 778928176..332776218 100644
--- a/manpages/po/de/lb_chroot_hooks.1.po
+++ b/manpages/po/de/lb_chroot_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:30+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_chroot_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:39 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:40 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:42 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:42 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:44 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:44 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:46 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:47 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr "DATEIEN"
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_chroot_hooks.1:48 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_chroot_hooks.1:50 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr "allgemeine Konfigurationsdatei."
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_chroot_hooks.1:50 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_chroot_hooks.1:52 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_chroot_hooks.1:56 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_chroot_hooks.1:60 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:61 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:62 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:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:43
+#: en/lb_binary_hooks.1:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:64
 #, no-wrap
 msgid "I<lb_source_hooks>(1)"
 msgstr "I<lb_source_hooks>(1)"
@@ -173,7 +211,7 @@ msgstr "I<lb_source_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:66 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:68 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:69 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:71 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:72 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:73 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,27 +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_cdebootstrap.1:40 en/lb_bootstrap_debootstrap.1:40
-#: en/lb_bootstrap_hooks.1:38 en/lb_chroot_hooks.1:38
-#, no-wrap
-msgid "B<chroot>"
-msgstr "B<chroot>"
-
-#. 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:63 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr "I<lb_binary_hooks>(1)"
@@ -277,11 +295,107 @@ msgstr "B<lb chroot_hooks> [--version]"
 
 #. type: Plain text
 #: en/lb_chroot_hooks.1:25
-msgid "The B<lb chroot_hooks> command executes hooks after the chroot stage."
-msgstr "Der B<lb chroot_hooks> Befehl führt Hooks nach dem Chroot Stage aus."
+msgid ""
+"The B<lb chroot_hooks> command executes hook files after the chroot stage."
+msgstr ""
+"Der B<lb chroot_hooks> Befehl führt Hook Dateien nach dem Chroot Stage aus."
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:28
+msgid ""
+"B<lb chroot_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+"B<lb chroot_hooks> führt alle Hook Dateien die sich im B<config/hooks> "
+"Verzeichnis innerhalb des Konfigurationsvereichnisses befinden aus."
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb chroot_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 chroot_hooks> ausgeführt werden."
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.chroot>."
+msgstr ""
+"Hook Dateien müssen entweder den Suffix B<*.hook> oder B<*.hook.chroot> "
+"haben."
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.chroot> are executed second."
+msgstr ""
+"Hook Dateien mit dem Suffix B<*.hook> werden als erstes ausgeführt, Hook "
+"Dateien mit dem Suffix B<*.hook.chroot> als zweites."
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb chroot_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 chroot_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_chroot_hooks.1:38
+msgid ""
+"Hook files are copied into the B<chroot/live-build> directory by B<lb "
+"chroot_hoooks>. They are executed from within the chroot directory "
+"(chrooted) and can read the configuration directory in B</live-build/config> "
+"within the chroot directory."
+msgstr ""
+"Hook Dateien werden durch B<lb chroot_hooks> in das B<chroot/live-build> "
+"Verzeichnis kopiert. Sie werden innerhalb des chroot Verzeichnises "
+"ausgeführt und können das Konfigurationsverzeichnis in B</live-build/config> "
+"innerhalb des chroot Verzeichnisses lesen."
+
+#. type: IP
+#: en/lb_chroot_hooks.1:52
+#, no-wrap
+msgid "B<config/hooks/*.hook.chroot>:"
+msgstr "B<config/hooks/*.hook.chroot>:"
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:54
+msgid "hook files specific for the chroot stage."
+msgstr "Hook Dateien spezifisch für den Chroot Stage."
+
+#. type: IP
+#: en/lb_chroot_hooks.1:54
+#, no-wrap
+msgid "B<chroot>:"
+msgstr "B<chroot>:"
+
+#. type: IP
+#: en/lb_chroot_hooks.1:56
+#, no-wrap
+msgid "B<chroot/live-build/config>:"
+msgstr "B<chroot/live-build/config>:"
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:58
+msgid ""
+"bind mounted configuration directory within the chroot directory to be read "
+"by hook files."
+msgstr ""
+"bind mount des Konfigurationsverzeichnis innerhalb des chroot Verzeichnisses "
+"um von Hook Dateien gelesen werden zu können."
 
 #. type: IP
-#: en/lb_chroot_hooks.1:37
+#: en/lb_chroot_hooks.1:58
 #, no-wrap
-msgid "B<config/hooks/*.hook.chroot>"
-msgstr "B<config/hooks/*.hook.chroot>"
+msgid "B<chroot/live-build>:"
+msgstr "B<chroot/live-build>:"
diff --git a/manpages/po/es/lb_chroot_hooks.1.po b/manpages/po/es/lb_chroot_hooks.1.po
index d144f9895..f157000e1 100644
--- a/manpages/po/es/lb_chroot_hooks.1.po
+++ b/manpages/po/es/lb_chroot_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:30+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_chroot_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:39 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:40 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:42 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:42 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:44 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:44 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:46 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:47 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr "FICHEROS"
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_chroot_hooks.1:48 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_chroot_hooks.1:50 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr ""
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_chroot_hooks.1:50 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_chroot_hooks.1:52 en/lb_source_hooks.1:54
+msgid "generic hook files."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:58 en/lb_chroot_hooks.1:56 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_chroot_hooks.1:60 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:61 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:62 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:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:43
+#: en/lb_binary_hooks.1:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:64
 #, no-wrap
 msgid "I<lb_source_hooks>(1)"
 msgstr "I<lb_source_hooks>(1)"
@@ -174,7 +212,7 @@ msgstr "I<lb_source_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:66 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:68 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:69 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:71 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:72 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:73 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,27 +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_cdebootstrap.1:40 en/lb_bootstrap_debootstrap.1:40
-#: en/lb_bootstrap_hooks.1:38 en/lb_chroot_hooks.1:38
-#, no-wrap
-msgid "B<chroot>"
-msgstr "B<chroot>"
-
-#. 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:63 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr "I<lb_binary_hooks>(1)"
@@ -277,13 +295,92 @@ msgstr "B<lb chroot_hooks> [--version]"
 #. type: Plain text
 #: en/lb_chroot_hooks.1:25
 #, fuzzy
-msgid "The B<lb chroot_hooks> command executes hooks after the chroot stage."
+msgid ""
+"The B<lb chroot_hooks> command executes hook files after the chroot stage."
 msgstr ""
 "El programa B<lb chroot_hooks> preinstala el chroot del sistema con "
 "I<debootstrap>(8)."
 
+#. type: Plain text
+#: en/lb_chroot_hooks.1:28
+msgid ""
+"B<lb chroot_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb chroot_hooks> automatically when they are "
+"executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.chroot>."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.chroot> are executed second."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb chroot_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_chroot_hooks.1:38
+msgid ""
+"Hook files are copied into the B<chroot/live-build> directory by B<lb "
+"chroot_hoooks>. They are executed from within the chroot directory "
+"(chrooted) and can read the configuration directory in B</live-build/config> "
+"within the chroot directory."
+msgstr ""
+
 #. type: IP
-#: en/lb_chroot_hooks.1:37
-#, no-wrap
-msgid "B<config/hooks/*.hook.chroot>"
+#: en/lb_chroot_hooks.1:52
+#, fuzzy, no-wrap
+#| msgid "B<config/hooks/*.hook.chroot>"
+msgid "B<config/hooks/*.hook.chroot>:"
 msgstr "B<config/hooks/*.hook.chroot>"
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:54
+msgid "hook files specific for the chroot stage."
+msgstr ""
+
+#. type: IP
+#: en/lb_chroot_hooks.1:54
+#, fuzzy, no-wrap
+#| msgid "B<chroot>"
+msgid "B<chroot>:"
+msgstr "B<chroot>"
+
+#. type: IP
+#: en/lb_chroot_hooks.1:56
+#, fuzzy, no-wrap
+#| msgid "B<binary/live-build/config>:"
+msgid "B<chroot/live-build/config>:"
+msgstr "B<binary/live-build/config>:"
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:58
+msgid ""
+"bind mounted configuration directory within the chroot directory to be read "
+"by hook files."
+msgstr ""
+
+#. type: IP
+#: en/lb_chroot_hooks.1:58
+#, fuzzy, no-wrap
+#| msgid "B<binary/live-build>:"
+msgid "B<chroot/live-build>:"
+msgstr "B<binary/live-build>:"
diff --git a/manpages/pot/lb_chroot_hooks.1.pot b/manpages/pot/lb_chroot_hooks.1.pot
index b0eacf4ef..a656b8173 100644
--- a/manpages/pot/lb_chroot_hooks.1.pot
+++ b/manpages/pot/lb_chroot_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:30+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_chroot_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:39 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:40 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:42 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:42 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:44 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:44 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:46 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:47 en/lb_source_hooks.1:49
 #, no-wrap
 msgid "FILES"
 msgstr ""
 
+#. type: IP
+#: en/lb_binary_hooks.1:50 en/lb_chroot_hooks.1:48 en/lb_source_hooks.1:50
+#, no-wrap
+msgid "B<config/build>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:52 en/lb_chroot_hooks.1:50 en/lb_source_hooks.1:52
+msgid "generic configuration file."
+msgstr ""
+
+#. type: IP
+#: en/lb_binary_hooks.1:52 en/lb_chroot_hooks.1:50 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_chroot_hooks.1:52 en/lb_source_hooks.1:54
+msgid "generic hook files."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_binary_hooks.1:58 en/lb_chroot_hooks.1:56 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_chroot_hooks.1:60 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:61 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:62 en/lb_source_hooks.1:64
 #, no-wrap
 msgid "I<lb_bootstrap_hooks>(1)"
 msgstr ""
 
 #. type: IP
-#: en/lb_binary_hooks.1:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:43
+#: en/lb_binary_hooks.1:66 en/lb_bootstrap_hooks.1:43 en/lb_chroot_hooks.1:64
 #, no-wrap
 msgid "I<lb_source_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:66 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:68 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:69 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:71 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:72 en/lb_source_hooks.1:74
 #, no-wrap
 msgid "AUTHOR"
 msgstr ""
@@ -217,33 +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:73 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_cdebootstrap.1:40 en/lb_bootstrap_debootstrap.1:40
-#: en/lb_bootstrap_hooks.1:38 en/lb_chroot_hooks.1:38
-#, no-wrap
-msgid "B<chroot>"
-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:63 en/lb_source_hooks.1:66
 #, no-wrap
 msgid "I<lb_binary_hooks>(1)"
 msgstr ""
@@ -265,11 +283,86 @@ msgstr ""
 
 #. type: Plain text
 #: en/lb_chroot_hooks.1:25
-msgid "The B<lb chroot_hooks> command executes hooks after the chroot stage."
+msgid ""
+"The B<lb chroot_hooks> command executes hook files after the chroot stage."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:28
+msgid ""
+"B<lb chroot_hooks> executes any hook files found in the B<config/hooks> "
+"directory within the configuration directory."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:30
+msgid ""
+"Hook files do not require to have a specific owner nor specific permissions. "
+"They are marked executable by B<lb chroot_hooks> automatically when they are "
+"executed."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:32
+msgid "Hook files must either have the suffix B<*.hook> or B<*.hook.chroot>."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:34
+msgid ""
+"Hook files with the suffix B<*.hook> are executed first, hook files with the "
+"suffix B<*.hook.chroot> are executed second."
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:36
+msgid ""
+"Hook files are executed in alphanumberical order by B<lb chroot_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_chroot_hooks.1:38
+msgid ""
+"Hook files are copied into the B<chroot/live-build> directory by B<lb "
+"chroot_hoooks>. They are executed from within the chroot directory "
+"(chrooted) and can read the configuration directory in B</live-build/config> "
+"within the chroot directory."
+msgstr ""
+
+#. type: IP
+#: en/lb_chroot_hooks.1:52
+#, no-wrap
+msgid "B<config/hooks/*.hook.chroot>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:54
+msgid "hook files specific for the chroot stage."
+msgstr ""
+
+#. type: IP
+#: en/lb_chroot_hooks.1:54
+#, no-wrap
+msgid "B<chroot>:"
+msgstr ""
+
+#. type: IP
+#: en/lb_chroot_hooks.1:56
+#, no-wrap
+msgid "B<chroot/live-build/config>:"
+msgstr ""
+
+#. type: Plain text
+#: en/lb_chroot_hooks.1:58
+msgid ""
+"bind mounted configuration directory within the chroot directory to be read "
+"by hook files."
 msgstr ""
 
 #. type: IP
-#: en/lb_chroot_hooks.1:37
+#: en/lb_chroot_hooks.1:58
 #, no-wrap
-msgid "B<config/hooks/*.hook.chroot>"
+msgid "B<chroot/live-build>:"
 msgstr ""