Adding program specification to lb_source_hooks manpage.

1 files changed, 146 insertions, 39 deletions

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>:"