Adding program specification to lb_chroot_hooks manpage.

1 files changed, 36 insertions, 5 deletions

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