From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id IEQkHQBe7WD6WgAAgWs5BA (envelope-from ) for ; Tue, 13 Jul 2021 11:33:52 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id EKP8GABe7WDtfwAAB5/wlQ (envelope-from ) for ; Tue, 13 Jul 2021 09:33:52 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D99862186A for ; Tue, 13 Jul 2021 11:33:51 +0200 (CEST) Received: from localhost ([::1]:38648 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m3EnW-0007pb-Cp for larch@yhetil.org; Tue, 13 Jul 2021 05:33:50 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53126) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m3Emk-00058q-TV for guix-patches@gnu.org; Tue, 13 Jul 2021 05:33:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:56153) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1m3Emk-0002MZ-Ie for guix-patches@gnu.org; Tue, 13 Jul 2021 05:33:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1m3Emk-0007Ls-CR for guix-patches@gnu.org; Tue, 13 Jul 2021 05:33:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#43361] [PATCH] doc: Mention config.scm in reconfigure description Resent-From: zimoun Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 13 Jul 2021 09:33:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 43361 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: Julien Lepiller , 43361@debbugs.gnu.org Received: via spool by 43361-submit@debbugs.gnu.org id=B43361.162616874128186 (code B ref 43361); Tue, 13 Jul 2021 09:33:02 +0000 Received: (at 43361) by debbugs.gnu.org; 13 Jul 2021 09:32:21 +0000 Received: from localhost ([127.0.0.1]:39465 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m3Em4-0007KY-QT for submit@debbugs.gnu.org; Tue, 13 Jul 2021 05:32:21 -0400 Received: from mail-wr1-f44.google.com ([209.85.221.44]:41506) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1m3Elz-0007K1-Jw for 43361@debbugs.gnu.org; Tue, 13 Jul 2021 05:32:18 -0400 Received: by mail-wr1-f44.google.com with SMTP id k4so23259374wrc.8 for <43361@debbugs.gnu.org>; Tue, 13 Jul 2021 02:32:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=iX/jjXbMIR2R2LiqwXKyYkOHtMR20TaV0URsYOce68U=; b=cBXa/6/M7bNUHQvkPwODFW+hJsiGY5pnJoL0TcNEGF9Brzs5eg4a6IOket/sTJw8pE IZsZZhAdAWBaDotKEc63QJnDMBwpPJN5wqwAMF7U7Eu2p1F49ev71dcWLK1jnbXN7D8E sn+MRXqiER2AEMvN97EMVAGr4OsC21zFROSDi5K69/O+Jx6QlreSIQsTJf7FvTpIR6P3 n9rY2ksGawQzqTP0eF7FbD0ZsE2IpdUzO/4JUvBALUxsqcsKuNlUngQYI9hmeJXn3IJ4 vbCK/nb291wBaSF+367ECD+xg7fhhXa4iOuxo79SHVDn0I6790xTmVJ0v1Z7T+Pkg7Ho zrDw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=iX/jjXbMIR2R2LiqwXKyYkOHtMR20TaV0URsYOce68U=; b=bAPUmrj7e3IdWLvoGZU6gTeILgDFKas2qAcsdp/BmVtpl+p3Pacb06bR2dreQlFJE8 xYWBMT2+rieOs3/haR93GsPUiL58m6hMLUhlgAm/PJWuKbinQKO/MfWQBq/g5dVXlxJC j1MoffDf33th/MIGhDVvtnrh8cyU6PbOLPCR+qzlRt6nILT+QNDYoxxv+uyjIFrdl/hc M+K3wk/J9vIhyl00HDW/4NBbz6g8z/k8YdVYT3jhGtDQxtf3A05ASbXOrItYOKGYNJ/3 B3MLMuN11mzX6ZfkLcy6r1x0Q1pt++MbAevucRr2e75T6TEmIGLlO1tj+4Kd5qUqm8OZ +PYg== X-Gm-Message-State: AOAM530bv2km9CiLWEjU5DqhbyXo3YipDn+x2PbZ4Q/UpEwPwVEpUq5O kpnoZkUumqF6fmG3VcQ3m2uhwD5g1A4= X-Google-Smtp-Source: ABdhPJyCuJVCgbtgQYtUEW20jlx8kcID0Eg+T2ZPTn5K1xVsQ1FoCVElKVGuxiTTxYd1ME381oNQ8g== X-Received: by 2002:adf:edd1:: with SMTP id v17mr4294495wro.276.1626168729669; Tue, 13 Jul 2021 02:32:09 -0700 (PDT) Received: from lili ([2a01:e0a:59b:9120:65d2:2476:f637:db1e]) by smtp.gmail.com with ESMTPSA id v2sm7228697wro.48.2021.07.13.02.32.08 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 13 Jul 2021 02:32:09 -0700 (PDT) From: zimoun References: <20200912214852.42e4d123@tachikoma.lepiller.eu> <87tuw19yd5.fsf@gnu.org> <0406FDEA-9602-4DD6-AF4B-4A259DBD82EA@lepiller.eu> <87tuw0q0pw.fsf@gnu.org> Date: Tue, 13 Jul 2021 11:02:19 +0200 In-Reply-To: <87tuw0q0pw.fsf@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Mon, 14 Sep 2020 09:25:15 +0200") Message-ID: <86tukyoack.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.1 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1626168832; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=iX/jjXbMIR2R2LiqwXKyYkOHtMR20TaV0URsYOce68U=; b=uu68z/U0d5GHQ3jvqFBDf9RqC+iood6QJcfNNbSKvaJWMq7LQoe3OOjmD6DISDFKF1tS34 4w45HyCahL0HA/pU3tzbjfQKQ5GKPVG21snbXPGWRS8WIIcFSQ1CLjBjfiNDOsXQscIf7r o2teyKiVpPn1d0qNABk0WSvh4SKSJl4WmEeoQZbuyzeh46uCbIiyYRCsCp1oMheWeZrHi/ dF+F/5vPx2KrgDkAI05olf1CQaFx6pUIz8Wl3ztOJqLnvlIGCoiSShu127aVcBUDUqgZ+n rHrw/izY3CQmMcdCG0JsYuQDfyjH5g47sNTudttfl2HbtKXPsSN3GCrJdRmueQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1626168832; a=rsa-sha256; cv=none; b=IcP5WoYPajv+RE45ZPSkD+8N7v8KGaGmAHe6QUpoPPqbNCdnlAIfmVoq25kLT6EjHH2DzN DezbhGXk03ZZM6HoMqgUvzRjM5YvgUlRp3r/YQUaxm5cbSC+S5MFbaEhGnQRClwk4i8PCr Hlx/qYj2Qnni8vcq0fKtzV+VftWoLDt2IQAXEByKuxYyxFxxZqoVEtBQEJJSi8lUUd9Y7f Q6OnRwGKYSs91BoKPC2XJ1HNMSvKj7kxgQ9gMmcObSgbihWtCxf1Dxri9qOukanbADrT7z petX/dqR6+Qf8pSdtRxwdu33WsRg5v132Kjey7iWsrS5OHA7aMuxmfA17EhKlw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b="cBXa/6/M"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Spam-Score: -1.30 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20161025 header.b="cBXa/6/M"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Migadu-Queue-Id: D99862186A X-Spam-Score: -1.30 X-Migadu-Scanner: scn0.migadu.com X-TUID: sxlq6oKlPKWn Hi, This patch [1] is about a tiny tweak of the doc to add a mention of /etc/config.scm. I do not know if the consensus is reached. 1: On Mon, 14 Sep 2020 at 09:25, Ludovic Court=C3=A8s wrote: > Julien Lepiller skribis: >> Le 13 septembre 2020 17:10:30 GMT-04:00, "Ludovic Court=C3=A8s" a >> =C3=A9crit : >>>Julien Lepiller skribis: >>> >>>> this patch is a small change to the manual that should help at least >>>> one confused user from >>>> >>>https://unix.stackexchange.com/questions/550597/what-is-the-file-to-be-s= pecified-in-guix-system-reconfigure >>>> >>>>>>>From dfa9439efbf1de7ffe281dac330a19c1e369e5d8 Mon Sep 17 00:00:00 >>>2001 >>>> From: Julien Lepiller >>>> Date: Sat, 12 Sep 2020 21:46:57 +0200 >>>> Subject: [PATCH] doc: Mention config.scm in reconfigure description >>>> >>>> * doc/guix.texi (Invoking guix system): Mention `/etc/config.scm' in >>>the >>>> description of guix system reconfigure. >>>> --- >>>> doc/guix.texi | 8 ++++---- >>>> 1 file changed, 4 insertions(+), 4 deletions(-) >>>> >>>> diff --git a/doc/guix.texi b/doc/guix.texi >>>> index a6e14ea177..c10387441e 100644 >>>> --- a/doc/guix.texi >>>> +++ b/doc/guix.texi >>>> @@ -28919,10 +28919,10 @@ As for @command{guix package --search}, the >>>result is written in >>>> (@pxref{Top, GNU recutils databases,, recutils, GNU recutils >>>manual}). >>>> >>>> @item reconfigure >>>> -Build the operating system described in @var{file}, activate it, and >>>> -switch to it@footnote{This action (and the related actions >>>> -@code{switch-generation} and @code{roll-back}) are usable only on >>>> -systems already running Guix System.}. >>>> +Build the operating system described in @var{file} (typically >>>> +@file{/etc/config.scm}), activate it, and switch to it@footnote{This >>>action >>>> +(and the related actions @code{switch-generation} and >>>@code{roll-back}) are >>>> +usable only on systems already running Guix System.}. >>> >>>Perhaps =E2=80=9C(typically @file{/etc/config.scm})=E2=80=9D should go n= ext to >>>=E2=80=9C@var{file} must be =E2=80=A6=E2=80=9D? >>> >>>But if the person doesn=E2=80=99t read more than a few lines of the page= , it >>>won=E2=80=99t help. >>> >>>I was thinking we could have =E2=80=9Cguix system reconfigure=E2=80=9D w= ithout >>>arguments >>>pick up /run/current-system/configuration.scm. Perhaps that=E2=80=99d h= elp? >> >> I think it would be even more confusing, because that file isn't even >> editable. So you'de get users thinking they must re-install the distro to >> change that file. > > I mean you could still pass a file as an argument, but if you don=E2=80= =99t, > it=E2=80=99d pick that one. > >> Others would eventually find /etc/config.scm and not pass it as argument, >> then get their system reconfigured to something different than what they >> specified. >> >> Maybe it should be "e.g. /etc/config, initially generated by the graphic= al >> installer" or something? > > I think =E2=80=9Ctypically /etc/config.scm=E2=80=9D is enough (and more a= ccurate), > dunno. Personally, I find both equal. Maybe it is worth the apply the patch. Since it is the doc, if it appears unclear from feedback, let then improve. WDYT? Cheers, simon