From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([2001:4830:134:3::10]:58536) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eEIWj-0006zP-NT for guix-patches@gnu.org; Mon, 13 Nov 2017 12:28:06 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eEIWg-000326-DN for guix-patches@gnu.org; Mon, 13 Nov 2017 12:28:05 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:58332) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1eEIWg-00031s-8l for guix-patches@gnu.org; Mon, 13 Nov 2017 12:28:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1eEIWg-0002ni-0a for guix-patches@gnu.org; Mon, 13 Nov 2017 12:28:02 -0500 Subject: [bug#29271] [PATCH 1/1] doc: Split the "Substitutes" section into subsections. Resent-Message-ID: From: myglc2 References: <20171112110233.1384-1-cmmarusich@gmail.com> <20171112110558.1447-1-cmmarusich@gmail.com> Date: Mon, 13 Nov 2017 12:27:32 -0500 In-Reply-To: <20171112110558.1447-1-cmmarusich@gmail.com> (Chris Marusich's message of "Sun, 12 Nov 2017 03:05:58 -0800") Message-ID: <86tvxynl6j.fsf@gmail.com> MIME-Version: 1.0 Content-Type: text/plain 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: Chris Marusich Cc: 29271@debbugs.gnu.org Chris, I installed the patch and read the sections. This is great stuff. In addition to the minor suggestion in a sub-thread, how about replacing... > +When substitutes are enabled and a substitute for a derivation is > +available, but the substitution attempt fails, Guix will attempt to > +build the derivation locally depending on whether or not > +@code{--fallback} was given (@pxref{fallback-option}). Specifically, if > +@code{--fallback} was omitted, then no local build will be performed, > +and the derivation is considered to have failed. However, if > +@code{--fallback} was given, then Guix will attempt to build the > +derivation locally, and the success or failure of the derivation depends > +on the success or failure of the local build. Note that when ... with... When substitutes are enabled and a substitute for a derivation is available, but the substitution attempt fails, Guix will report an error unless the @code{--fallback} was given (@pxref{fallback-option}), in which case Guix will attempt to build the derivation locally Note that when HTH - George