debvm-create: extend examples in the manual page

1 files changed, 24 insertions, 1 deletions

diff --git a/bin/debvm-create b/bin/debvm-create
index 89256eb..521ad36 100755
--- a/bin/debvm-create
+++ b/bin/debvm-create
@@ -136,10 +136,33 @@ Any positional arguments passed here will be treated as mirror specifications by
 
 =head1 EXAMPLES
 
-In order to create images for Debian ports architectures, you can pass two options to mmdebstrap:
+In order to create images for Debian ports architectures, you can pass two options to mmdebstrap.
 
     debvm-create ... -- http://deb.debian.org/debian-ports --keyring=/usr/share/keyrings/debian-ports-archive-keyring.gpg
 
+You can also install a graphical desktop environment.
+
+    debvm-create ... -- --hook-dir=/usr/share/mmdebstrap/hooks/useradd --aptopt='Apt::Install-Recommends "true"' --include=linux-image-generic,task-gnome-desktop
+
+Here the hook creates a password-less user C<user>.
+In order for C<task-gnome-desktop> to work reasonably well, C<Recommends> should be enabled.
+By default a C<-cloud> kernel that lacks graphics drivers is installed.
+
+Installing Ubuntu is also supported somewhat.
+
+    debvm-create --release kinetic -- --keyring=/usr/share/keyrings/ubuntu-archive-keyring.gpg --components=main,universe --include=e2fsprogs
+
+Note that C<universe> must be enabled as the C<merged-usr> and C<systemdnetwork> hooks rely packages from that component.
+C<e2fsprogs> should be pulled by C<initramfs-tools>.
+
+There also is an aid for sharing a directory with the VM.
+
+    debvm-create ... -- --include=linux-image-generic --hook-dir=/usr/share/mmdebstrap/hooks/9pmount
+    debvm-run ... -- -virtfs local,security_model=none,path=/host_path,mount_tag=guest_tag
+
+This will mount the directory C</host_path> from the host as C</media/guest_tag> in the VM during boot using 9P.
+Note that the C<-cloud> kernel lacks the 9P filesystem driver.
+
 =head1 SEE ALSO
 
     debvm-run(1) mmdebstrap(1)