improve documentation wording and content

Reported-by: Johannes Schauer Marin Rodrigues <josch@mister-muffin.de>

1 files changed, 5 insertions, 3 deletions

diff --git a/debvm-run b/debvm-run
index 729ba6d..cb782db 100755
--- a/debvm-run
+++ b/debvm-run
@@ -13,7 +13,7 @@ B<debvm-run> [B<-g>] [B<-i> I<image>] [B<-s> I<sshport>] [B<--> I<qemu options>]
 
 =head1 DESCRIPTION
 
-B<debvm-run> is essentially a thing wrapper around B<qemu> for running a virtual machine image created by B<debvm-create> or something compatible.
+B<debvm-run> is essentially a thin wrapper around B<qemu> for running a virtual machine image created by B<debvm-create> or something compatible.
 The virtual machine image is expected to be a raw ext4 image with file system label B<debvm>.
 The architecture of the machine is detected from the contained B</bin/true>.
 It must contain a symbolic link pointing to a kernel image at B</vmlinuz> or B</vmlinux> depending on the architecture and a symbolic link pointing to an initrd image at B</initrd.img>.
@@ -42,14 +42,16 @@ If given, B<qemu> is configured to pass connections to I<127.0.0.1:sshport> to p
 
 All options beyond a double dash are passed to B<qemu>.
 This can be used to configure additional hardware components.
-Another use of this method is passing B<-snapshot> to avoid modifying the virtual machine image.
+One possible use of this method is passing B<-snapshot> to avoid modifying the virtual machine image.
 
 =back
 
 =head1 LIMITATIONS
 
-Due to the way kernel and bootloader are being extracted before running qemu, one cannot upgrade a kernel and then just reboot.
+Due to the way kernel and bootloader are being extracted before running B<qemu>, one cannot upgrade a kernel and then just reboot.
+Attempting to do so, will still use the old kernel.
 Instead, B<qemu> must be terminated and B<debvm-run> should be launched again to pick up a new kernel.
+In order to avoid accidental reboots, one may pass B<-no-reboot> to B<qemu>.
 
 =head1 SEE ALSO