From unknown Sat Jun 14 19:37:12 2025 X-Loop: help-debbugs@gnu.org Subject: bug#40848: doc: chapter "Building from Git" in "Contributing" misses to list required packages Resent-From: Stefan Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Sat, 25 Apr 2020 13:41:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 40848 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: 40848@debbugs.gnu.org X-Debbugs-Original-To: bug-guix@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.15878220451875 (code B ref -1); Sat, 25 Apr 2020 13:41:01 +0000 Received: (at submit) by debbugs.gnu.org; 25 Apr 2020 13:40:45 +0000 Received: from localhost ([127.0.0.1]:59032 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSL2n-0000Tx-0d for submit@debbugs.gnu.org; Sat, 25 Apr 2020 09:40:45 -0400 Received: from lists.gnu.org ([209.51.188.17]:44709) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSKpn-00009U-4r for submit@debbugs.gnu.org; Sat, 25 Apr 2020 09:27:10 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:56900) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jSKpm-0003Ca-HN for bug-guix@gnu.org; Sat, 25 Apr 2020 09:27:06 -0400 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-2.6 required=5.0 tests=BAYES_00,RCVD_IN_DNSWL_LOW, SPF_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.90_1) (envelope-from ) id 1jSKpl-0001mT-BK for bug-guix@gnu.org; Sat, 25 Apr 2020 09:27:06 -0400 Received: from vsmx011.vodafonemail.xion.oxcs.net ([153.92.174.89]:62798) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jSKpk-0001lW-IS for bug-guix@gnu.org; Sat, 25 Apr 2020 09:27:05 -0400 Received: from vsmx003.vodafonemail.xion.oxcs.net (unknown [192.168.75.197]) by mta-5-out.mta.xion.oxcs.net (Postfix) with ESMTP id 72D8159D1D2 for ; Sat, 25 Apr 2020 13:26:57 +0000 (UTC) Received: from macbook-pro.kuh-wiese.my-router.de (unknown [94.220.249.231]) by mta-7-out.mta.xion.oxcs.net (Postfix) with ESMTPA id 4716A539A85 for ; Sat, 25 Apr 2020 13:26:55 +0000 (UTC) From: Stefan Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Message-Id: Date: Sat, 25 Apr 2020 15:26:54 +0200 Mime-Version: 1.0 (Mac OS X Mail 9.3 \(3124\)) X-Mailer: Apple Mail (2.3124) X-VADE-STATUS: LEGIT Received-SPF: pass client-ip=153.92.174.89; envelope-from=stefan-guix@vodafonemail.de; helo=vsmx011.vodafonemail.xion.oxcs.net X-detected-operating-system: by eggs.gnu.org: First seen = 2020/04/25 09:26:57 X-ACL-Warn: Detected OS = Linux 2.2.x-3.x (no timestamps) [generic] [fuzzy] X-Received-From: 153.92.174.89 X-Spam-Score: -2.3 (--) X-Mailman-Approved-At: Sat, 25 Apr 2020 09:40:31 -0400 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) Hi! The chapter "Building form Git" starts with two git commands to clone = and verify the code. Unfortunately it misses to mention before that two = packages are required for this to be working: git and gnupg. While the former is obvious, the gnupg package is not that obvious. If = you missed to install it, then the "git verify-commit" prints some error = messages with "error: cannot run gpg". And unfortunately gpg is not the = package name to install to solve this error. It would be beneficial, if the two required packages git (or = git-minimal?) and gnupg would be mentioned before starting with commands = which would fail otherwise. It would further help to repeat the wget command from the installation = section to fetch the keys necessary for this verification, as there are = other numbers printed beside the mentioned 3CE4645=E2=80=A6 However that wget command requires yet another package to be installed: = wget. Finally trying to verify commit f84b0363053e5479464f6ce6ded45f80360d90fc = it leaves this unresolved key:=20 gpg: Signatur vom Sa 28 M=C3=A4r 2020 21:30:07 CET gpg: mittels RSA-Schl=C3=BCssel = 39B33C8D94480D2DDCC2A4988B44A0CDC7B956F2 gpg: Signatur kann nicht gepr=C3=BCft werden: Kein =C3=B6ffentlicher = Schl=C3=BCssel The next command mentioned then is "make authenticate". It fails because = the make package first needs to be installed. But even if this is done, = it fails with "make: *** Keine Regel, um =E2=80=9Eauthenticate=E2=80=9C = zu erstellen. Schluss." There has yet no Makefile been created. Further down the commands "./bootstrap" and ".configure" are mentioned, = which are both required to create the needed Makefile. But to be able to = run this, all the listed dependencies need to be installed.=20 Only after struggling down to the failing "make authenticate" there is = the finally helpful command "guix environment guix =E2=80=94pure". So to sum it all up: the packages to install and missed to mention are =E2=80=A2 git (or git-minimal?) =E2=80=A2 gnupg =E2=80=A2 wget=20 The wget command to download the key should ideally be repeated. The = "make authenticate" command is not helpful at all to be mentioned that = early. It would instead be very helpful, if first "guix environment guix = =E2=80=94pure" would be mentioned, and if this (or a similar command) = would also provide git, gnupg and wget to be able to fetch and verify = the source code of guix as described by the first two commands "git = clone =E2=80=A6" and "git verify-commit =E2=80=A6". The "make authenticate" command must not be mentioned before but only = after the "./bootstrap" and "./configure" commands. Both "./bootstrap" = and "./configure" should ideally be boxed like the other commands. This = boxing would also help the important argument "--localstatedir=3D/var" = to not be overseen. In my case after all this and running ".configure" successfully, "make = authenticate" still failed, because I relied on "guix environment guix = =E2=80=94pure" to have a dependency to gnupg to have the gpg command = accessible, which is unfortunately not the case. I then exited the environment and started a new one with "guix = environment guix --pure --ad-hoc gnupg" and ran "make authenticate" now = with this result: stefan@guix ~/development/guix [env]$ make authenticate Authenticating Git checkout... Authenticating d68de95 to f84b036 (14629 commits)... [### = ]Backtrace: 12 (apply-smob/1 #) In ice-9/boot-9.scm: 705:2 11 (call-with-prompt _ _ #) In ice-9/eval.scm: 619:8 10 (_ #(#(#))) 293:34 9 (_ #(#(#(#(#(#(#(#(#(#(# ?) ?) ?) ?) ?) ?) ?) ?) ?) ?)) In ice-9/boot-9.scm: 142:2 8 (dynamic-wind _ _ #) 152:2 7 (with-fluid* _ _ _) In srfi/srfi-1.scm: 466:18 6 (fold # ?) In ice-9/eval.scm: 293:34 5 (_ #(#(# # ?) ?)) 619:8 4 (_ #(#(#(#) # ?) ?)) 626:19 3 (_ #(#(#(#) # ?) ?)) In ice-9/boot-9.scm: 152:2 2 (with-fluid* _ _ _) 142:2 1 (dynamic-wind # ?) 142:2 0 (dynamic-wind # ?) ice-9/boot-9.scm:142:2: In procedure dynamic-wind: Throw to key `srfi-34' with args `(#)'. make: *** [Makefile:5895: authenticate] Error 1 The documentation then finally suggest to run "make check". Isn't the = actual build step with "make" missing? I'm currently using=20 guix describe Generation 5 28. M=C3=A4rz 2020 18:44:49 (aktuell) guix e425713 Repository-URL: https://git.savannah.gnu.org/git/guix.git Branch: master Commit: e4257138fe1d924c56c9979b75319585b9251fb7 My profile is empty, no installed packages =E2=80=93 I removed all = packages again after obtaining the source code and before running "guix = environment guix --pure --ad-hoc gnupg". Bye Stefan=