From mboxrd@z Thu Jan 1 00:00:00 1970 From: julien lepiller Subject: Re: The usability of Guix configurations Date: Tue, 07 Nov 2017 12:05:12 +0100 Message-ID: <779b1b6f2043e03a2f911981142e7740@lepiller.eu> References: <868tfjw4is.fsf@gmail.com> <20171106221621.GA2534@jasmine.lan> <86o9oex34v.fsf@gmail.com> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=_83e6df3d9fb1b456f3d576a86158253b" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:51893) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1eC26p-0003OS-7g for guix-devel@gnu.org; Tue, 07 Nov 2017 06:32:03 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1eC26l-0005sj-Vo for guix-devel@gnu.org; Tue, 07 Nov 2017 06:31:59 -0500 Received: from lepiller.eu ([2a00:5884:8208::1]:36770) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1eC26l-0005rf-Le for guix-devel@gnu.org; Tue, 07 Nov 2017 06:31:55 -0500 Received: from webmail.lepiller.eu (static-176-182-42-79.ncc.abo.bbox.fr [176.182.42.79]) by lepiller.eu (OpenSMTPD) with ESMTPSA id c2fe9ad0 (TLSv1.2:ECDHE-RSA-AES128-GCM-SHA256:128:NO) for ; Tue, 7 Nov 2017 11:07:02 +0000 (UTC) In-Reply-To: <86o9oex34v.fsf@gmail.com> 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 --=_83e6df3d9fb1b456f3d576a86158253b Content-Transfer-Encoding: 8bit Content-Type: text/plain; charset=UTF-8; format=flowed Le 2017-11-07 02:56, myglc2 a écrit : > Please note: these replies are separated by topics in an effort to make > the > threads more topical ... > > On 11/06/2017 at 17:16 Leo Famulari writes: > >> On Mon, Nov 06, 2017 at 03:12:11PM -0500, myglc2 wrote: > [...] >>> Guix config errors are reported as raw scheme errors which are not >>> user-friendly, except, perhaps, to guile users ;-) Could we improve >>> this >>> situation by adding config troubleshooting guidance to the doc? >> >> Yes, we do try to add helpful error messages, although obviously there >> is a lot more work to be done. > > I didn't mean this point critically. Rather as a statement of fact. > When > I said ... > >>> Could we improve this situation by adding config troubleshooting >>> guidance to the doc? > > ... I was thinking something like ... > > vvvvvvvvvvvvvvvvvv > > Troubleshooting your config file: > > If you get an error like: > > ice-9/boot-9.scm:[...] no code for module (gnu packages ) > > You have either specified a package name that does not exist, or your > (use-package-modules ) does not contain the name > of a package module that contains the definition of . > > You can determine which, if any, module contains a package definition > by > yada yada yada > > ^^^^^^^^^^^^^^^^^^ > > ... thinking that then there would be a search hit in the doc for 'no > code for module' which might enable some users to understand what they > are doing wrong. > > WDYT? - George Hi George, Since we encourage users to use use-package-modules etc, I think it's better to catch this error and explain it to users as soon as it happens. It's more friendly for users than a troubleshooting section in the manual. This patch would print: Package module "abc" does not exist. ERROR: In procedure scm-error: ERROR: check "use-package-modules" line in your configuration. If you try to use something like (use-package-modules linux abc), and similar messages for services and system modules. WDYT? --=_83e6df3d9fb1b456f3d576a86158253b Content-Transfer-Encoding: base64 Content-Type: text/x-diff; name=0001-Catch-use-modules-errors-in-configuration.patch Content-Disposition: attachment; filename=0001-Catch-use-modules-errors-in-configuration.patch; size=1843 RnJvbSBjNDdhY2YwNTA4MzU4ZmYxNjA3MTlmNzI4ODQ0YTgyYTVkYjA3ZDA1IE1vbiBTZXAgMTcg MDA6MDA6MDAgMjAwMQpGcm9tOiBKdWxpZW4gTGVwaWxsZXIgPGp1bGllbkBsZXBpbGxlci5ldT4K RGF0ZTogVHVlLCA3IE5vdiAyMDE3IDExOjQ2OjM0ICswMTAwClN1YmplY3Q6IFtQQVRDSF0gQ2F0 Y2ggdXNlLW1vZHVsZXMgZXJyb3JzIGluIGNvbmZpZ3VyYXRpb24uCgoqIGdudS5zY20gKHVzZS1w YWNrYWdlLW1vZHVsZXMsIHVzZS1zZXJ2aWNlLW1vZHVsZXMsIHVzZS1zeXN0ZW0tbW9kdWxlcyk6 CkNhdGNoIHVzZS1tb2R1bGVzIGVycm9ycyBhbmQgc2hvdyBhIHNtYWxsIGV4cGxhbmF0aW9uIGFi b3V0IGl0LgotLS0KIGdudS5zY20gfCAyNiArKysrKysrKysrKysrKysrKysrKysrKy0tLQogMSBm aWxlIGNoYW5nZWQsIDIzIGluc2VydGlvbnMoKyksIDMgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0 IGEvZ251LnNjbSBiL2dudS5zY20KaW5kZXggOTEzY2U2MTYwLi5jMjY5YjJhYjAgMTAwNjQ0Ci0t LSBhL2dudS5zY20KKysrIGIvZ251LnNjbQpAQCAtNTMsMTIgKzUzLDMyIEBACiAgICAgICAgICAg ICAgICVwdWJsaWMtbW9kdWxlcykpKQogCiAoZGVmaW5lLXN5bnRheC1ydWxlICh1c2UtcGFja2Fn ZS1tb2R1bGVzIG1vZHVsZSAuLi4pCi0gICh1c2UtbW9kdWxlcyAoZ251IHBhY2thZ2VzIG1vZHVs ZSkgLi4uKSkKKyAgKGJlZ2luCisgICAgKGNhdGNoICN0IChsYW1iZGEgKCkgKHVzZS1tb2R1bGVz IChnbnUgcGFja2FnZXMgbW9kdWxlKSkpCisgICAgICAgICAgIChsYW1iZGEgXworICAgICAgICAg ICAgIChmb3JtYXQgI3QgIlBhY2thZ2UgbW9kdWxlIFwifmFcIiBkb2VzIG5vdCBleGlzdC5cbiIK KyAgICAgICAgICAgICAgICAgICAgIChzeW1ib2wtPnN0cmluZyAnbW9kdWxlKSkKKyAgICAgICAg ICAgICAoZXJyb3IgImNoZWNrIFwidXNlLXBhY2thZ2UtbW9kdWxlc1wiIGxpbmUgaW4geW91ciBj b25maWd1cmF0aW9uLiIpCisgICAgLi4uKSkpKQogCiAoZGVmaW5lLXN5bnRheC1ydWxlICh1c2Ut c2VydmljZS1tb2R1bGVzIG1vZHVsZSAuLi4pCi0gICh1c2UtbW9kdWxlcyAoZ251IHNlcnZpY2Vz IG1vZHVsZSkgLi4uKSkKKyAgKGJlZ2luCisgICAgKGNhdGNoICN0IChsYW1iZGEgKCkgKHVzZS1t b2R1bGVzIChnbnUgc2VydmljZXMgbW9kdWxlKSkpCisgICAgICAgICAgIChsYW1iZGEgXworICAg ICAgICAgICAgIChmb3JtYXQgI3QgIlNlcnZpY2UgbW9kdWxlIFwifmFcIiBkb2VzIG5vdCBleGlz dC5cbiIKKyAgICAgICAgICAgICAgICAgICAgIChzeW1ib2wtPnN0cmluZyAnbW9kdWxlKSkKKyAg ICAgICAgICAgICAoZXJyb3IgImNoZWNrIFwidXNlLXBhY2thZ2Utc2VydmljZXNcIiBsaW5lIGlu IHlvdXIgY29uZmlndXJhdGlvbi4iKQorICAgIC4uLikpKSkKKwogCiAoZGVmaW5lLXN5bnRheC1y dWxlICh1c2Utc3lzdGVtLW1vZHVsZXMgbW9kdWxlIC4uLikKLSAgKHVzZS1tb2R1bGVzIChnbnUg c3lzdGVtIG1vZHVsZSkgLi4uKSkKKyAgKGJlZ2luCisgICAgKGNhdGNoICN0IChsYW1iZGEgKCkg KHVzZS1tb2R1bGVzIChnbnUgc3lzdGVtIG1vZHVsZSkpKQorICAgICAgICAgICAobGFtYmRhIF8K KyAgICAgICAgICAgICAoZm9ybWF0ICN0ICJTeXN0ZW0gbW9kdWxlIFwifmFcIiBkb2VzIG5vdCBl eGlzdC5cbiIKKyAgICAgICAgICAgICAgICAgICAgIChzeW1ib2wtPnN0cmluZyAnbW9kdWxlKSkK KyAgICAgICAgICAgICAoZXJyb3IgImNoZWNrIFwidXNlLXN5c3RlbS1tb2R1bGVzXCIgbGluZSBp biB5b3VyIGNvbmZpZ3VyYXRpb24uIikKKyAgICAuLi4pKSkpCisKIAogOzs7IGdudS5zY20gZW5k cyBoZXJlCi0tIAoyLjE1LjAKCg== --=_83e6df3d9fb1b456f3d576a86158253b--