update pod2man documentation

 * Rename debvm-create -s to -z.
 * Add long options.
 * Improve documentation of debvm-create -p and -z.

1 files changed, 13 insertions, 11 deletions

diff --git a/debvm-create b/debvm-create
index 37fa514..b39330b 100755
--- a/debvm-create
+++ b/debvm-create
@@ -11,7 +11,7 @@ debvm-create - Create a VM image for various Debian releases and architectures
 
 =head1 SYNOPSIS
 
-B<debvm-create> [B<-a> I<architecture>] [B<-h> I<hostname>] [B<-k> I<sshkey>] [B<-m> I<mirror>] [B<-o> I<output>] [B<-p> I<package>] [B<-r> I<release>] [B<-s> I<size_in_GB>] [B<--> I<mmdebstrap options>]
+B<debvm-create> [B<-a> I<architecture>] [B<-h> I<hostname>] [B<-k> I<sshkey>] [B<-m> I<mirror>] [B<-o> I<output>] [B<-p> I<package>] [B<-r> I<release>] [B<-z> I<size_in_GB>] [B<--> I<mmdebstrap options>]
 
 =head1 DESCRIPTION
 
@@ -26,48 +26,50 @@ No user account is created and root can login without specifying a password.
 
 =over 8
 
-=item B<-a> I<architecture>
+=item B<-a> I<architecture>, B<--architecture>=I<architecture>
 
 Specify a Debian architecture name.
 By default, the native architecture is being used.
 A suitable kernel image is automatically selected and installed into the image.
 
-=item B<-h> I<hostname>
+=item B<-h> I<hostname>, B<--hostname>=I<hostname>
 
 Set the hostname of the virtual machine.
 By default, the hostname is B<testvm>.
 
-=item B<-k> I<sshkey>
+=item B<-k> I<sshkey>, B<--sshkey>=I<sshkey>
 
 Install the given ssh public key file into the virtual machine image for the root user.
 This option also causes the ssh server to be installed.
 By default, no key or server is installed.
 
-=item B<-m> I<mirror>
+=item B<-m> I<mirror>, B<--mirror>=I<mirror>
 
 Specify the Debian mirror to be used for downloading packages and to be configured inside the virtual machine image.
 By default, B<http://deb.debian.org/debian> is being used.
 
-=item B<-o> I<output>
+=item B<-o> I<output>, B<--output>=I<output>
 
 Specify the file name of the resulting virtual machine image.
 By default, it is written to B<rootfs.ext4>.
 
-=item B<-p> I<package>
+=item B<-p> I<package>, B<--package>=I<package>
 
 Request additional packages to be installed into the virtual machine image.
 This option can be specified multiple times and packages can be separated by a comma.
 Package recommendations are not honoured.
+If a linux-image is passed here, it will replace the one selected by default.
 
-=item B<-r> I<release>
+=item B<-r> I<release>, B<--release>=I<release>
 
 Use the given Debian release.
 By default, B<unstable> is being used.
 
-=item B<-s> I<size_in_GB>
+=item B<-z> I<size_in_GB>, B<--size>=I<size_in_GB>
 
-Specify the image size in giga bytes.
-The default image size is 1 GB.
+Specify the minimum image size in giga bytes.
+The resulting image will be grown as a sparse file to this size if necessary.
+The default is 1 GB.
 
 =item B<--> I<mmdebstrap options>