GNU bug report logs - #31786
'pre-inst-env guix --version' is not updated by new commits"

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: guix; Reported by: George Clemmer <myglc2@HIDDEN>; dated Mon, 11 Jun 2018 18:02:02 UTC; Maintainer for guix is bug-guix@HIDDEN.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 19 Jun 2018 16:47:49 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 19 12:47:49 2018
Received: from localhost ([127.0.0.1]:56618 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fVJnJ-0004ze-HR
	for submit <at> debbugs.gnu.org; Tue, 19 Jun 2018 12:47:49 -0400
Received: from mail-qt0-f170.google.com ([209.85.216.170]:45520)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fVJnH-0004zP-Es
 for 31786 <at> debbugs.gnu.org; Tue, 19 Jun 2018 12:47:47 -0400
Received: by mail-qt0-f170.google.com with SMTP id i18-v6so318198qtp.12
 for <31786 <at> debbugs.gnu.org>; Tue, 19 Jun 2018 09:47:47 -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=B+u3rhAN/yJL4uta3pY3wybnqLjPaPCac5ECYQGMsxU=;
 b=f4jf1ssgbnKaWsuAxIqk009EiD0yLLbkUmPFkBV5uGXPnf1v9G/r+tLdhjWmTNewnT
 RsZd+nOrX04nwcxR5+vnqQvtUGzCpjkeJTrd+l32PYYzC5rUcsIGg/TAkIKGBMEYj3ct
 MlrA2o1Zl+DwSiSkr8+ffpBVu1wGl4J7gPEvYI8lGSHmpp2FAlS8DLXcfFngtKC2D3Rs
 7VCzXucBvHVwyhhglFm4LN2t3JZuqkjxZ2W/PjnnMh4PXCpcjG7VHNU+ZCF/aGdwrvTO
 I449aTapBicebc7ZdN2MDV+T5m/KtNeT43pQcg8p0fjbpO7rtLt0kD/PBuul0IwrGHNJ
 jhUw==
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=B+u3rhAN/yJL4uta3pY3wybnqLjPaPCac5ECYQGMsxU=;
 b=aynIXIeTDUg2k8XD94KhYHP0gY0vmKoeJJYGsmYYcj9VyN9n7E/TAFC2mEcirOGTWy
 8ShuxFX3ay2wu8OGTaXEoFWTMuPR+Hr7Hs7iB+U6JnU5xCk4cyYSOfZpbejM3LRaS4B4
 99D6aq2//Vg1A0BxV3L+UbYZgUekfdieIW1CZi8cyRuE7+hkD1V2zLmV6VVu4NQO6RfH
 i6Lt8GMAknTo/YrmobCBV5AWTa1BapRufT1EtWrK5I7Ci6+HcTvUXvl9Xbjd1aYehfvk
 POQ2oGhseXOYr+l5eiHT/LfHMS9mMyzAziAShd+UIzuf/Gj418TkAEadwAawTiU+UVLc
 5T0w==
X-Gm-Message-State: APt69E2S9VJXAnEA2JfzbWJiI86XF0O70jp5ZZ9gcFdHKBqC6SyC7WUS
 P/5cVpzU6bVyduxYZHYxyoM=
X-Google-Smtp-Source: ADUXVKIW38BfzshvmRMStUhqUO8pN2N/bD8T8I5riqrAo1H/TJH+ujlwwthbEoB9PxXLLEZhgokvLQ==
X-Received: by 2002:ac8:2238:: with SMTP id
 o53-v6mr15840409qto.355.1529426861694; 
 Tue, 19 Jun 2018 09:47:41 -0700 (PDT)
Received: from g1 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id t6-v6sm64499qtn.86.2018.06.19.09.47.40
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Tue, 19 Jun 2018 09:47:40 -0700 (PDT)
From: myglc2@HIDDEN
X-Google-Original-From: g1@HIDDEN
To: Ricardo Wurmus <rekado@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
 <87po0r674z.fsf@HIDDEN> <87o9gb663j.fsf@HIDDEN>
Date: Tue, 19 Jun 2018 12:47:39 -0400
In-Reply-To: <87o9gb663j.fsf@HIDDEN> (Ricardo Wurmus's message of "Sat,
 16 Jun 2018 00:24:32 +0200")
Message-ID: <87wouuzpsk.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.3 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>,
 George Clemmer <myglc2@HIDDEN>,
 =?utf-8?Q?Cl=C3=A9ment?= Lassieur <clement@HIDDEN>,
 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.7 (/)

On 06/16/2018 at 00:24 Ricardo Wurmus writes:

> Ricardo Wurmus <rekado@HIDDEN> writes:
>
>>> Proposed (revised) footnote:
>>>
>>> (3) The Guix version in the Guix build is set by './bootstrap'. Thus,
>>> the version reported by './pre-inst-env guix --version' is not updated
>>> by subsequent 'git pull; make' steps. To update the version (and rebuild
>>> everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.
>>
>> I=E2=80=99m wary of adding this for similar reasons that Ludo wrote earl=
ier.  In
>> my opinion this ends up cluttering the manual with notes and what I
>> consider to be only tangentially relevant for readers of the manual.
>
> An alternative might be to change the output of =E2=80=9Cguix --version=
=E2=80=9D in the
> presence of GUIX_UNINSTALLED, which is set by =E2=80=9Cpre-inst-env=E2=80=
=9D.  This
> could be a simple change in =E2=80=9Cshow-version-and-exit=E2=80=9D that =
would use
> something other than =E2=80=9C%guix-version=E2=80=9D when GUIX_UNINSTALLE=
D is set.
>
> What do others think?
>
> --
> Ricardo

I like it.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 19 Jun 2018 14:14:55 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 19 10:14:55 2018
Received: from localhost ([127.0.0.1]:56576 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fVHPL-0001Mw-DM
	for submit <at> debbugs.gnu.org; Tue, 19 Jun 2018 10:14:55 -0400
Received: from sender-of-o51.zoho.com ([135.84.80.216]:21131)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <rekado@HIDDEN>) id 1fVHPJ-0001Mn-RT
 for 31786 <at> debbugs.gnu.org; Tue, 19 Jun 2018 10:14:54 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1529101481; 
 s=zoho; d=elephly.net; i=rekado@HIDDEN;
 h=References:From:To:Cc:Subject:In-reply-to:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding;
 l=1010; bh=Mxz1aVrrwsXuCwkK3OxpkQbCqJnb8eqkAZXb7xkkg9M=;
 b=PLB9DtdzhJ+ZSTZU1oKXN9RNresXIllmL8Q3FViaYfoaKu0t5Tx5j1ZxcWAXOkSq
 3RfF4p44KMZS8jX3IuBCP2602le2lp7/P6V05esi082mkc7HzMQ8MaNFEqE8XWvZiM+
 4KN750Zf/tUthnePWGBWYx/hT98WwU6go7v1MoY4=
Received: from localhost (port-92-200-143-154.dynamic.qsc.de [92.200.143.154])
 by mx.zohomail.com with SMTPS id 1529101481722211.30734992098905;
 Fri, 15 Jun 2018 15:24:41 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
 <87po0r674z.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: Ricardo Wurmus <rekado@HIDDEN>
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87po0r674z.fsf@HIDDEN>
X-URL: https://elephly.net
X-PGP-Key: https://elephly.net/rekado.pubkey
X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6  2150 197A 5888 235F ACAC
Date: Sat, 16 Jun 2018 00:24:32 +0200
Message-ID: <87o9gb663j.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-ZohoMailClient: External
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org,
 =?utf-8?Q?Cl=C3=A9men?= =?utf-8?Q?t?= Lassieur <clement@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)


Ricardo Wurmus <rekado@HIDDEN> writes:

>> Proposed (revised) footnote:
>>
>> (3) The Guix version in the Guix build is set by './bootstrap'. Thus,
>> the version reported by './pre-inst-env guix --version' is not updated
>> by subsequent 'git pull; make' steps. To update the version (and rebuild
>> everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.
>
> I=E2=80=99m wary of adding this for similar reasons that Ludo wrote earli=
er.  In
> my opinion this ends up cluttering the manual with notes and what I
> consider to be only tangentially relevant for readers of the manual.

An alternative might be to change the output of =E2=80=9Cguix --version=E2=
=80=9D in the
presence of GUIX_UNINSTALLED, which is set by =E2=80=9Cpre-inst-env=E2=80=
=9D.  This
could be a simple change in =E2=80=9Cshow-version-and-exit=E2=80=9D that wo=
uld use
something other than =E2=80=9C%guix-version=E2=80=9D when GUIX_UNINSTALLED =
is set.

What do others think?

--
Ricardo





Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 16 Jun 2018 16:06:44 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jun 16 12:06:44 2018
Received: from localhost ([127.0.0.1]:51862 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fUDiu-0005hv-Ja
	for submit <at> debbugs.gnu.org; Sat, 16 Jun 2018 12:06:44 -0400
Received: from mail-qk0-f180.google.com ([209.85.220.180]:45165)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fUDiq-0005hg-UZ
 for 31786 <at> debbugs.gnu.org; Sat, 16 Jun 2018 12:06:41 -0400
Received: by mail-qk0-f180.google.com with SMTP id c198-v6so7279748qkg.12
 for <31786 <at> debbugs.gnu.org>; Sat, 16 Jun 2018 09:06:40 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version;
 bh=h+D+lPnBxVv/xQPzx6qazc1p/dtpfkMP2Dc0BmVYXEk=;
 b=lyAw8xntGIoQ/hgcSOnmeK6Vk/aJQt9BkBig2njx+wla9/R6PUObD5AzLyrdWWn0NN
 6+LQcCrEYu41D1GXgYmeGnLxsfeUM+tk7IblknRv9tRqVICp2OqFTdXPkFB4kYywK6gq
 +gqR2jf8O9zzogyOY8mvLCbP+Fmyx8cd2oBYI1o+Oiyx1aiR7WfYjTZUcl4ZbzK8mtW0
 YGaNZpuJ2Q+i0RTSsZ67TeV5D9564K2Qow3E+BSDMbN6QtuaTK4ZG1vjn3e1DUu1D24l
 c1tJXpGpnZS73/q236fPgPt3D8BaOvN7piegYKlYiMqx1Hb8byhK+u2xCgJaifFC8nmh
 lpvw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version;
 bh=h+D+lPnBxVv/xQPzx6qazc1p/dtpfkMP2Dc0BmVYXEk=;
 b=XCMPR/dvTsBhWU321UFWX5VxBolB0Lia+NW3BQXPJfUBqOpXePL4ngKhAnXLi+dc0E
 ZHvf9GPv4hdV0n2hfErIAe7ZrB6953rk0GuVIycFh2Elj3cZb7yd6zZR4Cqls8I0T2M1
 g6xxYARkHLF7fq048jvnpNRQjf5QZd2DCN9XqPatyUOPSkO0jlVNW8YRVa2rkOpV3HAB
 tgXhJvwmk2ccSYMfdnquIRSjeYKKaJICQqMPjNQC2xHr2/cUS4qot6i7G+9goaCKhP39
 lCA64SK301m6LSgx/YsTlZoJml45cJSIGKItYNoWth4eVR4ZGJUSxr5QOnJDm6ETuYz8
 eWUg==
X-Gm-Message-State: APt69E1hddGc4lTViZH8nB97Il8H6fUtkThX4+PoHA2hymyhSsHT8K0Y
 TWLs0XhVhi9Ka+qjPlcARloAOdCu
X-Google-Smtp-Source: ADUXVKI1wOZRxzn/mepGNK6vSEkaJD1teYUKgvFTvGs19qGDcjaWgKo9905wXKEtEaY/ttJd4Gf79A==
X-Received: by 2002:a37:8483:: with SMTP id
 g125-v6mr4801874qkd.392.1529165195319; 
 Sat, 16 Jun 2018 09:06:35 -0700 (PDT)
Received: from sysi33 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 w66-v6sm7009383qkc.86.2018.06.16.09.06.33
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Sat, 16 Jun 2018 09:06:34 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
 <20180615203018.clbx3kqjqfzcyink@abyayala>
User-agent: mu4e 1.0; emacs 26.1
From: George Clemmer <myglc2@HIDDEN>
To: Nils Gillmann <ng0@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <20180615203018.clbx3kqjqfzcyink@abyayala>
Date: Sat, 16 Jun 2018 12:06:33 -0400
Message-ID: <87k1qyaf7a.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Score: 0.3 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org,
 =?utf-8?Q?Cl=C3=A9men?= =?utf-8?Q?t?= Lassieur <clement@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.7 (/)

Hi Nils,

Nils Gillmann <ng0@HIDDEN> writes:
[...]
> Long text short nonsense: you end up with lots of work and long books if you
> do it right. It should be done this way. Maybe if not directly applied we
> could collect the proposals somewhere in the repository? I've recently
> started to strip out a whole chapter with repetive installation instructions
> in GNUnet. A while back I would've argued for keeping it, that we really
> need to cover and guide every case.
> Some projects have written "An introduction to..." books to lead up to
> the manual.
> In my opinion access to knowledge should be easy and without much 'rough
> edges' to get it.
> Do we keep it selfcontained? Reference other books? A middle path? It's
> difficult to get it right if you don't have the time to think about this
> as a fulltime job.
[...]
>
> Do we really have to assume that everyone has the same skilset who wants
> to get involved? Not about this topic, but in general? I think the assumption
> that we share the same knowledge is difficult. Part of the excercise is to
> reach out, actively, in person. Another part is to try and do it in text (be
> it on a website or a (new) chapter in a manual).
[...]
> Counter-proposal: What about additional man-pages? man has enough sections
> to provide well written, to the point, collection of notes for such day-to-day
> usage. I'm not against your proposal, just another suggestion in context of
> what I've written above.

I think the Guix strategy, AIUI, of putting 99.9% of the doc effort into
a single doc via Texinfo is very efficient. INFO and HTML reach the two
extreme user types: hackers that use INFO and people use that google.

Partitioning the problem into sub-parts is tempting.  But it increases
the risk of a sub-part drifting out of date at which point it is better
to not have had the sub-part ;-)

The Guix "mico-man-page" effectively eliminates a sub-part. Hackers can
use INFO and people who google don't use man, so I think the micro-man
approach is fine.

I think the most promising and productive way for Guix to improve the
end-user-friendliness of the doc is to use end-user "support incidents"
to drive doc additions. At the end of an incident the user question is
fresh in your mind, you have information that you know could have been
helpful to at least one user, and you capture the support effort into
something longer lasting.

- George




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 16 Jun 2018 01:35:39 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jun 15 21:35:39 2018
Received: from localhost ([127.0.0.1]:50754 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fU07u-0000Oj-V6
	for submit <at> debbugs.gnu.org; Fri, 15 Jun 2018 21:35:39 -0400
Received: from mail-qt0-f176.google.com ([209.85.216.176]:43965)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fU07t-0000OW-MN
 for 31786 <at> debbugs.gnu.org; Fri, 15 Jun 2018 21:35:37 -0400
Received: by mail-qt0-f176.google.com with SMTP id y89-v6so10736028qtd.10
 for <31786 <at> debbugs.gnu.org>; Fri, 15 Jun 2018 18:35:37 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version:content-transfer-encoding;
 bh=J6Mclo9L+fq4+iqkoPPNP4kzO+ywKhDmoKOvCtrOBO0=;
 b=RWXpGiZs4GB5adaKBc0VkC+Sv7TIBeK5DvRm+CyY2sjKANloAwIO4qs5Rf9/uxxEO7
 TLqAxm0oA7Ly7VACufqWNpnVCcr/clYBhqzGVJIHBaAdb6D+71Om75eDLJ4mbdMIhs5s
 89pZT3woKYX2OCcS5ob2mnBhzFWnODAVbctmXsUz5wtZ1tQiO2RjFROx72vQKBi1k/ni
 qNlUPUIdbt8ZN1Kq/s1Gulh/nyWA5tHAWaJ8ynfMVYtkGqijob/lPx/QrmiS9J9xeMYn
 fu6MBCj0xEJvI0XTIF2e3c9A4koK5hYuWjO3H28+hcFpes7GUSlUPW6IlPaL1jVP+vIp
 lcoA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version:content-transfer-encoding;
 bh=J6Mclo9L+fq4+iqkoPPNP4kzO+ywKhDmoKOvCtrOBO0=;
 b=Ghi6P+oVRQ6sB0aH7eA+R2JJMCcumF+mL5c5a7CZmGDOtJ2bsn+eX09neDSd5FNgvM
 4vQFYiJ5DsJyun2YK/7gcidTBg9w+/kn3cK4/fRsgSpsXH/9BvlqiEpVO+maOQ8THfca
 ttHVJJiqb4O3IW0EcJ1g0WhVXooC1PLCyz0qaLI8QfwUiYsn/yRcGqFyAa1maroQIfWV
 YSVo5tqrsKRp0K2HC+nNjPeDw6OV2eF/Z58LoDzpmOGPU1kLUeOyxLju7tzVXtnVFISf
 2hBQ8hkLCopF3aptZN7V2FmPoIRHTPtDCeXAh3TqwxRubV4QxmgRlIyk5/Mq9mGIDRju
 cA3Q==
X-Gm-Message-State: APt69E3GcMmkXNvz0ppZsrrpxNkK6/hWL5xsBxtnXxdS024Ubj6Bt0Dt
 v7B7GZZ9nZm9KEVCznBm2p+ig8yK
X-Google-Smtp-Source: ADUXVKJ7U6RUpWFTCJrH6QHRORT0IP2skDtBhVgwtdgSxQ/YHD7XeeNYYBNUkH1ccjNw2+3gfuEs3w==
X-Received: by 2002:a0c:e889:: with SMTP id
 b9-v6mr3566417qvo.106.1529112931945; 
 Fri, 15 Jun 2018 18:35:31 -0700 (PDT)
Received: from sysi33 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 k129-v6sm5639524qkd.13.2018.06.15.18.35.30
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Fri, 15 Jun 2018 18:35:30 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
 <87po0r674z.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: George Clemmer <myglc2@HIDDEN>
To: Ricardo Wurmus <rekado@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87po0r674z.fsf@HIDDEN>
Date: Fri, 15 Jun 2018 21:35:29 -0400
Message-ID: <87zhzvh5su.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.2 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org,
 =?utf-8?Q?Cl=C3=A9men?= =?utf-8?Q?t?= Lassieur <clement@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.8 (/)


Ricardo Wurmus <rekado@HIDDEN> writes:

> Hi George,
>
>> The current doc reflects the needs and sensibilities of the hackers,
>> maintainers, and sysops that have built Guix. These "elite" users have
>> different needs and judge what is important quite differently from end
>> users. This guarantees that the current doc is inadequate for end users.
>> So, if, as you say, you want to make Guix accessible to end users, you
>> need to make changes in the doc.  The questions: How? What?
> [=E2=80=A6]
>> I said: I use 'pre-inst-env guix' this way and this is a bug.
>
> =E2=80=9Cpre-inst-env=E2=80=9D really should not be used by people other =
than
> developers.  It is only available when building Guix from a clone of the
> git repository.
>
> We do not recommend =E2=80=9Cpre-inst-env=E2=80=9D for any other purpose =
than to make
> changes to the code, so I would not like to document the quirks and
> limitations of =E2=80=9Cpre-inst-env=E2=80=9D in the manual, as this is n=
ot how Guix is
> supposed to be used generally.
>
>> Proposed (revised) footnote:
>>
>> (3) The Guix version in the Guix build is set by './bootstrap'. Thus,
>> the version reported by './pre-inst-env guix --version' is not updated
>> by subsequent 'git pull; make' steps. To update the version (and rebuild
>> everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.
>
> I=E2=80=99m wary of adding this for similar reasons that Ludo wrote earli=
er.  In
> my opinion this ends up cluttering the manual with notes and what I
> consider to be only tangentially relevant for readers of the manual.

Hi Ricardo,

Please read further down the original post. I think you will find that I
already addressed your points.

Collectively, the responses here bring to mind a Harvard Business School
case study I was taught in 1983. The gist of it: Bakers at Holsum Bread
told a salesman that they had figured out how to run his company's bread
making machine at twice the design speed. Because this was twice as fast
as the competitor's machine, they wanted to place a big order for more
machines. When the salesman told the company engineer about the order he
said, "You can't sell any more machines to Holsum because they aren't
using my machine properly!"

- George




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 15 Jun 2018 22:48:17 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jun 15 18:48:16 2018
Received: from localhost ([127.0.0.1]:50725 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTxVw-00055X-ON
	for submit <at> debbugs.gnu.org; Fri, 15 Jun 2018 18:48:16 -0400
Received: from sender-of-o51.zoho.com ([135.84.80.216]:21059)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <rekado@HIDDEN>) id 1fTxVu-00055O-Px
 for 31786 <at> debbugs.gnu.org; Fri, 15 Jun 2018 18:48:15 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1529100134; 
 s=zoho; d=elephly.net; i=rekado@HIDDEN;
 h=References:From:To:Cc:Subject:In-reply-to:Date:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding;
 l=1555; bh=JE+w7wa6ja2LqATMh3jVY+E1qzr9NCmnTUZxjkJC3hg=;
 b=A3nuLrLcA150aKzd8OCftptYprgMH+EKEtF9uttv8ArUxzzAffpn59YIdMF3QhYo
 17COZNACgAZnAjX2DLc+rhTAoGwj4kZN0ucOt6SOe8Iz89DWWnshZdC0N8PsHQixmdt
 8SplV+7dWxiDxqByCbOGlk6khQy/3fRLxkry6eaI=
Received: from localhost (port-92-200-143-154.dynamic.qsc.de [92.200.143.154])
 by mx.zohomail.com with SMTPS id 1529100133958470.958106010934;
 Fri, 15 Jun 2018 15:02:13 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: Ricardo Wurmus <rekado@HIDDEN>
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <8736xnj22c.fsf@HIDDEN>
X-URL: https://elephly.net
X-PGP-Key: https://elephly.net/rekado.pubkey
X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6  2150 197A 5888 235F ACAC
Date: Sat, 16 Jun 2018 00:02:04 +0200
Message-ID: <87po0r674z.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-ZohoMailClient: External
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org,
 =?utf-8?Q?Cl=C3=A9men?= =?utf-8?Q?t?= Lassieur <clement@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)


Hi George,

> The current doc reflects the needs and sensibilities of the hackers,
> maintainers, and sysops that have built Guix. These "elite" users have
> different needs and judge what is important quite differently from end
> users. This guarantees that the current doc is inadequate for end users.
> So, if, as you say, you want to make Guix accessible to end users, you
> need to make changes in the doc.  The questions: How? What?
[=E2=80=A6]
> I said: I use 'pre-inst-env guix' this way and this is a bug.

=E2=80=9Cpre-inst-env=E2=80=9D really should not be used by people other th=
an
developers.  It is only available when building Guix from a clone of the
git repository.

We do not recommend =E2=80=9Cpre-inst-env=E2=80=9D for any other purpose th=
an to make
changes to the code, so I would not like to document the quirks and
limitations of =E2=80=9Cpre-inst-env=E2=80=9D in the manual, as this is not=
 how Guix is
supposed to be used generally.

> Proposed (revised) footnote:
>
> (3) The Guix version in the Guix build is set by './bootstrap'. Thus,
> the version reported by './pre-inst-env guix --version' is not updated
> by subsequent 'git pull; make' steps. To update the version (and rebuild
> everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.

I=E2=80=99m wary of adding this for similar reasons that Ludo wrote earlier=
.  In
my opinion this ends up cluttering the manual with notes and what I
consider to be only tangentially relevant for readers of the manual.

--
Ricardo





Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 15 Jun 2018 20:29:46 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jun 15 16:29:46 2018
Received: from localhost ([127.0.0.1]:50693 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTvLu-000207-0G
	for submit <at> debbugs.gnu.org; Fri, 15 Jun 2018 16:29:46 -0400
Received: from static.195.114.201.195.clients.your-server.de
 ([195.201.114.195]:35332 helo=conspiracy.of.n0.is)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ng0@HIDDEN>) id 1fTvLr-0001zy-LI
 for 31786 <at> debbugs.gnu.org; Fri, 15 Jun 2018 16:29:44 -0400
Received: by conspiracy.of.n0.is (OpenSMTPD) with ESMTPSA id a7021637
 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); 
 Fri, 15 Jun 2018 20:29:41 +0000 (UTC)
Date: Fri, 15 Jun 2018 20:30:18 +0000
From: Nils Gillmann <ng0@HIDDEN>
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
Message-ID: <20180615203018.clbx3kqjqfzcyink@abyayala>
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN> <8736xnj22c.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <8736xnj22c.fsf@HIDDEN>
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org,
 =?utf-8?Q?Cl=C3=A9ment?= Lassieur <clement@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

George Clemmer transcribed 3.9K bytes:
> 
> Ludovic Courtès <ludo@HIDDEN> writes:
> 
> > Hi George,
> >
> > George Clemmer <myglc2@HIDDEN> skribis:
> >
> >> Leo Famulari <leo@HIDDEN> writes:
> >>
> >>> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Courtès wrote:
> >>>> The other aspect, from a maintenance and readability viewpoint, is that
> >>>> we could quickly add up lots of explanations that we’ll have to keep
> >>>> up-to-date and that may make more important information harder to find.
> >>>
> >>> Yeah, I'm worried about this too. It's tough to strike the correct
> >>> balance.
> >>
> >> IMO Guix is great for hackers, maintainers and sysops. The doc is
> >> appropriate for such users, well done, spare, and already voluminous.
> >>
> >> This footnote suggestion, and others rejected in the past, are motivated
> >> by my assumption that you will want to make Guix attractive to less
> >> sophisticated users.
> >>
> >> Maybe my assumption is wrong? Maybe you want only "elite" users?
> >
> > No, definitely not; I’m sorry if this is the impression this gave.
> >
> > Like I wrote, my main concern is about keeping the documentation focused
> > and maintainable.  Sometimes we have to document things that are
> > technically outside of Guix because there’s no real canonical
> > documentation and because users would be impaired without it—I’m
> > thinking for instance of bits in the “Preparing for Installation”
> > section.
> >
> > In this case, we’d be documenting something that’s both outside of Guix
> > and not vital for routine usage, and that’s mostly covered by the
> > Autoconf manual.  Hence my reluctance.
> >
> > I hope that makes sense.
> 
> Hi Ludo’,
> 
> I see the situation this way:
> 
> The current doc reflects the needs and sensibilities of the hackers,
> maintainers, and sysops that have built Guix. These "elite" users have
> different needs and judge what is important quite differently from end
> users. This guarantees that the current doc is inadequate for end users.
> So, if, as you say, you want to make Guix accessible to end users, you
> need to make changes in the doc.  The questions: How? What?

I understand where you are coming from, and I understand the trouble Ludovic
(probably) has to find the right balance of content.
Before I comment more below: I'm trying to adjust to a wide range of
people with the least possible knowledge too in the new GNUnet documentation.
Some documentations I looked at had this introductionary style for elements
when they were first used. Texinfo has this element which seems to be less
used because it renders terrible (or did not try with custom output definitions
so far). It's sort of a box element. It would be good to extend this, at least
that's my current idea, to eventually contribute to Texinfo when I have a better
view on what we want.
Long text short nonsense: you end up with lots of work and long books if you
do it right. It should be done this way. Maybe if not directly applied we
could collect the proposals somewhere in the repository? I've recently
started to strip out a whole chapter with repetive installation instructions
in GNUnet. A while back I would've argued for keeping it, that we really
need to cover and guide every case.
Some projects have written "An introduction to..." books to lead up to
the manual.
In my opinion access to knowledge should be easy and without much 'rough
edges' to get it.
Do we keep it selfcontained? Reference other books? A middle path? It's
difficult to get it right if you don't have the time to think about this
as a fulltime job.

> May I suggest ...
> 
> a) Adopt a less defensive posture when responding to user questions,
>    comments, and bug reports.
> 
> b) Be pro-active about capturing support resolutions in the doc.
> 
> This thread presents a nice example of what I am talking about. To
> recap:
> 
> I said: I use 'pre-inst-env guix' this way and this is a bug.
> 
> You said: Developers expect this, so it's not a bug.
> 
> A less defensive response: Hmm, You are using 'pre-inst-env guix' in a
> way we didn't anticipate. What are the benefits of using it this way? I
> see how this is a bug for your use case.
> 
> We discussed a workaround. I suggested adding it to the doc.
> 
> You said: I’m not comfortable documenting this because it’s nothing
> specific to Guix.
> 
> I said: I urge you to reconsider.
> 
> You said: This part of the manual targets developers... they know where
> to look things up. [The more we write the more we have to maintain.]

Do we really have to assume that everyone has the same skilset who wants
to get involved? Not about this topic, but in general? I think the assumption
that we share the same knowledge is difficult. Part of the excercise is to
reach out, actively, in person. Another part is to try and do it in text (be
it on a website or a (new) chapter in a manual).

> And Clément Lassieur <clement@HIDDEN> added:
> 
> > But non-hacker users can use Guix pull!  Running Guix before it is
> > installed (with pre-inst-env) is described in the manual as a "Hacker
> > trick".
> 
> > Guix pull is well documented, and should be usable for non-elite users.
> 
> OK, but I'm non-elite and I have used Guix for 2+ years. I have tried
> both. I prefer pre-inst-env. I expect others will too. The fact is that
> pre-inst-env does not correctly report the version after 'git pull;
> make'. How can you know that this won't be a problem for other users?
> It only takes 4 lines to explain this and provide a workaround, e.g.,
> 
> Proposed (revised) footnote:
> 
> (3) The Guix version in the Guix build is set by './bootstrap'. Thus,
> the version reported by './pre-inst-env guix --version' is not updated
> by subsequent 'git pull; make' steps. To update the version (and rebuild
> everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.
> 
> - George

Counter-proposal: What about additional man-pages? man has enough sections
to provide well written, to the point, collection of notes for such day-to-day
usage. I'm not against your proposal, just another suggestion in context of
what I've written above.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 15 Jun 2018 19:13:25 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Fri Jun 15 15:13:25 2018
Received: from localhost ([127.0.0.1]:50665 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTuA1-0000J9-88
	for submit <at> debbugs.gnu.org; Fri, 15 Jun 2018 15:13:25 -0400
Received: from mail-qk0-f176.google.com ([209.85.220.176]:32974)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fTu9z-0000Ix-7z
 for 31786 <at> debbugs.gnu.org; Fri, 15 Jun 2018 15:13:23 -0400
Received: by mail-qk0-f176.google.com with SMTP id c131-v6so6230690qkb.0
 for <31786 <at> debbugs.gnu.org>; Fri, 15 Jun 2018 12:13:23 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version:content-transfer-encoding;
 bh=dSVrpstxJHspG1B2uuOasCrjZMVoZeVaksAqOtQyZgk=;
 b=ng7YModAHUo/zjbgxLT93TA6mcYLGo8Lw1gTdxrN46f0eAk2VVQQTpwe7vDvN4EGFU
 aMSvELk7fsAl3B/fTsfm/IxCncqg2uEqTCUwz6BtU8ssOG+VcfOy84k8Ps/9d950pvE2
 ODFTUPr3tzKHRjg7QSXUkKU71Bkh+VP/yIty/Nlh687Ti6At/LFURF6bL/wJ6FGv9R0D
 9zxQx/MOXVNvC8Q1dWU7Bz9ruPDEJQGrvvUg1fTuHInQcVXGxbb2nJX1Z11g1Ie6Rs60
 VnLhLIHMjj0EsE163jKP+q30+Js0A0HiPJONQN5N9BtfCfR8usITGukGcZmsppm/qfav
 bPCA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version:content-transfer-encoding;
 bh=dSVrpstxJHspG1B2uuOasCrjZMVoZeVaksAqOtQyZgk=;
 b=ld71htVuDwbXdCTs4MuWyx0QQsYnuOMGe2XSRqvb46TdbTDkg7k2Z5EmL4FwrepHRz
 sQhaV5gFIOfVW6toBqOuXj/1IZ4CWoXCesYDSgb9hY4oFQv0euEQUOpc61/kmwFEVvG1
 VG9185xjsyS/Fc276HAKzHg73EKuNu+PkUyDTwp77o4EZqqAGIKA8+q7SPEJf0P5PH+X
 0YSfFNaao3bYcva0OB5p/NS54+R922JXERqftTuiQDS67qzVPqAkNvTjbhdyZ0xJrR4P
 3SxNLSRRqpjpk0SzDgw85yhUIk48HCGTTlwK0GcEtRUYBLevcd6Pd9Oow0ZjUCYqmHVV
 Gz+Q==
X-Gm-Message-State: APt69E0V7OyRBFZgxioBLYBHio2ozeeHk1MRnkq+1o4TAlf6WMJsM4eJ
 t3O6f6AcPcMWRNh5ty1jNaPYyqfH
X-Google-Smtp-Source: ADUXVKJWfmINskvt8qe44ohx9BndwnzTfrUMgRu19ezNeMrG278HiDSZMOEsclNzrijXtUyYzkftXw==
X-Received: by 2002:a37:134c:: with SMTP id
 d73-v6mr2357588qkh.281.1529089997566; 
 Fri, 15 Jun 2018 12:13:17 -0700 (PDT)
Received: from sysi33 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 y131-v6sm5515880qka.30.2018.06.15.12.13.15
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Fri, 15 Jun 2018 12:13:16 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1z5o0.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: George Clemmer <myglc2@HIDDEN>
To: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, =?utf-8?Q?Cl=C3=A9men?=
 =?utf-8?Q?t?= Lassieur <clement@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87k1r1z5o0.fsf@HIDDEN>
Date: Fri, 15 Jun 2018 15:13:15 -0400
Message-ID: <8736xnj22c.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.3 (/)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org, Leo Famulari <leo@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.7 (/)


Ludovic Court=C3=A8s <ludo@HIDDEN> writes:

> Hi George,
>
> George Clemmer <myglc2@HIDDEN> skribis:
>
>> Leo Famulari <leo@HIDDEN> writes:
>>
>>> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
>>>> The other aspect, from a maintenance and readability viewpoint, is that
>>>> we could quickly add up lots of explanations that we=E2=80=99ll have t=
o keep
>>>> up-to-date and that may make more important information harder to find.
>>>
>>> Yeah, I'm worried about this too. It's tough to strike the correct
>>> balance.
>>
>> IMO Guix is great for hackers, maintainers and sysops. The doc is
>> appropriate for such users, well done, spare, and already voluminous.
>>
>> This footnote suggestion, and others rejected in the past, are motivated
>> by my assumption that you will want to make Guix attractive to less
>> sophisticated users.
>>
>> Maybe my assumption is wrong? Maybe you want only "elite" users?
>
> No, definitely not; I=E2=80=99m sorry if this is the impression this gave.
>
> Like I wrote, my main concern is about keeping the documentation focused
> and maintainable.  Sometimes we have to document things that are
> technically outside of Guix because there=E2=80=99s no real canonical
> documentation and because users would be impaired without it=E2=80=94I=E2=
=80=99m
> thinking for instance of bits in the =E2=80=9CPreparing for Installation=
=E2=80=9D
> section.
>
> In this case, we=E2=80=99d be documenting something that=E2=80=99s both o=
utside of Guix
> and not vital for routine usage, and that=E2=80=99s mostly covered by the
> Autoconf manual.  Hence my reluctance.
>
> I hope that makes sense.

Hi Ludo=E2=80=99,

I see the situation this way:

The current doc reflects the needs and sensibilities of the hackers,
maintainers, and sysops that have built Guix. These "elite" users have
different needs and judge what is important quite differently from end
users. This guarantees that the current doc is inadequate for end users.
So, if, as you say, you want to make Guix accessible to end users, you
need to make changes in the doc.  The questions: How? What?

May I suggest ...

a) Adopt a less defensive posture when responding to user questions,
   comments, and bug reports.

b) Be pro-active about capturing support resolutions in the doc.

This thread presents a nice example of what I am talking about. To
recap:

I said: I use 'pre-inst-env guix' this way and this is a bug.

You said: Developers expect this, so it's not a bug.

A less defensive response: Hmm, You are using 'pre-inst-env guix' in a
way we didn't anticipate. What are the benefits of using it this way? I
see how this is a bug for your use case.

We discussed a workaround. I suggested adding it to the doc.

You said: I=E2=80=99m not comfortable documenting this because it=E2=80=99s=
 nothing
specific to Guix.

I said: I urge you to reconsider.

You said: This part of the manual targets developers... they know where
to look things up. [The more we write the more we have to maintain.]

And Cl=C3=A9ment Lassieur <clement@HIDDEN> added:

> But non-hacker users can use Guix pull!  Running Guix before it is
> installed (with pre-inst-env) is described in the manual as a "Hacker
> trick".

> Guix pull is well documented, and should be usable for non-elite users.

OK, but I'm non-elite and I have used Guix for 2+ years. I have tried
both. I prefer pre-inst-env. I expect others will too. The fact is that
pre-inst-env does not correctly report the version after 'git pull;
make'. How can you know that this won't be a problem for other users?
It only takes 4 lines to explain this and provide a workaround, e.g.,

Proposed (revised) footnote:

(3) The Guix version in the Guix build is set by './bootstrap'. Thus,
the version reported by './pre-inst-env guix --version' is not updated
by subsequent 'git pull; make' steps. To update the version (and rebuild
everything), use 'git clean -dfx; ./bootstrap; ./configure; make'.

- George




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 14 Jun 2018 16:45:55 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Jun 14 12:45:55 2018
Received: from localhost ([127.0.0.1]:48384 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTVNi-00067G-UL
	for submit <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:45:55 -0400
Received: from mail.lassieur.org ([83.152.10.219]:43214)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <clement@HIDDEN>) id 1fTVNi-000678-47
 for 31786 <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:45:54 -0400
Received: from newt (smtp.parrot.biz [62.23.167.188])
 by mail.lassieur.org (OpenSMTPD) with ESMTPSA id 98636687
 (TLSv1.2:ECDHE-RSA-CHACHA20-POLY1305:256:NO); 
 Thu, 14 Jun 2018 16:45:52 +0000 (UTC)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
 <87k1r1tklq.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: =?utf-8?Q?Cl=C3=A9ment?= Lassieur <clement@HIDDEN>
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87k1r1tklq.fsf@HIDDEN>
Date: Thu, 14 Jun 2018 18:45:51 +0200
Message-ID: <87in6ltiyo.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org, Leo Famulari <leo@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Cl=C3=A9ment Lassieur <clement@HIDDEN> writes:

> Hi George,
>
> George Clemmer <myglc2@HIDDEN> writes:
>
>> Leo Famulari <leo@HIDDEN> writes:
>>
>>> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
>>>> The other aspect, from a maintenance and readability viewpoint, is that
>>>> we could quickly add up lots of explanations that we=E2=80=99ll have t=
o keep
>>>> up-to-date and that may make more important information harder to find.
>>>
>>> Yeah, I'm worried about this too. It's tough to strike the correct
>>> balance.
>>
>> IMO Guix is great for hackers, maintainers and sysops. The doc is
>> appropriate for such users, well done, spare, and already voluminous.
>>
>> This footnote suggestion, and others rejected in the past, are motivated
>> by my assumption that you will want to make Guix attractive to less
>> sophisticated users.
>
> But non-hacker users can use Guix pull!  Running Guix before it is
> installed (with pre-inst-env) is described in the manual as a "Hacker
> trick".
>
>> Maybe my assumption is wrong? Maybe you want only "elite" users?
>
> Guix pull is well documented, and should be usable for non-elite users.
>
>> Or maybe you want to defer the less sophisticated users to later in the
>> development cycle?
>
> Cl=C3=A9ment

Sorry if I sounded a bit rude, it wasn't my intention.  :-)




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 14 Jun 2018 16:36:44 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Jun 14 12:36:44 2018
Received: from localhost ([127.0.0.1]:48371 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTVEq-0005tL-JF
	for submit <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:36:44 -0400
Received: from eggs.gnu.org ([208.118.235.92]:44499)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1fTVEp-0005t7-3f
 for 31786 <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:36:43 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ludo@HIDDEN>) id 1fTVEf-0006sA-HU
 for 31786 <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:36:37 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_40 autolearn=disabled
 version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:47097)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@HIDDEN>)
 id 1fTVEf-0006rV-DZ; Thu, 14 Jun 2018 12:36:33 -0400
Received: from [193.50.110.75] (port=36742 helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <ludo@HIDDEN>)
 id 1fTVEe-0002Bi-UV; Thu, 14 Jun 2018 12:36:33 -0400
From: ludo@HIDDEN (Ludovic =?utf-8?Q?Court=C3=A8s?=)
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
X-URL: http://www.fdn.fr/~lcourtes/
X-Revolutionary-Date: 26 Prairial an 226 de la =?utf-8?Q?R=C3=A9volution?=
X-PGP-Key-ID: 0x090B11993D9AEBB5
X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc
X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4  0CFB 090B 1199 3D9A EBB5
X-OS: x86_64-pc-linux-gnu
Date: Thu, 14 Jun 2018 18:36:31 +0200
In-Reply-To: <87d0wttn0v.fsf@HIDDEN> (George Clemmer's message of "Thu, 14
 Jun 2018 11:18:08 -0400")
Message-ID: <87k1r1z5o0.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org, Leo Famulari <leo@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -6.0 (------)

Hi George,

George Clemmer <myglc2@HIDDEN> skribis:

> Leo Famulari <leo@HIDDEN> writes:
>
>> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
>>> The other aspect, from a maintenance and readability viewpoint, is that
>>> we could quickly add up lots of explanations that we=E2=80=99ll have to=
 keep
>>> up-to-date and that may make more important information harder to find.
>>
>> Yeah, I'm worried about this too. It's tough to strike the correct
>> balance.
>
> IMO Guix is great for hackers, maintainers and sysops. The doc is
> appropriate for such users, well done, spare, and already voluminous.
>
> This footnote suggestion, and others rejected in the past, are motivated
> by my assumption that you will want to make Guix attractive to less
> sophisticated users.
>
> Maybe my assumption is wrong? Maybe you want only "elite" users?

No, definitely not; I=E2=80=99m sorry if this is the impression this gave.

Like I wrote, my main concern is about keeping the documentation focused
and maintainable.  Sometimes we have to document things that are
technically outside of Guix because there=E2=80=99s no real canonical
documentation and because users would be impaired without it=E2=80=94I=E2=
=80=99m
thinking for instance of bits in the =E2=80=9CPreparing for Installation=E2=
=80=9D
section.

In this case, we=E2=80=99d be documenting something that=E2=80=99s both out=
side of Guix
and not vital for routine usage, and that=E2=80=99s mostly covered by the
Autoconf manual.  Hence my reluctance.

I hope that makes sense.

Ludo=E2=80=99.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 14 Jun 2018 16:10:30 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Jun 14 12:10:30 2018
Received: from localhost ([127.0.0.1]:48366 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTUpS-0005Ij-DC
	for submit <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:10:30 -0400
Received: from mail.lassieur.org ([83.152.10.219]:43202)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <clement@HIDDEN>) id 1fTUpQ-0005IZ-1o
 for 31786 <at> debbugs.gnu.org; Thu, 14 Jun 2018 12:10:28 -0400
Received: from newt (smtp.parrot.biz [62.23.167.188])
 by mail.lassieur.org (OpenSMTPD) with ESMTPSA id 4698659a
 (TLSv1.2:ECDHE-RSA-CHACHA20-POLY1305:256:NO); 
 Thu, 14 Jun 2018 16:10:26 +0000 (UTC)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN> <87d0wttn0v.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: =?utf-8?Q?Cl=C3=A9ment?= Lassieur <clement@HIDDEN>
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87d0wttn0v.fsf@HIDDEN>
Date: Thu, 14 Jun 2018 18:10:25 +0200
Message-ID: <87k1r1tklq.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -0.0 (/)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org, Leo Famulari <leo@HIDDEN>
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Hi George,

George Clemmer <myglc2@HIDDEN> writes:

> Leo Famulari <leo@HIDDEN> writes:
>
>> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
>>> The other aspect, from a maintenance and readability viewpoint, is that
>>> we could quickly add up lots of explanations that we=E2=80=99ll have to=
 keep
>>> up-to-date and that may make more important information harder to find.
>>
>> Yeah, I'm worried about this too. It's tough to strike the correct
>> balance.
>
> IMO Guix is great for hackers, maintainers and sysops. The doc is
> appropriate for such users, well done, spare, and already voluminous.
>
> This footnote suggestion, and others rejected in the past, are motivated
> by my assumption that you will want to make Guix attractive to less
> sophisticated users.

But non-hacker users can use Guix pull!  Running Guix before it is
installed (with pre-inst-env) is described in the manual as a "Hacker
trick".

> Maybe my assumption is wrong? Maybe you want only "elite" users?

Guix pull is well documented, and should be usable for non-elite users.

> Or maybe you want to defer the less sophisticated users to later in the
> development cycle?

Cl=C3=A9ment




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 14 Jun 2018 15:18:19 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Thu Jun 14 11:18:19 2018
Received: from localhost ([127.0.0.1]:48331 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTU0w-00047u-Pv
	for submit <at> debbugs.gnu.org; Thu, 14 Jun 2018 11:18:18 -0400
Received: from mail-qk0-f176.google.com ([209.85.220.176]:43560)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fTU0u-00047e-Ru
 for 31786 <at> debbugs.gnu.org; Thu, 14 Jun 2018 11:18:17 -0400
Received: by mail-qk0-f176.google.com with SMTP id g126-v6so3811239qke.10
 for <31786 <at> debbugs.gnu.org>; Thu, 14 Jun 2018 08:18:16 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version:content-transfer-encoding;
 bh=n8G/cYPlxYtqurpFOYtSU8F7Gdzyobi9Q8LbcOu+ki8=;
 b=W2kDjENwSIwsr82b3xnJ+jSgmgcdlgjcGf3TSXyFquKWZRX7KL/zVddzNG5+TyCvsK
 vUA0ivFzude98TSQcSJ3W6P1IjhF3FjaOHbRkEIaFvpYAx2sLdcEutraqkDmmr5D+xL3
 qjmEeU/wdEEzva5MIJMvn2zZbYjv9Di5SgELOQNdqDkYnYUFPQiZvYsRzJrQ93Zoh2Ss
 2cyrlDghaOkSI3d+Y2L/d920ZA5ibyEtN39wS/gI3G5DcJkmgwRRu4sy0NfLTrz0OdDY
 N1+cCvvnCXVjAkOEvSVQ8IrdbIgswqUhEXDD+KAuMgCuk4BEwgHWoUohpWts1tZflKCm
 Vo1Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version:content-transfer-encoding;
 bh=n8G/cYPlxYtqurpFOYtSU8F7Gdzyobi9Q8LbcOu+ki8=;
 b=kEeQLNEQjkHYJL7GMrrtL0qKguV4fWgw+H1QnzMc6AUj5i3X4MDv06kVioYGQOoyxY
 BTyDfUeDg1Rfffzzx6mb5y+0/r46Q98lJ+QCPo6thceAnijMw0u7PCULTZWNYRB+Cr92
 4W4hqHN5Vip/FnNXG3amLAVyu4f6oytkTaD6TzQjRMx1Gg7biMjG2MXpzjEbmcsPozEp
 UNjHmZuqBDtMF5HS7zVc4/6unKOt7zPQGI2w2u8u0p1Xyct+YJIR2BOrLnGa8Givo9Bl
 JPxPIFK9bBpyweO4ErtaQC/U3lCp6PcD6b0MIlT3zFg6oL8aj4BjDLkDyvyTRa6X+/V0
 bwWA==
X-Gm-Message-State: APt69E0pkxMkCrwiHhC3p3M5x/3ySoi6/6ad4+Itmdmf2qzVsamlAYjt
 a4d83VLHZ1wtlcQ2jbWAYowV4w==
X-Google-Smtp-Source: ADUXVKI2j1XYeNUSujZzs5QtIaJqAZGVpULxYWekX26awvM7aoZ3TTCGI1fMUGj9L+6S9ThzK5VbZg==
X-Received: by 2002:a37:a18d:: with SMTP id
 k135-v6mr2447516qke.33.1528989490805; 
 Thu, 14 Jun 2018 08:18:10 -0700 (PDT)
Received: from sysi33 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 g32-v6sm5140572qkh.44.2018.06.14.08.18.09
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Thu, 14 Jun 2018 08:18:09 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
 <20180614013938.GD29167@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: George Clemmer <myglc2@HIDDEN>
To: Leo Famulari <leo@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <20180614013938.GD29167@HIDDEN>
Date: Thu, 14 Jun 2018 11:18:08 -0400
Message-ID: <87d0wttn0v.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.3 (/)
X-Debbugs-Envelope-To: 31786
Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>, 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.7 (/)


Leo Famulari <leo@HIDDEN> writes:

> On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
>> The other aspect, from a maintenance and readability viewpoint, is that
>> we could quickly add up lots of explanations that we=E2=80=99ll have to =
keep
>> up-to-date and that may make more important information harder to find.
>
> Yeah, I'm worried about this too. It's tough to strike the correct
> balance.

IMO Guix is great for hackers, maintainers and sysops. The doc is
appropriate for such users, well done, spare, and already voluminous.

This footnote suggestion, and others rejected in the past, are motivated
by my assumption that you will want to make Guix attractive to less
sophisticated users.

Maybe my assumption is wrong? Maybe you want only "elite" users?

Or maybe you want to defer the less sophisticated users to later in the
development cycle?




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 14 Jun 2018 01:39:44 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 13 21:39:44 2018
Received: from localhost ([127.0.0.1]:47115 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fTHEl-0000Qy-U0
	for submit <at> debbugs.gnu.org; Wed, 13 Jun 2018 21:39:44 -0400
Received: from out2-smtp.messagingengine.com ([66.111.4.26]:47391)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <leo@HIDDEN>) id 1fTHEi-0000Qg-AE
 for 31786 <at> debbugs.gnu.org; Wed, 13 Jun 2018 21:39:40 -0400
Received: from compute4.internal (compute4.nyi.internal [10.202.2.44])
 by mailout.nyi.internal (Postfix) with ESMTP id 1F46921B2B;
 Wed, 13 Jun 2018 21:39:40 -0400 (EDT)
Received: from mailfrontend2 ([10.202.2.163])
 by compute4.internal (MEProxy); Wed, 13 Jun 2018 21:39:40 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=famulari.name;
 h=cc:content-type:date:from:in-reply-to:message-id:mime-version
 :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s=
 mesmtp; bh=/u0TCv3OWSOVHmIAvDVtMR0EfWaOsAqW2BYjAaozTJg=; b=vt8tB
 UvpNwSXEbWH8mxAhpYiEtVan5lI1xWMp+KNBStEqvvVTyzzVjdmoVRtrOLewK88X
 XF8ECBpLsNOrkOoW2A1b2HJxsXi22yvkp/Zhr+x44lV6WGmU6/GWqfVKZy232Ist
 U7otDZU7u5IwcID3smtH1/dH+M8wjb3Dj+K9gc=
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=
 messagingengine.com; h=cc:content-type:date:from:in-reply-to
 :message-id:mime-version:references:subject:to:x-me-sender
 :x-me-sender:x-sasl-enc; s=fm3; bh=/u0TCv3OWSOVHmIAvDVtMR0EfWaOs
 AqW2BYjAaozTJg=; b=SabcLvK20KA4QUSyLQfqFqXvAsJyYGwOxIa/PHKux0H4K
 c9SPKZtvL/4ZMY9sNrfdOLBqghJy/IjKaBLLbLbu3HCi/xSqiW3B7dUCrjp0BnVa
 Z/6+YRUdQCxpHJ7xRmqU7GPNcsttMH85/kFchP+wkoMmxD0Tn9ZS2fKIeby1IAUz
 26077Z4Q5PBfwTFnDxyDNtInhaPaR9gifJgU5f5ug+j1IAPddzW1uulTB7+YHuQy
 PUwjXTpUx1VtHwfDVy0Hb6zvYDRqHorrxRtrDQHTZOW4nRr13gYrwwA6TlEwGS1M
 91GarPauOp7t1urioOsnzBGIK8ZglyvdsJaixtNLQ==
X-ME-Proxy: <xmx:XMchW8EO8UCEmfRI8yOxVx5XyrjNei7iHJIgiOCOPCJLaQeYOfgVwQ>
X-ME-Proxy: <xmx:XMchW26q1_ofZI3pysrEpk6xrPa3k42LXQX6ATYnNcnmyuZs5yoJqQ>
X-ME-Proxy: <xmx:XMchW8dLJor-W3VIZua-hl1kp36v5TJTvscgP59CtF37rL_cxzYdXA>
X-ME-Proxy: <xmx:XMchW55GfRsNdgTWBdly44vWU4fK6ZeiM3hRoNduxzCBDc4aDqDCcw>
X-ME-Proxy: <xmx:XMchW58G5o-kZkVeWEuQhGs90SvdK0yiLF0PkhuaeH6GxzEu50vo5A>
X-ME-Proxy: <xmx:XMchW39raVzaG9ylqAao2sPaAQOoS5yvZZ_3S1zpiIPSdtr2b8nIOg>
X-ME-Sender: <xms:XMchW7vRaQUzMLxp_dqO32jgFp7IZEF9hjGWBB6opg1ncUUL6s6MNA>
Received: from localhost (unknown [172.58.200.88])
 by mail.messagingengine.com (Postfix) with ESMTPA id BDEC210255;
 Wed, 13 Jun 2018 21:39:39 -0400 (EDT)
Date: Wed, 13 Jun 2018 21:39:38 -0400
From: Leo Famulari <leo@HIDDEN>
To: Ludovic =?iso-8859-1?Q?Court=E8s?= <ludo@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
Message-ID: <20180614013938.GD29167@HIDDEN>
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN> <87wov3npl2.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/signed; micalg=pgp-sha256;
 protocol="application/pgp-signature"; boundary="C+ts3FVlLX8+P6JN"
Content-Disposition: inline
In-Reply-To: <87wov3npl2.fsf@HIDDEN>
User-Agent: Mutt/1.10.0 (2018-05-17)
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 31786
Cc: George Clemmer <myglc2@HIDDEN>, 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)


--C+ts3FVlLX8+P6JN
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable

On Wed, Jun 13, 2018 at 08:54:49AM +0200, Ludovic Court=C3=A8s wrote:
> The other aspect, from a maintenance and readability viewpoint, is that
> we could quickly add up lots of explanations that we=E2=80=99ll have to k=
eep
> up-to-date and that may make more important information harder to find.

Yeah, I'm worried about this too. It's tough to strike the correct
balance.

--C+ts3FVlLX8+P6JN
Content-Type: application/pgp-signature; name="signature.asc"

-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEsFFZSPHn08G5gDigJkb6MLrKfwgFAlshx1oACgkQJkb6MLrK
fwhUnhAArk6n1xg7M7GM2gGluwc1j/xfcwM++5j1rwxvaYKoYQ++EsxzNeFjKi/7
uNVrrd5hRo3tEq/skTuIK4mzwzXgetlWwRK1Bg9eCFA2sW7EhqT7Rkpsh36eW97u
8B7LnItWlcdPr92QZLnLkOW/t2RPy60fncNNNTmKTrCAQbOjDjhiUMgEeXWb20l/
aOTyV4bTZPaKbMdrMScxeRgFsk+X0qIJ5xGvZzmKcaKt+9SSPXxhL+AstaCyq0UW
UfCaQ1bL8wjEX6PKx788AZfwvPZS6ygf3aGIX8yp9jr1fWntO/cywSgsisjUCUnZ
DiDPYWasriLbpOco8MlkOWVnXFBeGDx9Y2CElI3tfaGljCco3lSr68O1Kafc+iHf
yhRuxiw5B4YZh0h0GjnS1e05SLrGagYCrG8dUlA/HwdDcM6Ac4w1mL4y+YgGBMoJ
D/6/CJamdkgXgULxDoptIFIWb8YadCrv082j/++CbtwpE1y3Cc6Nj/QAVR2236h4
0cO+xY+Tz9x+RhwN7U2X1bvoj/BQwrCpPJGD7dv82MsMEeeAie9dtGAjx8L/XCHm
sutSUD+tuWUdAx2JJcUSTD1IsWPVJrAJfvTL+VRQwrIQlC4Q3RONmUFgkQA8kauS
KuFLLJWh4j8THtwpuniwH8wnyuhq8JOsCmACQvO6VCo7yrl5pfw=
=2j1a
-----END PGP SIGNATURE-----

--C+ts3FVlLX8+P6JN--




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 13 Jun 2018 06:55:04 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Jun 13 02:55:04 2018
Received: from localhost ([127.0.0.1]:45686 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSzgO-0000ju-Ao
	for submit <at> debbugs.gnu.org; Wed, 13 Jun 2018 02:55:04 -0400
Received: from eggs.gnu.org ([208.118.235.92]:42586)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1fSzgL-0000jM-Ac
 for 31786 <at> debbugs.gnu.org; Wed, 13 Jun 2018 02:55:01 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ludo@HIDDEN>) id 1fSzgB-0004mM-8U
 for 31786 <at> debbugs.gnu.org; Wed, 13 Jun 2018 02:54:56 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-0.0 required=5.0 tests=BAYES_20 autolearn=disabled
 version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:48507)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@HIDDEN>)
 id 1fSzgB-0004mC-52; Wed, 13 Jun 2018 02:54:51 -0400
Received: from [193.50.110.75] (port=38306 helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <ludo@HIDDEN>)
 id 1fSzgA-0001Z0-NT; Wed, 13 Jun 2018 02:54:50 -0400
From: ludo@HIDDEN (Ludovic =?utf-8?Q?Court=C3=A8s?=)
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
 <87o9gf5x0t.fsf@HIDDEN>
X-URL: http://www.fdn.fr/~lcourtes/
X-Revolutionary-Date: 25 Prairial an 226 de la =?utf-8?Q?R=C3=A9volution?=
X-PGP-Key-ID: 0x090B11993D9AEBB5
X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc
X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4  0CFB 090B 1199 3D9A EBB5
X-OS: x86_64-pc-linux-gnu
Date: Wed, 13 Jun 2018 08:54:49 +0200
In-Reply-To: <87o9gf5x0t.fsf@HIDDEN> (George Clemmer's message of "Tue, 12
 Jun 2018 20:51:30 -0400")
Message-ID: <87wov3npl2.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -6.0 (------)

Hello,

George Clemmer <myglc2@HIDDEN> skribis:

> Ludovic Court=C3=A8s <ludo@HIDDEN> writes:
>
>> George Clemmer <myglc2@HIDDEN> skribis:
>>
>>> Ok, cool. Thanks for the clarification. So... how about adding a
>>> footnote to '(guix) Running Guix Before It Is Installed' something like
>>> ...
>>>
>>> (3) The Guix version in the Guix build is set by './configure'. Thus,
>>> when guix is run from the Git working tree by './pre-inst-env guix' or a
>>> '~/.config/guix/latest=E2=80=99 symlink, the version reported by 'guix
>>> --version' is not updated by subsequent 'git pull; make' steps. To
>>> update the version (and rebuild everything), you may use 'git clean
>>> -dfx; ./bootstrap; ./configure; make'.
>>
>> I=E2=80=99m not comfortable documenting this because it=E2=80=99s nothin=
g specific to
>> Guix.
>
> So to summarize: This behavior is a side effect of how GNU tools
> work. It is obvious to anyone who understands them. You don't want to
> describe things that are obvious. I understand.
>
> But I think many users don't have a clue about GNU build tools. They may
> be puzzled by how pre-inst-env works. I think the footnote would be
> helpful for them. I urge you to reconsider.

It=E2=80=99s not that I find it =E2=80=9Cobvious=E2=80=9D etc.  This specif=
ic part of the manual
targets an audience of developers, and I think it=E2=80=99s reasonable to e=
xpect
this audience to know where to look things up.

The other aspect, from a maintenance and readability viewpoint, is that
we could quickly add up lots of explanations that we=E2=80=99ll have to keep
up-to-date and that may make more important information harder to find.

I hope that makes sense, but I=E2=80=99m happy to hear what others think.

Ludo=E2=80=99.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 13 Jun 2018 00:51:40 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 12 20:51:40 2018
Received: from localhost ([127.0.0.1]:45560 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSu0i-0000o7-6E
	for submit <at> debbugs.gnu.org; Tue, 12 Jun 2018 20:51:40 -0400
Received: from mail-qt0-f181.google.com ([209.85.216.181]:43908)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fSu0g-0000nu-3W
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 20:51:38 -0400
Received: by mail-qt0-f181.google.com with SMTP id y89-v6so875023qtd.10
 for <31786 <at> debbugs.gnu.org>; Tue, 12 Jun 2018 17:51:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version:content-transfer-encoding;
 bh=e9wXnbonDCZnRHQ3UTdsjP99qeyrbM+f3FvFQhrT/XM=;
 b=Hdmf2y+TPKxsB6PvshXUqZm22kKKmQ4AF4UEucpx79UeimXutYfPS857RKlED/pIUT
 cL41a2koxbRWDgALM4xBcDRyJOywqsbMGZm3Tk3Uf1uwJqZSKcQwWiOjZJf2CtAJTpSF
 O/L7bMywLaZPndSl1ANJPhQC9apHNCMaC4y8CLarwTjt7IuOYCogwMl4A3ZWw/jqX5iG
 FC8zRGmjJqtA9dqBrIlCbyAe5dCO07o6MdT5L3886n9i4kmz5GHQAUJ3QnCeXiDIleK1
 p7IG7GXOOTiE0a+BtAD1f9qPGaRSMd4UH2gPImjR74ijrAHjQOpCvn0cO6UDwRFEnCam
 Vg+A==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version:content-transfer-encoding;
 bh=e9wXnbonDCZnRHQ3UTdsjP99qeyrbM+f3FvFQhrT/XM=;
 b=uGAsjO1kUSrbM0xEwGeh8gTpnfxlSxufbt31Zu3gDZjXxxSS/hmdNO2xSRWIvr+4nF
 HvZyL3/5b84CvAYUg37Hvo/edbUvs8szCwPHhWT3lj5NWTyPYM/fd2FaK/ZAp9dcsFTv
 Zo9Dgqa8jKUCk/K+6lo9zCYvLkKYI5JUZUTpriPuolxJDtCzw9JPLCGSajPB1e7IENA9
 nDefzxTXMB/Z8LnUpLOjB+znGbH/DlY99nyZi+ZX0miZv0OyIuXFcNk0Iz2/VkquJ65r
 /7BKJQdqyGxf595qjstYfKb/Tbx0gpA8zzLp9o4Ykx9OA+ZbKB3qofHNaOzbfkAyUMPl
 ZbwQ==
X-Gm-Message-State: APt69E0Sn3gbdCLEmHFfYziUuM9Qi7fwq5zbqCJp6TuU1EDhaVelAJNn
 UPHZw+qOpfBy7/mUOyna2ZUerg==
X-Google-Smtp-Source: ADUXVKI7o6aiHL9PD/WZk/7O2iSMEAy2xH/1lc5rzlXNwuf1CzBFjxQlcxDnNffpzU2DfAVYW3juAA==
X-Received: by 2002:a0c:8a29:: with SMTP id 38-v6mr2673660qvt.75.1528851092262; 
 Tue, 12 Jun 2018 17:51:32 -0700 (PDT)
Received: from sysi33 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 v50-v6sm1291163qta.34.2018.06.12.17.51.30
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Tue, 12 Jun 2018 17:51:31 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN> <87d0wvoicy.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 26.1
From: George Clemmer <myglc2@HIDDEN>
To: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87d0wvoicy.fsf@HIDDEN>
Date: Tue, 12 Jun 2018 20:51:30 -0400
Message-ID: <87o9gf5x0t.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.2 (/)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.8 (/)


Ludovic Court=C3=A8s <ludo@HIDDEN> writes:

> George Clemmer <myglc2@HIDDEN> skribis:
>
>> Ok, cool. Thanks for the clarification. So... how about adding a
>> footnote to '(guix) Running Guix Before It Is Installed' something like
>> ...
>>
>> (3) The Guix version in the Guix build is set by './configure'. Thus,
>> when guix is run from the Git working tree by './pre-inst-env guix' or a
>> '~/.config/guix/latest=E2=80=99 symlink, the version reported by 'guix
>> --version' is not updated by subsequent 'git pull; make' steps. To
>> update the version (and rebuild everything), you may use 'git clean
>> -dfx; ./bootstrap; ./configure; make'.
>
> I=E2=80=99m not comfortable documenting this because it=E2=80=99s nothing=
 specific to
> Guix.

So to summarize: This behavior is a side effect of how GNU tools
work. It is obvious to anyone who understands them. You don't want to
describe things that are obvious. I understand.

But I think many users don't have a clue about GNU build tools. They may
be puzzled by how pre-inst-env works. I think the footnote would be
helpful for them. I urge you to reconsider.

> Besides, note that ~/.config/guix/latest no longer exists.

Yes, I saw you revamped Guix pull but I haven't actually used guix pull
in over a year.  I need to check the new one out.

- George




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 12 Jun 2018 20:33:28 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 12 16:33:28 2018
Received: from localhost ([127.0.0.1]:45426 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSpyq-0007h2-2s
	for submit <at> debbugs.gnu.org; Tue, 12 Jun 2018 16:33:28 -0400
Received: from eggs.gnu.org ([208.118.235.92]:59693)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1fSpyo-0007gq-Eg
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 16:33:26 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ludo@HIDDEN>) id 1fSpyi-0003Y5-DA
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 16:33:21 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled
 version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:42520)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@HIDDEN>)
 id 1fSpyi-0003Xy-9G; Tue, 12 Jun 2018 16:33:20 -0400
Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=35838 helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <ludo@HIDDEN>)
 id 1fSpyh-00037i-PS; Tue, 12 Jun 2018 16:33:20 -0400
From: ludo@HIDDEN (Ludovic =?utf-8?Q?Court=C3=A8s?=)
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
 <87k1r3271g.fsf@HIDDEN>
X-URL: http://www.fdn.fr/~lcourtes/
X-Revolutionary-Date: 24 Prairial an 226 de la =?utf-8?Q?R=C3=A9volution?=
X-PGP-Key-ID: 0x090B11993D9AEBB5
X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc
X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4  0CFB 090B 1199 3D9A EBB5
X-OS: x86_64-pc-linux-gnu
Date: Tue, 12 Jun 2018 22:33:17 +0200
In-Reply-To: <87k1r3271g.fsf@HIDDEN> (George Clemmer's message of "Tue, 12
 Jun 2018 14:28:43 -0400")
Message-ID: <87d0wvoicy.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -6.0 (------)

George Clemmer <myglc2@HIDDEN> skribis:

> Ludovic Court=C3=A8s <ludo@HIDDEN> writes:
>
>> Hello George,
>>
>> George Clemmer <myglc2@HIDDEN> skribis:
>>
>>> But with subsequent git commit/make cycles the version does not
>>> change. It doesn't change when the guix package is updated either. For
>>> example, after pulling and building the recent commit updating the guix
>>> package ...
>>
>> Currently the version number is hardcoded in =E2=80=98configure.ac=E2=80=
=99, so the fact
>> that running =E2=80=9Cgit pull && make=E2=80=9D doesn=E2=80=99t change i=
t is expected.  So to
>> me, it=E2=80=99s not a bug.
>>
>> We could improve on that (see for instance how Guile does it with
>> build-aux/git-version-gen), but it still won=E2=80=99t be updated at eac=
h commit
>> because that=E2=80=99d be inconvenient: =E2=80=98config.h=E2=80=99 would=
 regenerated, so in turn
>> we=E2=80=99d need to rebuild all of the C++ code.
>
> Hi Ludo=E2=80=99,
>
> Ok, cool. Thanks for the clarification. So... how about adding a
> footnote to '(guix) Running Guix Before It Is Installed' something like
> ...
>
> (3) The Guix version in the Guix build is set by './configure'. Thus,
> when guix is run from the Git working tree by './pre-inst-env guix' or a
> '~/.config/guix/latest=E2=80=99 symlink, the version reported by 'guix
> --version' is not updated by subsequent 'git pull; make' steps. To
> update the version (and rebuild everything), you may use 'git clean
> -dfx; ./bootstrap; ./configure; make'.

I=E2=80=99m not comfortable documenting this because it=E2=80=99s nothing s=
pecific to
Guix.

Besides, note that ~/.config/guix/latest no longer exists.

>>> 2) why don't you gitignore .po files?
>>
>> Because they are checked in.
>
> I guess I meant to say, why does the build change these checked-in
> files? It seems like they should be ignored.

The build changes them only if you start anew.  In normal circumstances
(meaning you didn=E2=80=99t run =E2=80=9Cdistclean=E2=80=9D), they remained=
 unchanged if I=E2=80=99m not
mistaken.

So yeah, it=E2=80=99s occasionally annoying, but I=E2=80=99m not sure how t=
o fix this.

Ludo=E2=80=99.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 12 Jun 2018 18:28:53 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 12 14:28:53 2018
Received: from localhost ([127.0.0.1]:45332 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSo2G-0007JA-OI
	for submit <at> debbugs.gnu.org; Tue, 12 Jun 2018 14:28:52 -0400
Received: from mail-qt0-f174.google.com ([209.85.216.174]:40463)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fSo2F-0007Ix-Is
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 14:28:51 -0400
Received: by mail-qt0-f174.google.com with SMTP id q6-v6so24659466qtn.7
 for <31786 <at> debbugs.gnu.org>; Tue, 12 Jun 2018 11:28:51 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=references:user-agent:from:to:cc:subject:in-reply-to:date
 :message-id:mime-version:content-transfer-encoding;
 bh=bcg/ZVz5+EoFpPiJ8r8JrjWmf35/CftrSP6osenUFZE=;
 b=Bu0rljlFGRpUElOvMoXk9gFxyKFu2CVHWjtq14AnNB6FhvVimrx2cBDAkxPbL0iPhs
 bJ7iQnGPzQ5PGkNZObtxzhRgn9hzCSb1egJ+Dyl+rJ94Vi1UgNfCHEWLBV8s5Li8AxCu
 b5UDixmQsXXlWX1S+VhHj4YMXPMgSi3IgVLKCGz6arGLD9QXa1rQ6uakRh1B6GAhuzJT
 xM7Is/3OIQH1+y/1w18o/NhBzAxlgKVJARHr6HH15yqkg+Z2QoQVNjQRpKsvSflodgTd
 vzMOYK+Rpf+JUS9GDtzmbrBIDRQYedvPjAyoe7nTiVriCYM0ZmMjFmRKy1fHvAFnqtp0
 SAXA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:references:user-agent:from:to:cc:subject
 :in-reply-to:date:message-id:mime-version:content-transfer-encoding;
 bh=bcg/ZVz5+EoFpPiJ8r8JrjWmf35/CftrSP6osenUFZE=;
 b=MEn1Ah/aBv52jSbUketTEc6IwR0UmuesqT5/hN0Sgj43OaAGQX0a5DRNF/gX0OUtAQ
 RVfK6CyKN0yXS6yy8Uy3i+sndBx1Pkc3sBN8Av+jISI3emE50JMf9J/WXHajYDYEqWKN
 uRZtcHObLzHypUFvTDAxKgD/S3GHXW+UY94vwEuVpoJxvf9/eWdj7ljos20EFmOUg3xU
 CqhNglHZbwFg3JRjIauiFKJ2bUrMRjL99HtpsQIR0mdpSYqWshnRZgEfHIdveESvBizK
 qUSUCsXLtfqNkLfIIFc6Wmb7blnHS1F9/QgPct1ef228cZOIgQFOm3yyKlfBtPjICu7R
 1CCQ==
X-Gm-Message-State: APt69E2o7n/mU+sgVEIkyfOuybj645qSYvalc44k7qqhLCTr4DXn79kF
 IpPSYrdb0aZROMNhuGccBzxq4A==
X-Google-Smtp-Source: ADUXVKLdTr2IKyglvIdD7o1859OK19pVggtmO+kl8KUU3T/jxtOR3pBw2Vpbl63H6/BVfjd6ciLvmA==
X-Received: by 2002:a0c:aa4d:: with SMTP id
 e13-v6mr1615124qvb.26.1528828125665; 
 Tue, 12 Jun 2018 11:28:45 -0700 (PDT)
Received: from sysi31 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 n37-v6sm691595qkh.71.2018.06.12.11.28.44
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Tue, 12 Jun 2018 11:28:44 -0700 (PDT)
References: <87r2lddwyg.fsf@HIDDEN> <87k1r4p2ca.fsf@HIDDEN>
User-agent: mu4e 1.0; emacs 25.3.1
From: George Clemmer <myglc2@HIDDEN>
To: Ludovic =?utf-8?Q?Court=C3=A8s?= <ludo@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
In-reply-to: <87k1r4p2ca.fsf@HIDDEN>
Date: Tue, 12 Jun 2018 14:28:43 -0400
Message-ID: <87k1r3271g.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Spam-Score: 0.2 (/)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -0.8 (/)


Ludovic Courtès <ludo@HIDDEN> writes:

> Hello George,
>
> George Clemmer <myglc2@HIDDEN> skribis:
>
>> But with subsequent git commit/make cycles the version does not
>> change. It doesn't change when the guix package is updated either. For
>> example, after pulling and building the recent commit updating the guix
>> package ...
>
> Currently the version number is hardcoded in ‘configure.ac’, so the fact
> that running “git pull && make” doesn’t change it is expected.  So to
> me, it’s not a bug.
>
> We could improve on that (see for instance how Guile does it with
> build-aux/git-version-gen), but it still won’t be updated at each commit
> because that’d be inconvenient: ‘config.h’ would regenerated, so in turn
> we’d need to rebuild all of the C++ code.

Hi Ludo’,

Ok, cool. Thanks for the clarification. So... how about adding a
footnote to '(guix) Running Guix Before It Is Installed' something like
...

(3) The Guix version in the Guix build is set by './configure'. Thus,
when guix is run from the Git working tree by './pre-inst-env guix' or a
'~/.config/guix/latest’ symlink, the version reported by 'guix
--version' is not updated by subsequent 'git pull; make' steps. To
update the version (and rebuild everything), you may use 'git clean
-dfx; ./bootstrap; ./configure; make'.

Note: I also tried 'make distclean' and 'make maintainer-clean' which
didn't work.

> ‘guix pull’ does the right thing though, which I think is more important
> than the build tree.

Agreed.

>> Side questions:
>>
>> 1) why don't you gitignore "doc/stamp-1"?
>
> Good idea, done!  :-)

Thanks!

>> 2) why don't you gitignore .po files?
>
> Because they are checked in.

I guess I meant to say, why does the build change these checked-in
files? It seems like they should be ignored.

TIA - George




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at 31786 <at> debbugs.gnu.org:


Received: (at 31786) by debbugs.gnu.org; 12 Jun 2018 13:21:59 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Jun 12 09:21:59 2018
Received: from localhost ([127.0.0.1]:44267 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSjFH-0006VO-Ee
	for submit <at> debbugs.gnu.org; Tue, 12 Jun 2018 09:21:59 -0400
Received: from eggs.gnu.org ([208.118.235.92]:40710)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <ludo@HIDDEN>) id 1fSjFD-0006V9-Pz
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 09:21:57 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <ludo@HIDDEN>) id 1fSjF2-0001CA-7g
 for 31786 <at> debbugs.gnu.org; Tue, 12 Jun 2018 09:21:50 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=disabled
 version=3.3.2
Received: from fencepost.gnu.org ([2001:4830:134:3::e]:36798)
 by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from <ludo@HIDDEN>)
 id 1fSjF2-0001C1-2u; Tue, 12 Jun 2018 09:21:44 -0400
Received: from [193.50.110.75] (port=35578 helo=ribbon)
 by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256)
 (Exim 4.82) (envelope-from <ludo@HIDDEN>)
 id 1fSjF1-0001DU-I5; Tue, 12 Jun 2018 09:21:43 -0400
From: ludo@HIDDEN (Ludovic =?utf-8?Q?Court=C3=A8s?=)
To: George Clemmer <myglc2@HIDDEN>
Subject: Re: bug#31786: 'pre-inst-env guix --version' is not updated by new
 commits"
References: <87r2lddwyg.fsf@HIDDEN>
X-URL: http://www.fdn.fr/~lcourtes/
X-Revolutionary-Date: 24 Prairial an 226 de la =?utf-8?Q?R=C3=A9volution?=
X-PGP-Key-ID: 0x090B11993D9AEBB5
X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc
X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4  0CFB 090B 1199 3D9A EBB5
X-OS: x86_64-pc-linux-gnu
Date: Tue, 12 Jun 2018 15:21:41 +0200
In-Reply-To: <87r2lddwyg.fsf@HIDDEN> (George Clemmer's message of "Mon, 11
 Jun 2018 14:01:11 -0400")
Message-ID: <87k1r4p2ca.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic]
X-Received-From: 2001:4830:134:3::e
X-Spam-Score: -5.0 (-----)
X-Debbugs-Envelope-To: 31786
Cc: 31786 <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -6.0 (------)

Hello George,

George Clemmer <myglc2@HIDDEN> skribis:

> But with subsequent git commit/make cycles the version does not
> change. It doesn't change when the guix package is updated either. For
> example, after pulling and building the recent commit updating the guix
> package ...

Currently the version number is hardcoded in =E2=80=98configure.ac=E2=80=99=
, so the fact
that running =E2=80=9Cgit pull && make=E2=80=9D doesn=E2=80=99t change it i=
s expected.  So to
me, it=E2=80=99s not a bug.

We could improve on that (see for instance how Guile does it with
build-aux/git-version-gen), but it still won=E2=80=99t be updated at each c=
ommit
because that=E2=80=99d be inconvenient: =E2=80=98config.h=E2=80=99 would re=
generated, so in turn
we=E2=80=99d need to rebuild all of the C++ code.

=E2=80=98guix pull=E2=80=99 does the right thing though, which I think is m=
ore important
than the build tree.

> Side questions:
>
> 1) why don't you gitignore "doc/stamp-1"?

Good idea, done!  :-)

> 2) why don't you gitignore .po files?

Because they are checked in.

Thanks for your report.

Ludo=E2=80=99.




Information forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 11 Jun 2018 18:01:27 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Jun 11 14:01:27 2018
Received: from localhost ([127.0.0.1]:43655 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1fSR8A-0000HN-PD
	for submit <at> debbugs.gnu.org; Mon, 11 Jun 2018 14:01:27 -0400
Received: from eggs.gnu.org ([208.118.235.92]:46514)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <myglc2@HIDDEN>) id 1fSR89-0000Bj-DG
 for submit <at> debbugs.gnu.org; Mon, 11 Jun 2018 14:01:25 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <myglc2@HIDDEN>) id 1fSR83-0001H6-Gb
 for submit <at> debbugs.gnu.org; Mon, 11 Jun 2018 14:01:20 -0400
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org
X-Spam-Level: 
X-Spam-Status: No, score=0.3 required=5.0 tests=BAYES_40,
 FREEMAIL_ENVFROM_END_DIGIT,FREEMAIL_FROM,T_DKIM_INVALID autolearn=disabled
 version=3.3.2
Received: from lists.gnu.org ([2001:4830:134:3::11]:43915)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32)
 (Exim 4.71) (envelope-from <myglc2@HIDDEN>) id 1fSR83-0001Gn-D2
 for submit <at> debbugs.gnu.org; Mon, 11 Jun 2018 14:01:19 -0400
Received: from eggs.gnu.org ([2001:4830:134:3::10]:37481)
 by lists.gnu.org with esmtp (Exim 4.71)
 (envelope-from <myglc2@HIDDEN>) id 1fSR82-0007km-29
 for bug-guix@HIDDEN; Mon, 11 Jun 2018 14:01:18 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <myglc2@HIDDEN>) id 1fSR7y-0001By-Qf
 for bug-guix@HIDDEN; Mon, 11 Jun 2018 14:01:18 -0400
Received: from mail-qt0-x22b.google.com ([2607:f8b0:400d:c0d::22b]:46170)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <myglc2@HIDDEN>) id 1fSR7y-0001BM-Lk
 for bug-guix@HIDDEN; Mon, 11 Jun 2018 14:01:14 -0400
Received: by mail-qt0-x22b.google.com with SMTP id h5-v6so21100034qtm.13
 for <bug-guix@HIDDEN>; Mon, 11 Jun 2018 11:01:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=user-agent:from:to:subject:date:message-id:mime-version
 :content-transfer-encoding;
 bh=7vUeVzmuRM9THHbcDCKAqtQVqHufgsNZGhmCAxYreQQ=;
 b=gFzmDKmvknPl0GABwESS+GShxkUJasNoeN150hGN3ANOkFYR8uVc19RNNy9C5zXpQ8
 SC2/Cp6JzKz4vUHBnP2kWZIE8mED8yG76rZXSs8yDR/Y7TEJAX9feRt041iQFj0tHmaQ
 MphRYNlWmYjA2+LTwQc7XWyBGscsp/nqtMUKI3nSvKPSDrAw4CW77p5V8Iom4/u3Ccey
 kTZ/wLEw0PxSkc8/SyFQH+lAyTwXh62rt17JeaSIGuIJrGXaDpPYf77yuHg1xvJ30+Le
 2BlAqGYJp6vIv3heleGeOt6BBeyr5VswXvxp0P+VEhFc1p2DDhtgTOzNULpu83084GET
 Buug==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:user-agent:from:to:subject:date:message-id
 :mime-version:content-transfer-encoding;
 bh=7vUeVzmuRM9THHbcDCKAqtQVqHufgsNZGhmCAxYreQQ=;
 b=bQmz+zhejoOO+J6PwkSnaIptbp78wvDABXT4Q/Kklqu/qEYNfKxeJ6EG2T4vQDDGiA
 jA5FfjvTdhrhZYDNYpNQQc6FpXr+dGNnHRowg8vm8Dns0w5mmTDEUBzxUgaFao+W9BsN
 0FgRPd5FmNR+Xu8IPiEmbtQbgHTynwRvGBy9gHhO0P6jDL1R0lTL53jf++AyrhWhDdIE
 zWZU8IlVtjHi2+08YH3CwfwLapOadQe5zc+fOPZ5mGjy8SqJ3p2GQRyhe/YCfACxs6IO
 R5IkHePhzNPIqUkdv/cLsm5AOU4JFNjehKPXSVOVBQ9Z397sQVRt7c4SYjRnwJZpRiPY
 hFEg==
X-Gm-Message-State: APt69E0yG9JMBcuXVwCXrCaEClAVBl/b0Yu3P+AG0szKdHe4Vw2D9hZ+
 OBMdKsasII5JaHRhNIEIcwPhog==
X-Google-Smtp-Source: ADUXVKKTQg7AMi3qm/kJcV5UQHD6ciLZgDrRLuVejR2FO2UyGBDZWLXxF3IkCpvU5FXJoOVc42KXVg==
X-Received: by 2002:a0c:9621:: with SMTP id 30-v6mr175109qvx.127.1528740073588; 
 Mon, 11 Jun 2018 11:01:13 -0700 (PDT)
Received: from sysi31 (c-73-167-118-254.hsd1.ma.comcast.net. [73.167.118.254])
 by smtp.gmail.com with ESMTPSA id
 v123-v6sm30184239qka.79.2018.06.11.11.01.12 for <bug-guix@HIDDEN>
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Mon, 11 Jun 2018 11:01:12 -0700 (PDT)
User-agent: mu4e 1.0; emacs 25.3.1
From: George Clemmer <myglc2@HIDDEN>
To: bug-guix@HIDDEN
Subject: 'pre-inst-env guix --version' is not updated by new commits"
Date: Mon, 11 Jun 2018 14:01:11 -0400
Message-ID: <87r2lddwyg.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x
X-Received-From: 2001:4830:134:3::11
X-Spam-Score: -3.8 (---)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -4.8 (----)

When I clone and build Guix from scratch, it produces the untracked file
"doc/stamp-1" which contains the version number built into the Guix doc
and appears to be created from a call to 'git describe'.

But with subsequent git commit/make cycles the version does not
change. It doesn't change when the guix package is updated either. For
example, after pulling and building the recent commit updating the guix
package ...

commit 8b3aea9d9e022b20137cec93f668df8fa051abd9
Author: Ludovic Courtès <ludo@HIDDEN>
Date:   Sun Jun 10 23:31:01 2018 +0200

    gnu: guix: Update to 77a1aac.

    * gnu/packages/package-management.scm (guix): Update to 77a1aac.

g1@sysi31 ~/gom/.emacs.d/guix/guix [gmm]$ git describe 8b3aea9d9e022b20137cec93f668df8fa051abd9
v0.14.0-6300-g8b3aea9d9

"doc/stamp-1" and guix version remain "stuck" on June 8th ...

g1@sysi31 ~/gom/.emacs.d/guix/guix [gmm]$ cat doc/stamp-1
@set UPDATED 8 June 2018
@set UPDATED-MONTH June 2018
@set EDITION 0.14.0.5478-1458f7
@set VERSION 0.14.0.5478-1458f7

g1@sysi31 ~/gom/.emacs.d/guix/guix [gmm]$ ./pre-inst-env guix --version
guix (GNU Guix) 0.14.0.5478-1458f7

They remain stuck after 'make clean; make', and './bootstrap;
./configure; make' The only way I found to "unstick" them is 'sudo git
clean -dfx'.

Side questions:

1) why don't you gitignore "doc/stamp-1"?
2) why don't you gitignore .po files?

TIA - George




Acknowledgement sent to George Clemmer <myglc2@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-guix@HIDDEN. Full text available.
Report forwarded to bug-guix@HIDDEN:
bug#31786; Package guix. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Mon, 25 Nov 2019 12:00:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.