[Pkg-uml-commit] r156 - trunk/src/rootstrap

[Mattia Dongili]

Author: malattia
Date: 2006-08-20 18:54:23 +0000 (Sun, 20 Aug 2006)
New Revision: 156

Modified:
   trunk/src/rootstrap/rootstrap.sgml
Log:
document apt_force_yes and the new debugging stuff

Modified: trunk/src/rootstrap/rootstrap.sgml
===================================================================
--- trunk/src/rootstrap/rootstrap.sgml	2006-08-20 18:53:41 UTC (rev 155)
+++ trunk/src/rootstrap/rootstrap.sgml	2006-08-20 18:54:23 UTC (rev 156)
@@ -257,7 +257,10 @@
 	      script fails allowing further debugging actions.
 	      The shell will have the same environment as the failing script so
 	      you could simply invoke <command>sh -x /path/to/module</command>
-	      to see what's going wrong.
+	      to see what's going wrong. Moreover the shell exit value will be
+	      used to tell rootstrap to: re-evaluate the script when 1 (with exit 1)
+	      or continue with the next one when 2 (with exit 2); all other values
+	      will make rootstrap fail with an error.
               This parameter is optional.
             </para>
           </listitem>
@@ -550,6 +553,19 @@
             </para>
           </listitem>
         </varlistentry>
+
+        <varlistentry>
+          <term>apt_force_yes</term>
+          <listitem>
+            <para>
+	      Will make rootstrap use the --force-yes switch to install 
+	      debian packages. This useful when you need to install packages
+	      from sources that don't use a Release.gpg file and thus failing
+	      apt key authentication. It can be either <parameter>true</parameter>
+	      or <parameter>false</parameter> and defaults to the former.
+            </para>
+          </listitem>
+        </varlistentry>
       </variablelist>
 
     </refsect2>
@@ -565,16 +581,21 @@
 
       <para>
         When a module is invoked, the filesystem being created is
-        mounted on $TARGET. /dev, /etc and /tmp are tmpfs filesystems
+        mounted on $TARGET, /dev, /etc and /tmp are tmpfs filesystems
         internal to the UML system, while the root filesystem is a
 	hostfs mount of the system where rootstrap is running. /lib/modules is
 	tmpfs too and bind mounted to the host's /usr/lib/uml/modules to let
 	scripts load necessary kernel modules.
 	This means that most software on the host system should be
-        available and work as expected.  The working directory where
-        rootstrap is run is available as $WORKDIR.  The environment is
+        available and work as expected. The working directory where
+        rootstrap is run is available as $WORKDIR. The environment is
         generated from the configuration file as described above.
       </para>
+
+      <para>
+        To debug modules enable the <parameter>debug</parameter> global 
+	parameter, see its description fro more hints.
+      </para>
     </refsect2>
 
   </refsect1>