From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: bug#31786: 'pre-inst-env guix --version' is not updated by new commits" Date: Sat, 16 Jun 2018 00:02:04 +0200 Message-ID: <87po0r674z.fsf@elephly.net> References: <87r2lddwyg.fsf@gmail.com> <87k1r4p2ca.fsf@gnu.org> <87k1r3271g.fsf@gmail.com> <87d0wvoicy.fsf@gnu.org> <87o9gf5x0t.fsf@gmail.com> <87wov3npl2.fsf@gnu.org> <20180614013938.GD29167@jasmine.lan> <87d0wttn0v.fsf@gmail.com> <87k1r1z5o0.fsf@gnu.org> <8736xnj22c.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]:33673) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fTxWj-0002Fu-O7 for bug-guix@gnu.org; Fri, 15 Jun 2018 18:49:06 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fTxWg-0006L8-Gb for bug-guix@gnu.org; Fri, 15 Jun 2018 18:49:05 -0400 Received: from debbugs.gnu.org ([208.118.235.43]:42828) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fTxWg-0006KJ-Bg for bug-guix@gnu.org; Fri, 15 Jun 2018 18:49:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fTxWf-00056V-SL for bug-guix@gnu.org; Fri, 15 Jun 2018 18:49:01 -0400 Sender: "Debbugs-submit" Resent-Message-ID: In-reply-to: <8736xnj22c.fsf@gmail.com> 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: =?UTF-8?Q?Cl=C3=A9ment?= Lassieur , 31786@debbugs.gnu.org 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