Update documentation for --arch option
[grml-debootstrap.git] / grml-debootstrap.8.txt
index 2c69412..7bf600e 100644 (file)
@@ -29,6 +29,13 @@ CAUTION: The grml team does not take responsibility for loss of any data!
 Options and environment variables
 ---------------------------------
 
+*--arch* <_architecture_>::
+
+    Architecture you want to bootstrap. Currently only i386 is supported.
+    Defaults to the architecture that is currently running on your system. If
+    you're running an amd64 system and want to deploy a i386 system use this option.
+    Note: deploying amd64 from a i386 system won't work.
+
 *--bootappend* <_appendline for the kernel_>::
 
     Specify appendline for the kernel.
@@ -56,7 +63,7 @@ Options and environment variables
 
 *--debopt* <_params_>::
 
-    Extra parameters passed to the debootstrap.
+    Extra parameters passed to the debootstrap command.
 
 *--groot* <_device_>::
 
@@ -102,6 +109,8 @@ Options and environment variables
 
     Specify mountpoint that should be used for mounting the target system.
     Corresponding with configuration variable MNTPOINT.
+    Note: this option has no effect if option -t is given and represents a
+    directory.
 
 *--packages* <_file_>::
 
@@ -116,21 +125,22 @@ Options and environment variables
 
 *-r*, *--release* <_releasename_>::
 
-    Specify release of new Debian system. Supported releases: etch, lenny,
+    Specify release of new Debian system. Supported releases names: etch, lenny,
     squeeze (note: requires current version of debootstrap) and sid.
     Corresponding with configuration variable RELEASE.
 
 *--scripts* <_directory_>::
 
     Execute scripts from specified directory. This allows customisation of
-    the system after the chroot has been set up.
+    the system after the chroot has been set up. The environment variable
+    $MNTPOINT is available inside the scripts for direct access of the chroot.
     Default directory: /etc/debootstrap/scripts/
 
 *-t*, *--target* <_target_>::
     Target partition (/dev/...) or directory (anything else without /dev at the
     beginning). To install grub using *--grub* and *--groot*, make sure to
     use a _device_ instead of a directory as _target_ (installation of
-    grub as bootloader when using directories isn't supported yet).
+    grub as bootloader when using directories is NOT supported).
 
 *-v*, *--verbose*::
     Increase verbosity.
@@ -155,6 +165,7 @@ Grub in MBR (master boot record) of /dev/sda and use /dev/sda1 as system partiti
 Install Debian unstable/sid on /dev/sda6, install bootmanager
 Grub in MBR (master boot record) of /dev/sda and use /dev/sda6 as system partition.
 
+  mount /dev/sda1 /data/chroot
   grml-debootstrap --target /data/chroot
 
 Install default Debian release (stable/lenny) in directory /data/chroot (without