From unknown Sun Jun 22 00:23:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#68505: [PATCH v2] Add more detailed instructions into the HACKING file. Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Tue, 16 Jan 2024 12:53:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 68505 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 68505@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz> X-Debbugs-Original-To: bug-guile@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.170540953317838 (code B ref -1); Tue, 16 Jan 2024 12:53:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Jan 2024 12:52:13 +0000 Received: from localhost ([127.0.0.1]:48076 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rPivM-0004de-Tu for submit@debbugs.gnu.org; Tue, 16 Jan 2024 07:52:13 -0500 Received: from lists.gnu.org ([2001:470:142::17]:46258) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1rPivL-0004dI-Gs for submit@debbugs.gnu.org; Tue, 16 Jan 2024 07:52:11 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1rPivF-00042M-FL for bug-guile@gnu.org; Tue, 16 Jan 2024 07:52:05 -0500 Received: from wolfsden.cz ([37.205.8.62]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1rPivC-0004Xm-RL for bug-guile@gnu.org; Tue, 16 Jan 2024 07:52:05 -0500 Received: by wolfsden.cz (Postfix, from userid 104) id 41597256C40; Tue, 16 Jan 2024 12:52:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1705409520; bh=u2zVDWlDHnq3NaePZBg35DxbdfNyjlp4ypDvPYUsoCk=; h=From:To:Cc:Subject:Date; b=h9kAWfq9IyN6WaGvl5tMmOwF6nqZYne8wvLdBFSe+V7qZ4T//BFwmdDWaai4P4wGQ Mv/IpBEGErHckBl2zYbf42GcxlaiVWBJAIb6OoRI3E0GxNIQT0Pa1LDMrbeBIgMHay lHy2bKyOND5yW7SYe9ctFMZKd5BPb01AnHiq/wVCu3HD62JIzfGhlU6xh7rT5mJww5 12e6ArF0iKuWEY8x2Zy1BZlkrGpXiHkA/Ls6xXLOecFmAks2gxtXeyYn4h08rgtoY9 vK/uc43IOWf2AI7gk8J+b1qOZRa3JR7NnSmMCUdkH4xK1cjl6f3fU0MC9GM3CCNwHB vOOJGeiYU1hcpTb7rt8CYNp9U/JcAzSGo9c03g9qUUY4XlKHFitFt1Gf0WgI6JO40Z srA0992+329Csm1lWvyrzSBJOLbTGLciH65Mn4A53UpkTrgN8g3w37AJj3E1Jrx0e0 GigP/FtVPKMjzXK0gr6P3r/0sWzgY8Dynb4rew712bdVaAOUNecpGCKuRkGlh0a0Gr 1czGjllMY7B/VZNq1T1JEFFCGCOX01gtr/RHHOv4nT5jwb4rBqXk58rujGAc+yJu9V /rXUemoN4Hamcv3pxdNs6Qrcma/TuQFmmjdPDmIvOUmjfvdOdSr44YM56k0U49/Vor hhx3y9tOy57wmNqb4AQPNU+k= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,T_SCC_BODY_TEXT_LINE, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [81.17.16.72]) by wolfsden.cz (Postfix) with ESMTPSA id 8FC77256C39; Tue, 16 Jan 2024 12:51:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1705409519; bh=u2zVDWlDHnq3NaePZBg35DxbdfNyjlp4ypDvPYUsoCk=; h=From:To:Cc:Subject:Date; b=f4rgnNBL/fDuAM8ybxX5Eip9z48j/CykALNWDfkUP//8NBLPJF58+FWVz7AQVFfxQ z4xAA2l4DiidBWMnIN9QdBgRJi2p4wTzu3/Ple8Q1ZTPtECaITk43OI5kB4SHDs9Rr KWfvP5txwqIsXWfXayHovAQqKEfiMXTZnmlwwJBNmZN/6OvyX7BmBf2GUpyi8ntVb3 fOcjvZQztW3HxZe4/5TgEs2Q4iSIjNu1hzN7XvN9QAdvMWPWxvyaxUnyq9MAtuZ3ot qv22e3dKKq4YNifdBkvY/Id6Za65FUpX7m2WsPmq8ce1o+iMqZgU557NWu35Yiy2Ak +PyK7xI6FQM9HJfLhG4pCD+Ak9r3MoZbIEqBPJRX/acSTizYuD1QNF2zHtJq/pU3yI liVYLXEjJJWznprSz6+o9kALBG4Le9WUxh/Npp/F1RsHfmVR1xMgXRMt18RxUjvt1q 9KjGqK3LWNTirm18g96fPwDSm1LjjLt9DOdvd1sKluqNSKxWomtCBkBuyhrlEpQXET 52PzAq8wAw8teix4JP1l+KC+UybeBIklIQF918IGULx1d3u7iHq/7zmOCwT6cQEAC9 1AZJsWteUbxyagHXXff0FQkNRGcXBIzNqPl/Xr+XUDEq/0nlcQrBL3nhX8WVSk1Ywd bPhli2sLwYkhUi0c0DBok6ho= From: Tomas Volf <~@wolfsden.cz> Date: Tue, 16 Jan 2024 13:50:26 +0100 Message-ID: <20240116125109.14779-1-~@wolfsden.cz> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=37.205.8.62; envelope-from=~@wolfsden.cz; helo=wolfsden.cz X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) 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: -0.0 (/) Until now, the ./meta/guile was not mentioned anywhere, and therefore it was not obvious how to run the locally compiled Guile without installing it. While modifying the file, I took the liberty to also mention a bit about compiling Guile using Guix. Finally, the header lines where cleaned up, ensuring all of them end at 70 and have a leading space. * HACKING (Hacking It Yourself): Add Guix instructions. Add a note about meta/guile script. (Sample GDB Initialization File), (Naming conventions): Clean up the header line. --- v2: Add note regarding JIT and GNU Hurd. Add note regarding -fexcess-precision. Add --disable-static and explain it. Previous discussion happened on the mailing list. HACKING | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/HACKING b/HACKING index 387643bf7..5926fb275 100644 --- a/HACKING +++ b/HACKING @@ -26,6 +26,40 @@ http://www.gnu.org/software/guile/mail/mail.html for more info. Hacking It Yourself ================================================== +You can spawn a shell with all the required dependencies using GNU Guix +by running the following command: + + guix shell -D -f guix.scm --pure + +In this way, you can effortlessly compile Guile from the Git checkout +with just these three lines: + + guix shell -D -f guix.scm --pure -- ./autogen.sh + guix shell -D -f guix.scm --pure -- ./configure \ + --enable-mini-gmp --disable-static + guix shell -D -f guix.scm --pure -- make + +Disabling of the static libraries is optional, but it does speed up the +builds, and you are unlikely to need them for local development. + + Note: Currently JIT causes Guile to crash in obscure ways on GNU Hurd, + so on that platform you want to also pass the --disable-jit flag + to the configure script. + + Note: On any i*86 architecture, you also need to pass in the compiler + flag -fexcess-precision=standard in order to get the test suite + to pass. That can be done by passing an additional argument to + the configure script: + CFLAGS='-g -O2 -fexcess-precision=standard' + +Once that finishes, you can execute your newly compiled Guile using the +./meta/guile script: + + $ ./meta/guile -v | head -n1 + guile (GNU Guile) 3.0.9.139-d7cf5-dirty + +For more manual approach, read on. + When Guile is obtained from Git, a few extra steps must be taken before the usual configure, make, make install. You will need to have up-to-date versions of the tools as listed below, correctly installed. @@ -73,7 +107,7 @@ Here is the authoritative list of tool/version/platform tuples that have been known to cause problems, and a short description of the problem. -Sample GDB Initialization File========================================= +Sample GDB Initialization File ======================================= In GDB, you probably want to load the gdbinit file included with Guile, which defines a number of GDB helpers to inspect Scheme values. @@ -215,7 +249,7 @@ The goal is to reduce (and over time, eliminate) spurious diffs. For Emacs users: (add-hook 'before-save-hook 'delete-trailing-whitespace) -Naming conventions ================================================= +Naming conventions =================================================== We use certain naming conventions to structure the considerable number of global identifiers. All identifiers should be either all lower -- 2.41.0 From unknown Sun Jun 22 00:23:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#68505: [PATCH v2] Add more detailed instructions into the HACKING file. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Wed, 24 Jan 2024 10:19:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68505 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: Tomas Volf <~@wolfsden.cz> Cc: 68505@debbugs.gnu.org Received: via spool by 68505-submit@debbugs.gnu.org id=B68505.170609152317689 (code B ref 68505); Wed, 24 Jan 2024 10:19:01 +0000 Received: (at 68505) by debbugs.gnu.org; 24 Jan 2024 10:18:43 +0000 Received: from localhost ([127.0.0.1]:44516 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rSaLD-0004bE-44 for submit@debbugs.gnu.org; Wed, 24 Jan 2024 05:18:43 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:32898) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rSaLB-0004b1-6b for 68505@debbugs.gnu.org; Wed, 24 Jan 2024 05:18:41 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rSaKz-000410-Hr; Wed, 24 Jan 2024 05:18:29 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=8+Xxx4VsDZC8hxSbPJAgSXVllEJhDmE6AUipBxdIFHI=; b=hN9k1uYdbXr9A4Ucmf1M OLjoONil218JKOhhTs3PzKMsBJVYtINoVRA6McBjsmABvdXQJBvzktG8rpDPDhhhNFoNUo2pikwcl jAc9pAXOhoDklorRXcUudKFs4k71aiaR4n+VABEXHUozFz6JnAj3tLPZ19AKHDFFPwJYI32DJlfhL O928YDNwwfhNe9bCEF4J6V0cH1UaXU3F/fgJ6s4W+/n6PE01sJEXgmwuyGN6kovZ21nG91atG6BNA CPXTNMCO/5j6/+0Hrl4DYUamRpdriZSEnWbq+63JI6MsOEPkSPJlKqVandsiilVSPAe7ev1T8hReM SAd8h3OAZQ71LA==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= In-Reply-To: <20240116125109.14779-1-~@wolfsden.cz> (Tomas Volf's message of "Tue, 16 Jan 2024 13:50:26 +0100") References: <20240116125109.14779-1-~@wolfsden.cz> Date: Wed, 24 Jan 2024 11:18:27 +0100 Message-ID: <87sf2nuj9o.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Score: -2.3 (--) 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: -3.3 (---) Hi, Tomas Volf <~@wolfsden.cz> skribis: > Until now, the ./meta/guile was not mentioned anywhere, and therefore it > was not obvious how to run the locally compiled Guile without installing > it. > > While modifying the file, I took the liberty to also mention a bit about > compiling Guile using Guix. > > Finally, the header lines where cleaned up, ensuring all of them end at > 70 and have a leading space. > > * HACKING (Hacking It Yourself): Add Guix instructions. Add a note > about meta/guile script. > (Sample GDB Initialization File), > (Naming conventions): Clean up the header line. > --- > v2: > Add note regarding JIT and GNU Hurd. Add note regarding -fexcess-precisi= on. > Add --disable-static and explain it. Much welcome addition! > +You can spawn a shell with all the required dependencies using GNU Guix > +by running the following command: > + > + guix shell -D -f guix.scm --pure I would suggest running: guix shell -CP (Currently =E2=80=98README=E2=80=99 suggests =E2=80=98guix shell=E2=80=99.) The rationale is: it=E2=80=99s shorter, using a container avoids interferen= ce, and =E2=80=98-P=E2=80=99 works well with =E2=80=98config.cache=E2=80=99 & c= o. (because the cached file names then are $HOME/.guix-profile/=E2=80=A6). WDYT? Thanks, Ludo=E2=80=99. From unknown Sun Jun 22 00:23:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#68505: [PATCH v3] Add more detailed instructions into the HACKING file. References: <20240116125109.14779-1-~@wolfsden.cz> In-Reply-To: <20240116125109.14779-1-~@wolfsden.cz> Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Wed, 24 Jan 2024 16:56:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68505 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: 68505@debbugs.gnu.org Cc: Tomas Volf <~@wolfsden.cz> Received: via spool by 68505-submit@debbugs.gnu.org id=B68505.17061153449861 (code B ref 68505); Wed, 24 Jan 2024 16:56:01 +0000 Received: (at 68505) by debbugs.gnu.org; 24 Jan 2024 16:55:44 +0000 Received: from localhost ([127.0.0.1]:46448 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rSgXP-0002Yx-LK for submit@debbugs.gnu.org; Wed, 24 Jan 2024 11:55:44 -0500 Received: from wolfsden.cz ([37.205.8.62]:50754) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1rSgXN-0002Yg-FZ for 68505@debbugs.gnu.org; Wed, 24 Jan 2024 11:55:42 -0500 Received: by wolfsden.cz (Postfix, from userid 104) id 492012758C8; Wed, 24 Jan 2024 16:55:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1706115334; bh=4P9kjGL5h4A91V7vEijolFP4AgzItBU1yaLhEGWALNY=; h=From:To:Cc:Subject:Date; b=wHXa2Vg/pCxuNAbEP3dl+kdeYF4rLphpdWThEbnKerKl09OnYVyIs1WPlwR4tYSO4 /Ve/8HHuy0nq6LGAAw+zRX5Bt5pv0p++dDHqLQ4YLfYKpLQgKhNxp1kNxZkOZRPjyx EEKLJ0i/wzQ4n6fA7+9DgqdylNrDvQuJFoK4SKXCGZGsY7w/QGWU3j9ryt9LulXcq3 cco8hhe1oVgdqTQltUq0ndshqA4vBC8RQynlmLazM9E4jZXEy/sbbdKocllwckHDjt JfrKde/3sINku3m+6JC3j/6aaGZu1crwe3eKjZMPeTw3e3D69Ink1pVVx4feuInJuQ J7Fkwa7alAODpsgysYEzyv65lUDUnZNzUik24qYBCIYSdSVljBG9xMNtl/OQzXe4cW qAcgPyqezufShXFGOhh++cAcQMG1M3MPDnjzMg3JC2pUVXr/DXpRhB0uKYb+IWu8Lk dREY73XMvLCwkLJBl6KGWtUz272wx7BcikpaksDY0eiA9jeuBZjvasX2X4BSGhf39i JesE9+QnlsZGfQueW0GSEXxs2w3Eyso4uOdgTSCtbRb1S569q76DTP0EHxkq6t2dxa fWhac63RUCWk5wJD5Ilw6zo59L1vUcKJrjiTZDzYGjMJEtIj7B7BVPOXbwaLglHRMt YKmsUSkAQ3h7cxyaxyQIfjpA= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,T_SCC_BODY_TEXT_LINE, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [146.70.134.137]) by wolfsden.cz (Postfix) with ESMTPSA id BBE10276C28; Wed, 24 Jan 2024 16:55:33 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1706115333; bh=4P9kjGL5h4A91V7vEijolFP4AgzItBU1yaLhEGWALNY=; h=From:To:Cc:Subject:Date; b=RlXguFk+bzQ4AypPIEc+u8KfEM5ZeNTY9fDdpUgXSIbw3tBZkb1doluE9JQkSvOLd 0d41TdGpG7M04XKQ9vmmvbIHE+Bjjr6Xdj7pQL6UQZXf4CVoJcsvnAezq3kAtLkmiW eWeHtyZNOEwi5n5a35u62/RFcCLNshVFu+QB9BLwAmwQ7B6gDNuImb06uKpWx3Zcl2 Ns5T0WmGww3H5YoUS2SAR2rtvO0tkTlCJexutc89JS+eOo5GvPSkb5Mwb1nbwemq71 snxXl8COFx2VO9CZAfJ8pZC5QhZGDpeaIfrMLcUf1U6/DJj21Adp+Y6E3fmNaknBxz SIKV2DJwxqB4MyC4cjNTTveRX1b051NT5of+mqGNoGMbuZhmX4ctkXvLZkPrguNDUE orrlHaV4xNQAmJGstRwXX0RmYt+b+8xjTZcnxJ3IaT9q9joNbe/KyMNT4y1KZ1aYIX 7b5ja6pLwmd50CkViVebv3thaMW69dEYaMne+qJOFJjQb1MopMXU1KK+ti35s78JRx sA07ksDZwN7BLDLiQAMG73E1PWOfxo+UkSeGxu9OgqzvvtB8iRX6LitVkAMCDOfSqe KB4b942e5ivqrAishfQty/3rZAOcUo/tP4TnlMAteRLm/f2NPO8E1ApvipEWs12HPS vlD76tDFEP3CEdVIoinAAXw4= From: Tomas Volf <~@wolfsden.cz> Date: Wed, 24 Jan 2024 17:48:04 +0100 Message-ID: <20240124165526.19035-1-~@wolfsden.cz> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Score: -0.0 (/) 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 (-) Until now, the ./meta/guile was not mentioned anywhere, and therefore it was not obvious how to run the locally compiled Guile without installing it. While modifying the file, I took the liberty to also mention a bit about compiling Guile using Guix. Finally, the header lines where cleaned up, ensuring all of them end at 70 and have a leading space. * HACKING (Hacking It Yourself): Add Guix instructions. Add a note about meta/guile script. (Sample GDB Initialization File), (Naming conventions): Clean up the header line. --- v2: Add note regarding JIT and GNU Hurd. Add note regarding -fexcess-precision. Add --disable-static and explain it. v3: Use -CP instead of --pure. HACKING | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/HACKING b/HACKING index 387643bf7..94fba199c 100644 --- a/HACKING +++ b/HACKING @@ -26,6 +26,40 @@ http://www.gnu.org/software/guile/mail/mail.html for more info. Hacking It Yourself ================================================== +You can spawn a shell with all the required dependencies using GNU Guix +by running the following command: + + guix shell -D -f guix.scm --pure + +In this way, you can effortlessly compile Guile from the Git checkout +with just these three lines: + + guix shell -CP -D -f guix.scm -- ./autogen.sh + guix shell -CP -D -f guix.scm -- ./configure \ + --enable-mini-gmp --disable-static + guix shell -CP -D -f guix.scm -- make + +Disabling of the static libraries is optional, but it does speed up the +builds, and you are unlikely to need them for local development. + + Note: Currently JIT causes Guile to crash in obscure ways on GNU Hurd, + so on that platform you want to also pass the --disable-jit flag + to the configure script. + + Note: On any i*86 architecture, you also need to pass in the compiler + flag -fexcess-precision=standard in order to get the test suite + to pass. That can be done by passing an additional argument to + the configure script: + CFLAGS='-g -O2 -fexcess-precision=standard' + +Once that finishes, you can execute your newly compiled Guile using the +./meta/guile script: + + $ guix shell -CP -D -f guix.scm -- ./meta/guile -v | head -n1 + guile (GNU Guile) 3.0.9.139-d7cf5-dirty + +For more manual approach, read on. + When Guile is obtained from Git, a few extra steps must be taken before the usual configure, make, make install. You will need to have up-to-date versions of the tools as listed below, correctly installed. @@ -73,7 +107,7 @@ Here is the authoritative list of tool/version/platform tuples that have been known to cause problems, and a short description of the problem. -Sample GDB Initialization File========================================= +Sample GDB Initialization File ======================================= In GDB, you probably want to load the gdbinit file included with Guile, which defines a number of GDB helpers to inspect Scheme values. @@ -215,7 +249,7 @@ The goal is to reduce (and over time, eliminate) spurious diffs. For Emacs users: (add-hook 'before-save-hook 'delete-trailing-whitespace) -Naming conventions ================================================= +Naming conventions =================================================== We use certain naming conventions to structure the considerable number of global identifiers. All identifiers should be either all lower -- 2.41.0 From unknown Sun Jun 22 00:23:30 2025 X-Loop: help-debbugs@gnu.org Subject: bug#68505: [PATCH v2] Add more detailed instructions into the HACKING file. Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Wed, 24 Jan 2024 17:00:03 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 68505 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 68505@debbugs.gnu.org Received: via spool by 68505-submit@debbugs.gnu.org id=B68505.170611555810202 (code B ref 68505); Wed, 24 Jan 2024 17:00:03 +0000 Received: (at 68505) by debbugs.gnu.org; 24 Jan 2024 16:59:18 +0000 Received: from localhost ([127.0.0.1]:46455 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rSgas-0002eU-DH for submit@debbugs.gnu.org; Wed, 24 Jan 2024 11:59:18 -0500 Received: from wolfsden.cz ([37.205.8.62]:57486) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1rSgap-0002eL-E0 for 68505@debbugs.gnu.org; Wed, 24 Jan 2024 11:59:16 -0500 Received: by wolfsden.cz (Postfix, from userid 104) id E7D2C277389; Wed, 24 Jan 2024 16:59:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1706115548; bh=eMhFe5p8PtOEfXCErj4n/T7Yl+Annn9UIyZ8EMmYydc=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=cPZq4B3LBjkS3wtdGrjVHOqxC1/3G47ycmdKIybiYlXIiZmEmZ50hbhcUZILlLeDD YsM94OAazOG7JsfU81bG1TpoMm/daDfwaiEpudqryc8fRKGORTqnSSqdtjSp48g4Rp 6mJnW1pcgsnAhQSni2uxOWIf9lJ4tLMgUCEjziW2oZhzj97jCTtVTwP6Z45MQxpdWm jaVTJX70yNvOeB4nmi0o1vpe9S0e8QgB7iZ5PkFLCNj3KWHS3doIEdeZcAYNiow9go SiIK99p2YEHBiLiaJZ1A1MkNyIWgkMEepXl6GT+JulbamD7+yEqqfzQcSEWrIyCMvH g4TEySyuD3ndMxB1i3v8NTnYjfmvgpMbQ3TvYaNQvzgE6AvlYAxW1JDFLfG2977Qu4 zbSS7O8tU+1R19hzGeLqF+y9/CGduM/6nQb0BASK4XxAByIal7BSyQGvLfDMmhJtWI oSxG1Um2FioGqkEEevdM/g4gmBwepUOLPNoIsccHfd39Zo9Tkry/cHpY2ubQRzrMw+ 8qqH5kWDp90ASxnQsQ6NXaCCk/e2bfl/UYJyVQEKRU0zFoVvyF7tvkWl1WUsvt2PGV MKUXs0VUBH4SThtPpFZrdNg+XSAK79jDb8DEIbn/Ai5XbUefX9C9YwR1DTw1vafNK0 9vJime00Ir2mk4lK1UwYJEJE= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,T_SCC_BODY_TEXT_LINE, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [146.70.134.137]) by wolfsden.cz (Postfix) with ESMTPSA id 8509A277387; Wed, 24 Jan 2024 16:59:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1706115548; bh=eMhFe5p8PtOEfXCErj4n/T7Yl+Annn9UIyZ8EMmYydc=; h=Date:From:To:Cc:Subject:References:In-Reply-To; b=cPZq4B3LBjkS3wtdGrjVHOqxC1/3G47ycmdKIybiYlXIiZmEmZ50hbhcUZILlLeDD YsM94OAazOG7JsfU81bG1TpoMm/daDfwaiEpudqryc8fRKGORTqnSSqdtjSp48g4Rp 6mJnW1pcgsnAhQSni2uxOWIf9lJ4tLMgUCEjziW2oZhzj97jCTtVTwP6Z45MQxpdWm jaVTJX70yNvOeB4nmi0o1vpe9S0e8QgB7iZ5PkFLCNj3KWHS3doIEdeZcAYNiow9go SiIK99p2YEHBiLiaJZ1A1MkNyIWgkMEepXl6GT+JulbamD7+yEqqfzQcSEWrIyCMvH g4TEySyuD3ndMxB1i3v8NTnYjfmvgpMbQ3TvYaNQvzgE6AvlYAxW1JDFLfG2977Qu4 zbSS7O8tU+1R19hzGeLqF+y9/CGduM/6nQb0BASK4XxAByIal7BSyQGvLfDMmhJtWI oSxG1Um2FioGqkEEevdM/g4gmBwepUOLPNoIsccHfd39Zo9Tkry/cHpY2ubQRzrMw+ 8qqH5kWDp90ASxnQsQ6NXaCCk/e2bfl/UYJyVQEKRU0zFoVvyF7tvkWl1WUsvt2PGV MKUXs0VUBH4SThtPpFZrdNg+XSAK79jDb8DEIbn/Ai5XbUefX9C9YwR1DTw1vafNK0 9vJime00Ir2mk4lK1UwYJEJE= Date: Wed, 24 Jan 2024 17:59:07 +0100 From: Tomas Volf <~@wolfsden.cz> Message-ID: References: <20240116125109.14779-1-~@wolfsden.cz> <87sf2nuj9o.fsf@gnu.org> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha512; protocol="application/pgp-signature"; boundary="TFVrEuCt7xSmbGa0" Content-Disposition: inline In-Reply-To: <87sf2nuj9o.fsf@gnu.org> X-Spam-Score: -0.0 (/) 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 (-) --TFVrEuCt7xSmbGa0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Thank you for the review. On 2024-01-24 11:18:27 +0100, Ludovic Court=C3=A8s wrote: > > +You can spawn a shell with all the required dependencies using GNU Guix > > +by running the following command: > > + > > + guix shell -D -f guix.scm --pure > > I would suggest running: > > guix shell -CP > > (Currently =E2=80=98README=E2=80=99 suggests =E2=80=98guix shell=E2=80=99= =2E) > > The rationale is: it=E2=80=99s shorter, using a container avoids interfer= ence, > and =E2=80=98-P=E2=80=99 works well with =E2=80=98config.cache=E2=80=99 &= co. (because the cached file > names then are $HOME/.guix-profile/=E2=80=A6). > > WDYT? Modified as agreed on irc. I am not convinced on the -P, but I defer to yo= ur judgment on this. Have a nice day, Tomas Volf -- There are only two hard things in Computer Science: cache invalidation, naming things and off-by-one errors. --TFVrEuCt7xSmbGa0 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCgAdFiEEt4NJs4wUfTYpiGikL7/ufbZ/wakFAmWxQdsACgkQL7/ufbZ/ wanaEw/+JZG37F3yhm5oHb5FcB85TXB76SDlvD6KdJ3usga3EWDIxWhnrKs7Qs1N nN4hTGf727BAMzGeQ7tEsLdTofgNvyO2RrBxeYHShwZevXDBLt/aW608UUiGm+iD ptwHt59aDvi6pIodlLSzDlat97VM0OGOydHmF91++EGryST33OHcCGeQRBSrn2mc CYT60qrTldNEJkBqBnix8g5jGnD7jfVE43muk8MaI07Lw/KXYeKqnGVQcrTiyBAs IO+mpNeZy2gUH3A3MLWIRh2Lslo770s9S4l7pavBNWAXUWVqfpHcvk1nxcRwAZ59 gMWoZd9M7C+4+sgZoY5xd/sU0gTXZO9DVVYdc6Nd5gA1dlECmzruHnsgjCTYFyWB vOrKFjMwqsf2y7D1YiS6NRWhctYv/qQgw+QDYU99QQ7GAWsZYeUhObw9K3SbQfL5 eMWXkfthxZ4yVFGshltqq8AXEffJxzhFpBUoIze28UeCh1xAeoQfKyysRmMobwXe +KFZ5A4NuiKskggq6zG1yz+abMofYQPYZ6yFZ69Y2A+ErnwvXtOGxvPd0q//TGjR kYja9GrqQNnbMHAu0+NNIq4zMyCHF2dYvoWN3cWJC4p/gOdoIWyV20o5CzlMRn3m r6BrvepEVNu+lD+mdVTEEuGNTmMv6KTx9SFPhiE5vCn/k8x+NUs= =5P5s -----END PGP SIGNATURE----- --TFVrEuCt7xSmbGa0-- From unknown Sun Jun 22 00:23:30 2025 MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) X-Loop: help-debbugs@gnu.org From: help-debbugs@gnu.org (GNU bug Tracking System) To: Tomas Volf <~@wolfsden.cz> Subject: bug#68505: closed (Re: bug#68505: [PATCH v2] Add more detailed instructions into the HACKING file.) Message-ID: References: <87v87cp8vv.fsf_-_@gnu.org> <20240116125109.14779-1-~@wolfsden.cz> X-Gnu-PR-Message: they-closed 68505 X-Gnu-PR-Package: guile X-Gnu-PR-Keywords: patch Reply-To: 68505@debbugs.gnu.org Date: Mon, 29 Jan 2024 13:28:02 +0000 Content-Type: multipart/mixed; boundary="----------=_1706534882-13820-1" This is a multi-part message in MIME format... ------------=_1706534882-13820-1 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Your bug report #68505: [PATCH v2] Add more detailed instructions into the HACKING file. which was filed against the guile package, has been closed. The explanation is attached below, along with your original report. If you require more details, please reply to 68505@debbugs.gnu.org. --=20 68505: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D68505 GNU Bug Tracking System Contact help-debbugs@gnu.org with problems ------------=_1706534882-13820-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at 68505-done) by debbugs.gnu.org; 29 Jan 2024 13:27:52 +0000 Received: from localhost ([127.0.0.1]:59305 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rURfz-0003aU-U6 for submit@debbugs.gnu.org; Mon, 29 Jan 2024 08:27:52 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:37700) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rURfy-0003aH-25 for 68505-done@debbugs.gnu.org; Mon, 29 Jan 2024 08:27:50 -0500 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rURfi-0005a2-JD; Mon, 29 Jan 2024 08:27:34 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=4uVSLXc2cKY3KNFNbt+4lXh1SK3LvoBB86LH2qRGmoU=; b=THGcycbq5UozVqOvBs9c gZfiTMhIguWXNBWmvyuc5gXuyxT9aPD5oB+Lc1NfueKv+DEWGoE7ll2ou7W7RqCXbpwESN+EzvwAA aoCVdopCu0KayG3HszWA9agiifs0U+XuvpGocDDQHt43KD6OEXLqGGtjnxUz1uG8lErU0q6reS40S apnKWVJhW5QN7Lad2FtviQvWP2OfA5zjPJ4ZqbP4HoOzUlcBr50sLU6EyscktK1YOqbWysS4pNflH GZOYg63dYxSAxZp7Z6lRPvArfym140G4CP4UlqJxo8jCGFoVjsZkNHJJOmjNuihij1YQ0F6B8qKlI xHF0HFU/S8JCYg==; From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: Tomas Volf <~@wolfsden.cz> Subject: Re: bug#68505: [PATCH v2] Add more detailed instructions into the HACKING file. In-Reply-To: <20240124165526.19035-1-~@wolfsden.cz> (Tomas Volf's message of "Wed, 24 Jan 2024 17:48:04 +0100") References: <20240116125109.14779-1-~@wolfsden.cz> <20240124165526.19035-1-~@wolfsden.cz> Date: Mon, 29 Jan 2024 14:27:32 +0100 Message-ID: <87v87cp8vv.fsf_-_@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 68505-done Cc: 68505-done@debbugs.gnu.org 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: -3.3 (---) Tomas Volf <~@wolfsden.cz> skribis: > Until now, the ./meta/guile was not mentioned anywhere, and therefore it > was not obvious how to run the locally compiled Guile without installing > it. > > While modifying the file, I took the liberty to also mention a bit about > compiling Guile using Guix. > > Finally, the header lines where cleaned up, ensuring all of them end at > 70 and have a leading space. > > * HACKING (Hacking It Yourself): Add Guix instructions. Add a note > about meta/guile script. > (Sample GDB Initialization File), > (Naming conventions): Clean up the header line. Applied, thanks! ------------=_1706534882-13820-1 Content-Type: message/rfc822 Content-Disposition: inline Content-Transfer-Encoding: 7bit Received: (at submit) by debbugs.gnu.org; 16 Jan 2024 12:52:13 +0000 Received: from localhost ([127.0.0.1]:48076 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1rPivM-0004de-Tu for submit@debbugs.gnu.org; Tue, 16 Jan 2024 07:52:13 -0500 Received: from lists.gnu.org ([2001:470:142::17]:46258) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1rPivL-0004dI-Gs for submit@debbugs.gnu.org; Tue, 16 Jan 2024 07:52:11 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1rPivF-00042M-FL for bug-guile@gnu.org; Tue, 16 Jan 2024 07:52:05 -0500 Received: from wolfsden.cz ([37.205.8.62]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from <~@wolfsden.cz>) id 1rPivC-0004Xm-RL for bug-guile@gnu.org; Tue, 16 Jan 2024 07:52:05 -0500 Received: by wolfsden.cz (Postfix, from userid 104) id 41597256C40; Tue, 16 Jan 2024 12:52:00 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1705409520; bh=u2zVDWlDHnq3NaePZBg35DxbdfNyjlp4ypDvPYUsoCk=; h=From:To:Cc:Subject:Date; b=h9kAWfq9IyN6WaGvl5tMmOwF6nqZYne8wvLdBFSe+V7qZ4T//BFwmdDWaai4P4wGQ Mv/IpBEGErHckBl2zYbf42GcxlaiVWBJAIb6OoRI3E0GxNIQT0Pa1LDMrbeBIgMHay lHy2bKyOND5yW7SYe9ctFMZKd5BPb01AnHiq/wVCu3HD62JIzfGhlU6xh7rT5mJww5 12e6ArF0iKuWEY8x2Zy1BZlkrGpXiHkA/Ls6xXLOecFmAks2gxtXeyYn4h08rgtoY9 vK/uc43IOWf2AI7gk8J+b1qOZRa3JR7NnSmMCUdkH4xK1cjl6f3fU0MC9GM3CCNwHB vOOJGeiYU1hcpTb7rt8CYNp9U/JcAzSGo9c03g9qUUY4XlKHFitFt1Gf0WgI6JO40Z srA0992+329Csm1lWvyrzSBJOLbTGLciH65Mn4A53UpkTrgN8g3w37AJj3E1Jrx0e0 GigP/FtVPKMjzXK0gr6P3r/0sWzgY8Dynb4rew712bdVaAOUNecpGCKuRkGlh0a0Gr 1czGjllMY7B/VZNq1T1JEFFCGCOX01gtr/RHHOv4nT5jwb4rBqXk58rujGAc+yJu9V /rXUemoN4Hamcv3pxdNs6Qrcma/TuQFmmjdPDmIvOUmjfvdOdSr44YM56k0U49/Vor hhx3y9tOy57wmNqb4AQPNU+k= X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on wolfsden X-Spam-Level: X-Spam-Status: No, score=-1.2 required=5.0 tests=ALL_TRUSTED,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,T_SCC_BODY_TEXT_LINE, URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 Received: from localhost (unknown [81.17.16.72]) by wolfsden.cz (Postfix) with ESMTPSA id 8FC77256C39; Tue, 16 Jan 2024 12:51:59 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1705409519; bh=u2zVDWlDHnq3NaePZBg35DxbdfNyjlp4ypDvPYUsoCk=; h=From:To:Cc:Subject:Date; b=f4rgnNBL/fDuAM8ybxX5Eip9z48j/CykALNWDfkUP//8NBLPJF58+FWVz7AQVFfxQ z4xAA2l4DiidBWMnIN9QdBgRJi2p4wTzu3/Ple8Q1ZTPtECaITk43OI5kB4SHDs9Rr KWfvP5txwqIsXWfXayHovAQqKEfiMXTZnmlwwJBNmZN/6OvyX7BmBf2GUpyi8ntVb3 fOcjvZQztW3HxZe4/5TgEs2Q4iSIjNu1hzN7XvN9QAdvMWPWxvyaxUnyq9MAtuZ3ot qv22e3dKKq4YNifdBkvY/Id6Za65FUpX7m2WsPmq8ce1o+iMqZgU557NWu35Yiy2Ak +PyK7xI6FQM9HJfLhG4pCD+Ak9r3MoZbIEqBPJRX/acSTizYuD1QNF2zHtJq/pU3yI liVYLXEjJJWznprSz6+o9kALBG4Le9WUxh/Npp/F1RsHfmVR1xMgXRMt18RxUjvt1q 9KjGqK3LWNTirm18g96fPwDSm1LjjLt9DOdvd1sKluqNSKxWomtCBkBuyhrlEpQXET 52PzAq8wAw8teix4JP1l+KC+UybeBIklIQF918IGULx1d3u7iHq/7zmOCwT6cQEAC9 1AZJsWteUbxyagHXXff0FQkNRGcXBIzNqPl/Xr+XUDEq/0nlcQrBL3nhX8WVSk1Ywd bPhli2sLwYkhUi0c0DBok6ho= From: Tomas Volf <~@wolfsden.cz> To: bug-guile@gnu.org Subject: [PATCH v2] Add more detailed instructions into the HACKING file. Date: Tue, 16 Jan 2024 13:50:26 +0100 Message-ID: <20240116125109.14779-1-~@wolfsden.cz> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=37.205.8.62; envelope-from=~@wolfsden.cz; helo=wolfsden.cz X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: 1.0 (+) X-Debbugs-Envelope-To: submit Cc: Tomas Volf <~@wolfsden.cz> 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: -0.0 (/) Until now, the ./meta/guile was not mentioned anywhere, and therefore it was not obvious how to run the locally compiled Guile without installing it. While modifying the file, I took the liberty to also mention a bit about compiling Guile using Guix. Finally, the header lines where cleaned up, ensuring all of them end at 70 and have a leading space. * HACKING (Hacking It Yourself): Add Guix instructions. Add a note about meta/guile script. (Sample GDB Initialization File), (Naming conventions): Clean up the header line. --- v2: Add note regarding JIT and GNU Hurd. Add note regarding -fexcess-precision. Add --disable-static and explain it. Previous discussion happened on the mailing list. HACKING | 38 ++++++++++++++++++++++++++++++++++++-- 1 file changed, 36 insertions(+), 2 deletions(-) diff --git a/HACKING b/HACKING index 387643bf7..5926fb275 100644 --- a/HACKING +++ b/HACKING @@ -26,6 +26,40 @@ http://www.gnu.org/software/guile/mail/mail.html for more info. Hacking It Yourself ================================================== +You can spawn a shell with all the required dependencies using GNU Guix +by running the following command: + + guix shell -D -f guix.scm --pure + +In this way, you can effortlessly compile Guile from the Git checkout +with just these three lines: + + guix shell -D -f guix.scm --pure -- ./autogen.sh + guix shell -D -f guix.scm --pure -- ./configure \ + --enable-mini-gmp --disable-static + guix shell -D -f guix.scm --pure -- make + +Disabling of the static libraries is optional, but it does speed up the +builds, and you are unlikely to need them for local development. + + Note: Currently JIT causes Guile to crash in obscure ways on GNU Hurd, + so on that platform you want to also pass the --disable-jit flag + to the configure script. + + Note: On any i*86 architecture, you also need to pass in the compiler + flag -fexcess-precision=standard in order to get the test suite + to pass. That can be done by passing an additional argument to + the configure script: + CFLAGS='-g -O2 -fexcess-precision=standard' + +Once that finishes, you can execute your newly compiled Guile using the +./meta/guile script: + + $ ./meta/guile -v | head -n1 + guile (GNU Guile) 3.0.9.139-d7cf5-dirty + +For more manual approach, read on. + When Guile is obtained from Git, a few extra steps must be taken before the usual configure, make, make install. You will need to have up-to-date versions of the tools as listed below, correctly installed. @@ -73,7 +107,7 @@ Here is the authoritative list of tool/version/platform tuples that have been known to cause problems, and a short description of the problem. -Sample GDB Initialization File========================================= +Sample GDB Initialization File ======================================= In GDB, you probably want to load the gdbinit file included with Guile, which defines a number of GDB helpers to inspect Scheme values. @@ -215,7 +249,7 @@ The goal is to reduce (and over time, eliminate) spurious diffs. For Emacs users: (add-hook 'before-save-hook 'delete-trailing-whitespace) -Naming conventions ================================================= +Naming conventions =================================================== We use certain naming conventions to structure the considerable number of global identifiers. All identifiers should be either all lower -- 2.41.0 ------------=_1706534882-13820-1--