From debbugs-submit-bounces@debbugs.gnu.org Sat Jul 13 02:41:50 2019 Received: (at submit) by debbugs.gnu.org; 13 Jul 2019 06:41:50 +0000 Received: from localhost ([127.0.0.1]:41374 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmBjC-0002JA-DT for submit@debbugs.gnu.org; Sat, 13 Jul 2019 02:41:50 -0400 Received: from lists.gnu.org ([209.51.188.17]:57730) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hmBj9-0002Iz-UJ for submit@debbugs.gnu.org; Sat, 13 Jul 2019 02:41:48 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:40177) by lists.gnu.org with esmtp (Exim 4.86_2) (envelope-from ) id 1hmBj8-00033i-Jc for guix-patches@gnu.org; Sat, 13 Jul 2019 02:41:47 -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.8 required=5.0 tests=BAYES_50,URIBL_BLOCKED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hmBj7-0005tr-8R for guix-patches@gnu.org; Sat, 13 Jul 2019 02:41:46 -0400 Received: from pelzflorian.de ([5.45.111.108]:55790 helo=mail.pelzflorian.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hmBj6-0005pt-KH for guix-patches@gnu.org; Sat, 13 Jul 2019 02:41:45 -0400 Received: from pelzflorian.localdomain (unknown [5.45.111.108]) by mail.pelzflorian.de (Postfix) with ESMTPSA id 605233600E9 for ; Sat, 13 Jul 2019 08:41:41 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=pelzflorian.de; s=mail; t=1563000101; bh=QFTqbWVyB/qyc2fc6DS92RgOdfic1dHJggdYEDRqQkk=; h=Date:From:To:Subject; b=K766d//D0EtN6U+SLumVdMLGt+o7TV2nkIHSckUJNl1xpdTjCj8HJ77IaBVs219fz rdC9yKK30/QyDAFt9DjNu8oL/asHMLpdkFUGCbU4+nJkNTSarDgZWlGnWGzTO9egWg cFNfUXaz/Lu+ZLGUBJTtTl6n18e5dHOi8XIqI22Q= Date: Sat, 13 Jul 2019 08:41:40 +0200 From: "pelzflorian (Florian Pelz)" To: guix-patches@gnu.org Subject: Simplify contributing instructions Message-ID: <20190713064140.froxjbrj4pzzsfh2@pelzflorian.localdomain> MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="xd7wotvy4h5ecbve" Content-Disposition: inline User-Agent: NeoMutt/20180716 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 5.45.111.108 X-Spam-Score: -1.4 (-) X-Debbugs-Envelope-To: submit 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: -2.4 (--) --xd7wotvy4h5ecbve Content-Type: text/plain; charset=us-ascii Content-Disposition: inline I believe we want to be able to refer users who have bugs to the Guix manual sections on Contributing. In , the contributing instructions in the Guix manual were not understood properly. I hope the attached patch could alleviate this a little. Regards, Florian --xd7wotvy4h5ecbve Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="0001-doc-Reorder-and-clarify-contributing-instructions.patch" >From 3d6f944daa314e3bf064ef262a5c79ada1c70e6e Mon Sep 17 00:00:00 2001 From: Florian Pelz Date: Sat, 13 Jul 2019 08:29:26 +0200 Subject: [PATCH] doc: Reorder and clarify contributing instructions. * doc/contributing.texi (Building from Git, Running Guix Before It Is Installed): Make instructions using Guix come first and clarify which code is an instruction and which is merely an example. --- doc/contributing.texi | 36 +++++++++++++++++++----------------- 1 file changed, 19 insertions(+), 17 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index e00634eed4..f5eff842b9 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -38,19 +38,6 @@ version from the Git repository: git clone https://git.savannah.gnu.org/git/guix.git @end example -When building Guix from a checkout, -the following packages are required in addition to those mentioned in -the installation instructions (@pxref{Requirements}). - -@itemize -@item @url{http://gnu.org/software/autoconf/, GNU Autoconf}; -@item @url{http://gnu.org/software/automake/, GNU Automake}; -@item @url{http://gnu.org/software/gettext/, GNU Gettext}; -@item @url{http://gnu.org/software/texinfo/, GNU Texinfo}; -@item @url{http://www.graphviz.org/, Graphviz}; -@item @url{http://www.gnu.org/software/help2man/, GNU Help2man (optional)}. -@end itemize - The easiest way to set up a development environment for Guix is, of course, by using Guix! The following command starts a new shell where all the dependencies and appropriate environment variables are set up to @@ -61,7 +48,22 @@ guix environment guix --pure @end example @xref{Invoking guix environment}, for more information on that command. -Extra dependencies can be added with @option{--ad-hoc}: + +If you are unable to use Guix when building Guix from a checkout, the +following are the required packages in addition to those mentioned in the +installation instructions (@pxref{Requirements}). + +@itemize +@item @url{http://gnu.org/software/autoconf/, GNU Autoconf}; +@item @url{http://gnu.org/software/automake/, GNU Automake}; +@item @url{http://gnu.org/software/gettext/, GNU Gettext}; +@item @url{http://gnu.org/software/texinfo/, GNU Texinfo}; +@item @url{http://www.graphviz.org/, Graphviz}; +@item @url{http://www.gnu.org/software/help2man/, GNU Help2man (optional)}. +@end itemize + +On Guix, extra dependencies can be added by instead running @command{guix +environment} with @option{--ad-hoc}: @example guix environment guix --pure --ad-hoc help2man git strace @@ -113,8 +115,8 @@ run @code{make install}. To do that, you first need to have an environment with all the dependencies available (@pxref{Building from Git}), and then simply prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the -top build tree of Guix; it is generated by @command{./configure}), -as in@footnote{The @option{-E} flag to +top build tree of Guix; it is generated by @command{./configure}). +An example@footnote{The @option{-E} flag to @command{sudo} guarantees that @code{GUILE_LOAD_PATH} is correctly set such that @command{guix-daemon} and the tools it uses can find the Guile modules they need.}: @@ -125,7 +127,7 @@ $ ./pre-inst-env guix build hello @end example @noindent -Similarly, for a Guile session using the Guix modules: +Similarly, an example for a Guile session using the Guix modules: @example $ ./pre-inst-env guile -c '(use-modules (guix utils)) (pk (%current-system))' -- 2.22.0 --xd7wotvy4h5ecbve-- From debbugs-submit-bounces@debbugs.gnu.org Wed Jul 17 09:00:16 2019 Received: (at 36635-done) by debbugs.gnu.org; 17 Jul 2019 13:00:16 +0000 Received: from localhost ([127.0.0.1]:51677 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnjXc-0002fu-9c for submit@debbugs.gnu.org; Wed, 17 Jul 2019 09:00:16 -0400 Received: from eggs.gnu.org ([209.51.188.92]:57625) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hnjXZ-0002Xk-Ng for 36635-done@debbugs.gnu.org; Wed, 17 Jul 2019 09:00:14 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:58087) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hnjXU-0008QG-6S; Wed, 17 Jul 2019 09:00:08 -0400 Received: from [2a01:e0a:1d:7270:af76:b9b:ca24:c465] (port=32970 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hnjXS-0001YQ-C4; Wed, 17 Jul 2019 09:00:06 -0400 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: "pelzflorian \(Florian Pelz\)" Subject: Re: [bug#36635] Simplify contributing instructions References: <20190713064140.froxjbrj4pzzsfh2@pelzflorian.localdomain> Date: Wed, 17 Jul 2019 15:00:05 +0200 In-Reply-To: <20190713064140.froxjbrj4pzzsfh2@pelzflorian.localdomain> (pelzflorian@pelzflorian.de's message of "Sat, 13 Jul 2019 08:41:40 +0200") Message-ID: <877e8gddey.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.2 (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-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: 36635-done Cc: 36635-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 (---) Hello, "pelzflorian (Florian Pelz)" skribis: >>>From 3d6f944daa314e3bf064ef262a5c79ada1c70e6e Mon Sep 17 00:00:00 2001 > From: Florian Pelz > Date: Sat, 13 Jul 2019 08:29:26 +0200 > Subject: [PATCH] doc: Reorder and clarify contributing instructions. > > * doc/contributing.texi (Building from Git, Running Guix Before It Is > Installed): Make instructions using Guix come first and clarify which cod= e is > an instruction and which is merely an example. Applied, thanks! Ludo=E2=80=99. From unknown Sat Jun 14 14:27:09 2025 Received: (at fakecontrol) by fakecontrolmessage; To: internal_control@debbugs.gnu.org From: Debbugs Internal Request Subject: Internal Control Message-Id: bug archived. Date: Thu, 15 Aug 2019 11:24:05 +0000 User-Agent: Fakemail v42.6.9 # This is a fake control message. # # The action: # bug archived. thanks # This fakemail brought to you by your local debbugs # administrator