Update and extend information on preseeding partman

Based on a patch from Vincent McIntyre.

1 files changed, 16 insertions, 9 deletions

diff --git a/en/appendix/preseed.xml b/en/appendix/preseed.xml
index 565e5ffde..81451bfed 100644
--- a/en/appendix/preseed.xml
+++ b/en/appendix/preseed.xml
@@ -967,12 +967,11 @@ d-i clock-setup/ntp boolean true
   <title>Partitioning</title>
 <para>
 
-Using preseeding to partition the harddisk is very much limited to what is
-supported by <classname>partman-auto</classname>. You can choose to partition
+Using preseeding to partition the harddisk is limited to what is supported
+by <classname>partman-auto</classname>. You can choose to partition
 either existing free space on a disk or a whole disk. The layout of the
 disk can be determined by using a predefined recipe, a custom recipe from
-a recipe file or a recipe included in the preconfiguration file. It is
-currently not possible to partition multiple disks using preseeding.
+a recipe file or a recipe included in the preconfiguration file.
 
 </para>
 
@@ -989,13 +988,17 @@ correct one will be selected before using preseeding.
 # This is only honoured if partman-auto/method (below) is not set.
 #d-i partman-auto/init_automatically_partition select biggest_free
 
-# Alternatively, you can specify a disk to partition. The device name must
-# be given in traditional non-devfs format.
-# Note: A disk must be specified, unless the system has only one disk.
+# Alternatively, you may specify a disk to partition. If the system has only
+# one disk the installer will default to using that, but otherwise the device
+# name must be given in traditional, non-devfs format (so e.g. /dev/hda or
+# /dev/sda, and not e.g. /dev/discs/disc0/disc).
 # For example, to use the first SCSI/SATA hard disk:
 #d-i partman-auto/disk string /dev/sda
 # In addition, you'll need to specify the method to use.
-# The presently available methods are: "regular", "lvm" and "crypto"
+# The presently available methods are:
+# - regular: use the usual partition types for your architecture
+# - lvm:     use LVM to partition the disk
+# - crypto:  use LVM within an encrypted partition
 d-i partman-auto/method string lvm
 
 # If one of the disks that are going to be automatically partitioned
@@ -1014,7 +1017,6 @@ d-i partman-lvm/confirm boolean true
 d-i partman-auto/choose_recipe select atomic
 
 # Or provide a recipe of your own...
-# The recipe format is documented in the file devel/partman-auto-recipe.txt.
 # If you have a way to get a recipe file into the d-i environment, you can
 # just point at it.
 #d-i partman-auto/expert_recipe_file string /hd-media/recipe
@@ -1039,6 +1041,11 @@ d-i partman-auto/choose_recipe select atomic
 #                      method{ swap } format{ }                \
 #              .
 
+# The recipe format is documented in the D-I source repository in the file
+# installer/doc/devel/partman-auto-recipe.txt. This also documents how to
+# specify settings such as filesystem labels, volume group names and which
+# physical devices to include in a volume group.
+
 # This makes partman automatically partition without confirmation, provided
 # that you told it what to do using one of the methods above.
 d-i partman-partitioning/confirm_write_new_label boolean true