Subject: Re: [bug#27869] [PATCH] doc: Add note about overwritting /gnu/store/...-run-vm.sh
From: [email-masked] (Ludovic Courtès)
To: Oleg Pykhalov <[email-masked]>
Cc: [email-masked]
Date: Sun, 30 Jul 2017 14:23:38 +0200
List-Id: <debbugs-submit.debbugs.gnu.org>

Heya,

Oleg Pykhalov <[email-masked]> skribis:

> Hi Ludovic,
>
> [email-masked] (Ludovic Courtès) writes:
>
> [...]
>
>> Perhaps we should add the example to illustrate this last sentence?
>
> Yea, it will be great, because it's not obvious for me and maybe
> somebody else.  Is current example OK?

Yes, I’ve committed this:

diff --git a/doc/guix.texi b/doc/guix.texi
index 345285031..77909f886 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -16440,7 +16440,13 @@ passed.
 @anchor{guix system vm}
 Build a virtual machine that contains the operating system declared in
 @var{file}, and return a script to run that virtual machine (VM).
-Arguments given to the script are passed to QEMU.
+Arguments given to the script are passed to QEMU as in the example
+below, which enables networking and requests 1@tie{}GiB of RAM for the
+emulated machine:
+
+@example
+$ /gnu/store/@dots{}-run-vm.sh -m 1024 -net user
+@end example
 
 The VM shares its store with the host system.

Thanks,
Ludo’.