Adding program specification to lb_binary_hooks manpage.

1 files changed, 42 insertions, 6 deletions

diff --git a/manpages/es/lb_binary_hooks.es.1 b/manpages/es/lb_binary_hooks.es.1
index 7384e8803..066d0c982 100644
--- a/manpages/es/lb_binary_hooks.es.1
+++ b/manpages/es/lb_binary_hooks.es.1
@@ -27,7 +27,34 @@
 live\-build contains the components to build a live system from a
 configuration directory.
 .PP
-The \fBlb binary_hooks\fP command executes hooks after the binary stage.
+The \fBlb binary_hooks\fP command executes hook files after the binary stage.
+
+.SH SPECIFICATION
+\fBlb binary_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 binary_hooks\fP automatically
+when they are executed.
+.PP
+Hook files must either have the suffix \fB*.hook\fP or \fB*.hook.binary\fP.
+.PP
+Hook files with the suffix \fB*.hook\fP are executed first, hook files with the
+suffix \fB*.hook.binary\fP are executed second.
+.PP
+Hook files are executed in alphanumberical order by \fBlb binary_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 \fBbinary/live\-build\fP directory by \fBlb
+binary_hoooks\fP. They are executed from within the binary directory and can
+read the configuration directory in \fBlive\-build/config\fP within the binary
+directory.
+.PP
+\fBWarning:\fP hook files are not executed within a chroot but within the
+context of the host system in the binary directory. They have root
+privileges and access to the all host system ressources (devices,
+filesystems, network, etc.).
 
 .SH OPCIONES
 .IP \-\-verbose 4
@@ -38,15 +65,24 @@ 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.binary\fP 4
-.IP \fBbinary\fP 4
+.IP \fBconfig/build\fP: 4
+generic configuration file.
+.IP \fBconfig/hooks/*.hook\fP: 4
+generic hook files.
+.IP \fBconfig/hooks/*.hook.binary\fP: 4
+hook files specific for the binary stage.
+.IP \fBbinary\fP: 4
+directory in which the hook files are executed.
+.IP \fBbinary/live\-build/config\fP: 4
+bind mounted configuration directory within the binary directory to be read
+by hook files.
+.IP \fBbinary/live\-build\fP: 4
+directory in which hook files are copied.
 
 .SH "VER TAMBIÉN"
 .IP \fIlb_bootstrap_hooks\fP(1) 4
 .IP \fIlb_chroot_hooks\fP(1) 4
-.IP \fIlb_source_hooks\fP(1)
+.IP \fIlb_source_hooks\fP(1) 4
 
 .SH "PÁGINA WEB"
 Se puede encontrar más información acerca de live\-build y el proyecto Live