to close Issue555, Make --confdir=path works as expected.

[grml-debootstrap.git] / grml-debootstrap.8.txt

diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt
index 0644643..1a0880f 100644 (file)
--- a/grml-debootstrap.8.txt
+++ b/grml-debootstrap.8.txt
@@ -47,7 +47,7 @@ Options and environment variables
     Corresponding with configuration variable GROOT.
 
 *--boot_append* <_appendline for the kernel_>::
-    Specifiy appendline for the kernel. 
+    Specify appendline for the kernel.
     E.g. "_pci=nomsi_"
 
 *-m*, *--mirror* <_URL_>::
@@ -55,6 +55,13 @@ Options and environment variables
     specifying the mirror also sets the chrootmirror to the given value.
     Corresponding with configuration variables MIRROR and CHROOTMIRROR.
 
+*-i*, *--iso* <_/mntpoint_>::
+    Specify mountpoint where you have a Debian ISO mounted loopback.
+    Using this option instead of the mirror option gives you the possibility
+    to install the base-system without network access. Make sure you
+    mounted the according Debian-ISO to the given <_/mntpoint_>. See section
+    'Usage examples' for a demonstration.
+
 *-p*, *--mntpoint* <_/mntpoint_>::
     Specify mountpoint that should be used for mounting the target system.
     Corresponding with configuration variable MNTPOINT.
@@ -65,12 +72,14 @@ Options and environment variables
     It's meant for automatic installation only.
 
 *-r*, *--release* <_releasename_>::
-    Specify release of new Debian system. Supported relases: sarge, etch, lenny and sid.
+    Specify release of new Debian system. Supported releases: sarge, etch, lenny and sid.
     Corresponding with configuration variable RELEASE.
 
 *-t*, *--target* <_target_>::
     Target partition (/dev/...) or directory (anything else without /dev at the
-    beginning).
+    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).
 
 WARNING: the commandline parsing of grml-debootstrap does not validate the provided
 arguments for the commandline options. Please be careful and check docs and
@@ -98,7 +107,16 @@ any bootloader).
 
 Install default Debian release (stable/etch) on /dev/sda3 and install bootmanager
 Grub in MBR (master boot record) of /dev/sda and use /dev/sda3 as system partition.
-Use specifed mirror instead of the default (ftp://ftp.debian.de/debian) one.
+Use specified mirror instead of the default (ftp://ftp.debian.de/debian) one.
+
+  mount -o loop /mnt/hda6/debian-40r0-i386-CD-1.iso /mnt/iso
+  grml-debootstrap --target /dev/hda1 --grub hd0 --groot hd0,0 --iso file:/mnt/iso/debian/
+
+Install Debian stable/etch on /dev/hda1 using the loopback mounted Debian-ISO
+for the base-system and install bootmanager Grub in MBR (master boot record) of
+/dev/hda and use /dev/hda1 as system partition. Please notice, that the chroot
+system requires network access for all packages which are not part of the
+ISO.
 
 Files
 -----
@@ -134,7 +152,7 @@ single function of grml-debootstrap will write 'done' to the stages directory
 into a file named as the function itself if it has been executed successfully.
 You can adjust the location of the directory via configuration variable STAGES
 via /etc/debootstrap/config.  Please notice that you have to remove the stages
-directory on your own if you want to re-execute grml-deboostrap after running it
+directory on your own if you want to re-execute grml-debootstrap after running it
 successfully once. This should avoid recurrent execution by error of
 grml-debootstrap (which might delete present data).
 
@@ -150,7 +168,7 @@ want to put existing files to the new Debian system you can place them into the
 /etc/debootstrap/. Every existing directory will be copied to the new Debian
 system then. If you want to install additional packages that are not available
 via the grml or debian mirror drop them into /etc/debootstrap/extrapackages and
-take sure that EXTRAPACKAGES is set to "yes". 
+make sure that EXTRAPACKAGES is set to "yes".
 
 Automatic installation
 ----------------------
@@ -191,7 +209,7 @@ Usage example: mirror=ftp://ftp.tugraz.at/mirror/debian
 
   password=...
 
-Set passwort of user root without prompting for it but set it to the given
+Set password of user root without prompting for it but set it to the given
 argument. Usage example: password=AiTh5ahn
 
 Usage example for automatic installation: