From mboxrd@z Thu Jan 1 00:00:00 1970 From: Leo Famulari Subject: Re: [PATCH 1/1] doc: Show how to boot result of 'vm-image'. Date: Sun, 24 Jan 2016 16:02:47 -0500 Message-ID: <20160124210247.GA28700@jasmine> References: <87io2iopbq.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55280) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNRoI-0005q6-NY for guix-devel@gnu.org; Sun, 24 Jan 2016 16:02:59 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aNRoF-0006up-HA for guix-devel@gnu.org; Sun, 24 Jan 2016 16:02:58 -0500 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:42805) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aNRoF-0006ug-D3 for guix-devel@gnu.org; Sun, 24 Jan 2016 16:02:55 -0500 Content-Disposition: inline In-Reply-To: <87io2iopbq.fsf@gnu.org> List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: Ludovic =?iso-8859-1?Q?Court=E8s?= Cc: guix-devel@gnu.org On Sun, Jan 24, 2016 at 06:32:57PM +0100, Ludovic Courtès wrote: > Leo Famulari skribis: > > > * doc/guix.texi (Invoking guix system): Explain how to boot the QEMU > > images created by vm-image. > [...] > I’m thinking there are often questions about using GuixSD in a VM etc., > so it may well deserve one or two sections of its own. > > What about leaving the above sentence here, and appending: > > @xref{Running GuixSD in a VM}, for more information on how to run the > image in a virtual machine. > > ? > > The rest of the material you added would then go to the new “Running > GuixSD in a VM” section, which could go maybe right after “Invoking guix > system”. WDYT? That sounds good, done! > > > +When using @code{vm-image}, the returned image is in qcow2 format, which > > +the QEMU emulator can efficiently use. > > In the new section, this would need to be slightly adjusted to give more > context, like: > > One way to run GuixSD in a virtual machine is to build a GuixSD > virtual machine image using @command{guix system vm-image} > (@pxref{Invoking guix system}). The returned image is in qcow2 > format, which the @uref{http://qemu.org/, QEMU emulator} can > efficiently use. Thanks for this :) [...] > > +@example > > +$ qemu-system-x86_64 \ > > +-net user \ > > +-net nic,model=virtio \ > > +-enable-kvm \ > > +-m 256 \ > > +/tmp/qemu-image > > +@end example > > I think it would be nicer to put it on 3 lines. Done. [...] > I would typeset it as: > > @table @code > @item qemu-system-x86_64 > This specifies the hardware platform to… > > @item -net user > Enable unpriviliged user-mode networking… > … > > @end @table > > With all this, it’s going to look perfect! :-) Thank you for this example. I really need to study what Texinfo can do. > > Another question that people often ask is how to install GuixSD from the > installation image in a VM. Maybe that could be added eventually in a > subsection of this new node? I agree, that would be useful. If anybody knows how to do that, they should chime in. > > Thank you! Thanks for your helpful feedback! > > Ludo’.