From mboxrd@z Thu Jan 1 00:00:00 1970 From: Leo Famulari Subject: [PATCH 0/2] Clarify VM installation instructions Date: Fri, 27 Jan 2017 05:38:45 -0500 Message-ID: Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:48656) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1cX3vj-0002rv-K5 for guix-devel@gnu.org; Fri, 27 Jan 2017 05:38:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1cX3vg-0003Eh-JM for guix-devel@gnu.org; Fri, 27 Jan 2017 05:38:55 -0500 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:49549) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1cX3vg-0003ER-Cm for guix-devel@gnu.org; Fri, 27 Jan 2017 05:38:52 -0500 Received: from localhost.localdomain (c-73-188-17-148.hsd1.pa.comcast.net [73.188.17.148]) by mail.messagingengine.com (Postfix) with ESMTPA id 38E382458C for ; Fri, 27 Jan 2017 05:38:51 -0500 (EST) 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" To: guix-devel@gnu.org There is a subtle confuser in the instructions about installing GuixSD in a VM. I missed it the first time it was pointed out to me, because I already knew how to install GuixSD. But if you begin with Guix by installing GuixSD in a VM, this might waste a few minutes of your time. The instructions start with "First, retrieve the GuixSD installation image as described previously (see USB Stick Installation)." [0] You go to USB Stick Installation, where it explains how to download the image file and check the signature. [1] It continues to explain how to put it on a USB stick, but you aren't doing that, so you go back to the VM installation instructions and try booting the xz-compressed tarball. The reader has not read the part about decompressing the tarball, because that is under "To copy the image to a USB stick, follow these steps[...]" I've helped one person who made this mistake, and I can see how you'd make it if you were a beginner. [0] https://www.gnu.org/software/guix/manual/html_node/Installing-GuixSD-in-a-VM.html [1] https://www.gnu.org/software/guix/manual/html_node/USB-Stick-Installation.html Leo Famulari (1): doc: Clarify "Installing GuixSD in a VM". doc/guix.texi | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) -- 2.11.0