From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:55846) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eDq3b-0000XK-RC for guix-patches@gnu.org; Sun, 12 Nov 2017 06:04:08 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eDq3W-000631-Vo for guix-patches@gnu.org; Sun, 12 Nov 2017 06:04:07 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:55593) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eDq3W-00062w-Rv for guix-patches@gnu.org; Sun, 12 Nov 2017 06:04:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eDq3W-0003BF-IA for guix-patches@gnu.org; Sun, 12 Nov 2017 06:04:02 -0500 Subject: [bug#29271] [PATCH 0/1] Improve the "Substitutes" documentation Resent-Message-ID: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55672) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eDq2X-0000VA-ND for guix-patches@gnu.org; Sun, 12 Nov 2017 06:03:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eDq2S-0005cD-TO for guix-patches@gnu.org; Sun, 12 Nov 2017 06:03:01 -0500 Received: from mail-pf0-x22a.google.com ([2607:f8b0:400e:c00::22a]:53617) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eDq2S-0005bd-Mp for guix-patches@gnu.org; Sun, 12 Nov 2017 06:02:56 -0500 Received: by mail-pf0-x22a.google.com with SMTP id b6so9607683pff.10 for ; Sun, 12 Nov 2017 03:02:56 -0800 (PST) From: Chris Marusich Date: Sun, 12 Nov 2017 03:02:33 -0800 Message-Id: <20171112110233.1384-1-cmmarusich@gmail.com> List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org Sender: "Guix-patches" To: 29271@debbugs.gnu.org Cc: myglc2@gmail.com, Chris Marusich Hi Guix, Attached is a patch which attempts to improve the clarity of the Substitutes section by moving its content into subsections. I have also taken the liberty of adding some new information, which should clarify (1) the question of whether or not substitutes are enabled by default, and (2) the --fallback option. The following email thread demonstrates that this information was not clear enough, so hopefully it is clear enough now: https://lists.gnu.org/archive/html/help-guix/2017-11/msg00032.html Best regards, Chris Marusich (1): doc: Split the "Substitutes" section into subsections. doc/guix.texi | 126 +++++++++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 94 insertions(+), 32 deletions(-) -- 2.14.2