From mboxrd@z Thu Jan 1 00:00:00 1970 From: ludo@gnu.org (Ludovic =?UTF-8?Q?Court=C3=A8s?=) Subject: bug#31786: 'pre-inst-env guix --version' is not updated by new commits" Date: Wed, 13 Jun 2018 08:54:49 +0200 Message-ID: <87wov3npl2.fsf@gnu.org> References: <87r2lddwyg.fsf@gmail.com> <87k1r4p2ca.fsf@gnu.org> <87k1r3271g.fsf@gmail.com> <87d0wvoicy.fsf@gnu.org> <87o9gf5x0t.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:33838) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fSzhO-0002ix-Vp for bug-guix@gnu.org; Wed, 13 Jun 2018 02:56:08 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fSzhK-0005Rh-0F for bug-guix@gnu.org; Wed, 13 Jun 2018 02:56:07 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:37789) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fSzhJ-0005RW-S8 for bug-guix@gnu.org; Wed, 13 Jun 2018 02:56:01 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fSzhJ-0000l4-L8 for bug-guix@gnu.org; Wed, 13 Jun 2018 02:56:01 -0400 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <87o9gf5x0t.fsf@gmail.com> (George Clemmer's message of "Tue, 12 Jun 2018 20:51:30 -0400") List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: "bug-Guix" To: George Clemmer Cc: 31786@debbugs.gnu.org Hello, George Clemmer skribis: > Ludovic Court=C3=A8s writes: > >> George Clemmer 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.