Release new version 0.39.

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

diff --git a/grml-debootstrap.8.txt b/grml-debootstrap.8.txt
index a12054a..01337bb 100644 (file)
--- a/grml-debootstrap.8.txt
+++ b/grml-debootstrap.8.txt
@@ -56,17 +56,21 @@ Options and environment variables
 
     Place of configuration files for debootstrap, defaults to /etc/debootstrap.
 
-*--debconf*[=<_file_>]::
+*--debconf* <_file_>::
 
-    When using *--debconf* without the optional '=<_file_>' parameter, it
-    enables preseeding Debian packages using the default
-    '<confdir>/debconf-selections' file. If the optional parameter is given,
-    use the specified file for preseeding Debian packages instead.
+    Use specified file for preseeding Debian packages instead of using
+    the default <confdir>/debconf-selections.
 
 *--debopt* <_params_>::
 
     Extra parameters passed to the debootstrap command.
 
+*--filesystem* <_filesystem_>::
+
+    Filesystem that should be created when installing to a partition.
+    If unset defaults to ext3. Valid values are all filesystems that
+    can be created through mkfs.<filesystem>.
+
 *--grub* <_device_>::
 
     Device where grub should be installed to. Note that only the MBR (master
@@ -105,6 +109,10 @@ Options and environment variables
 
     Skip debootstrap, only do configuration to the target.
 
+*--nopackages*::
+
+    Skip installation of packages defined in /etc/debootstrap/packages.
+
 *--insecure*::
 
     Do not download and check signatures for retrieved Release files.
@@ -116,13 +124,10 @@ Options and environment variables
     Note: this option has no effect if option -t is given and represents a
     directory.
 
-*--packages*[=<_file_>]::
+*--packages* <_file_>::
 
-    When using *--packages* without the optional '=<_file_>' parameter, it
-    enables installing the packages defined in the default package list
-    '<confdir>/packages' file. If the optional parameter is given, the
-    specified list file is used as list for packages that should be
-    installed instead.
+    Use specified file as list for packages that should be installed instead of
+    the default package list file <confdir>/packages.
 
 *--password* <_password_>::
 
@@ -136,25 +141,20 @@ Options and environment variables
     squeeze (note: requires current version of debootstrap) and sid.
     Corresponding with configuration variable RELEASE.
 
-*--pre-scripts*[=<_directory_>]::
+*--pre-scripts* <_directory_>::
 
-    When using *--pre-scripts* without the optional '=<_directory_>'
-    parameter, it enables executing scripts from the default
-    '<confdir>/pre-scripts/' directory before executing the chroot script.
-    If the optional parameter is given, execute scripts from the specified
-    directory instead. This allows customization of the system before the
-    chroot has been set up.  The environment variable $MNTPOINT is available
-    inside the scripts for direct access of the chroot.
+    Execute scripts from specified directory before executing the chroot
+    script. This allows customisation of the system before 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/pre-scripts/
 
-*--scripts*[=<_directory_>]::
+*--scripts* <_directory_>::
 
-    When using *--scripts* without the optional '=<_directory_>' parameter,
-    it enables executing scripts from the default '<confdir>/scripts/'
-    directory after the chroot has been set up.  If the optional parameter is
-    given, execute scripts from the specified directory instead. This allows
-    customisation of the system after the chroot has been set up. The
-    environment variable $MNTPOINT is available inside the scripts for
-    direct access of the chroot.
+    Execute scripts from specified directory. This allows customisation of
+    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
@@ -168,21 +168,9 @@ Options and environment variables
 *-V*, *--version*::
     Show version of program and exit.
 
-TIP: The long options may be abbreviated, as long as the abbreviation is not
-ambiguous. Eg. '--k' will be the same as '--keep_src_list', and '--pac' be
-'--packages'.
-
-[WARNING]
-=====================================================================
-
-- To specify the optional parameter for switches that accept them, the
-optional argument must be written directly after the long option name,
-separated by `=' (without space).
-
-- the commandline parsing of grml-debootstrap does not validate the provided
+WARNING: the commandline parsing of grml-debootstrap does not validate the provided
 arguments for the commandline options. Please be careful and check docs and
 /etc/debootstrap/config for further information.
-=====================================================================
 
 Usage examples
 ---------------
@@ -224,7 +212,8 @@ Files
   /etc/debootstrap/config
 
 Main configuration file. You have to adjust it according to your needs
-before you are able to run grml-debootstrap.
+if you want to execute grml-debootstrap in the non-interactive mode without
+any special command line arguments.
 
   /etc/debootstrap/chroot-script