Adding program specification to lb_source_hooks manpage.

1 files changed, 41 insertions, 5 deletions

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