From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id 0PKBH3eQHWVLSAAAG6o9tA:P1 (envelope-from ) for ; Wed, 04 Oct 2023 18:19:03 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id 0PKBH3eQHWVLSAAAG6o9tA (envelope-from ) for ; Wed, 04 Oct 2023 18:19:03 +0200 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 3E35459C50 for ; Wed, 4 Oct 2023 18:19:03 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=QCS4NipF; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1696436343; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=OSViZ+8lov1MxDEMnJlcbprngRdZFQhdLrVFCllJdE4=; b=sQ8O3mzN1SzC/Rfr2qjWWQKgWcGb0AFKNhAlEfpq+/MCKqpTYk3cS8lqEaEnoS2f0luMUg UxueHR4sy5u+6IAzEtk6igxUQfFFNvQBPfL7X4t1IYQYZxXf1bYNtgg4d1wLADOwNBFlW5 34iIWyC1r84kdteBEi4mqpyRT30cr8Nbcb/XzVveDBoRKeiH06PcRUeBXPFco1Xvx02wVr qOqe2JzTJN8n1ZQprDF+W2nt5O65wTFkr+3WMnEZiuBYFPgtuzH286w3aLICp5QPjizp8H MNbs9JOy0t2n5lWGajVnKPMQZU3jfMfwIwkvhMeNF8IuBxHJSGwWTTYYmNt/dQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1696436343; a=rsa-sha256; cv=none; b=sxlGLbq2ADAz6eBbMaZ4v5YRD573VQcZxDOBIrNSjXFuhSijz7NB1y/piTiyPITUsxIGVh /DkHq821spwL7K5COFG6fZ9nRTp7Q5ZFoXVwSFR91iFx5CbYm0U4303GLxo5j0g6ZRQ3cz XdAMP9Z9G4h3w3H6CUGAc0AGMvr7vcuHpNF9N4j4+SUl7vke5C39TUODIVJSWiRdJrYsns 4UFIVtQsY+bjztJX/3/lpT4YtJdvH57VtQZccQyccYXG7z3VIh8x3ZHkjlT9fTaT/9gV0M 3siAjYNyO0MgEHBVGwM31MxOnNKK325VtlK+OqTxnLUvQe8qqH+by13ADyDLjQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=QCS4NipF; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org"; dmarc=none Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qo4a9-0001tN-4N; Wed, 04 Oct 2023 12:18:41 -0400 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 ) id 1qo4a8-0001t9-8Y for guix-devel@gnu.org; Wed, 04 Oct 2023 12:18:40 -0400 Received: from mail-ej1-x634.google.com ([2a00:1450:4864:20::634]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qo4a6-0003Jl-1A; Wed, 04 Oct 2023 12:18:40 -0400 Received: by mail-ej1-x634.google.com with SMTP id a640c23a62f3a-99357737980so420383366b.2; Wed, 04 Oct 2023 09:18:36 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1696436315; x=1697041115; darn=gnu.org; h=in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:cc:to:from:date:sender:from:to :cc:subject:date:message-id:reply-to; bh=OSViZ+8lov1MxDEMnJlcbprngRdZFQhdLrVFCllJdE4=; b=QCS4NipFufkwGiUtjIR7zHwZix/UYAeMTSbB6pcOywreiYf2UHJ9Oj0+oZnRt9PMJc EVe1utO4R6Gligo6DmJeXx5NnAb9qg1fUDlHorNjJTVtRqvUG5W4JqqigYX4ptugTlDA qfviYvt88+AaZW2PvODXjSDn76wUalsXa6s+ZEbDhajdZR5WOsNV0I/YYooLWY/rlD+h iELOQf2Fed2SzIVzDHJrpSLQpsIwoyJnPcg+aDR54T0fcO68AZ9sRrCwNh8nx38Zp73+ 6uU6CkfqVYCgNiYwqfXfjItBy5OWjekPTBblZRYxNd4W/kHH+mQpwhwYCnBKYyfEI1B7 fRWw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1696436315; x=1697041115; h=in-reply-to:content-disposition:mime-version:references :mail-followup-to:message-id:subject:cc:to:from:date:sender :x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=OSViZ+8lov1MxDEMnJlcbprngRdZFQhdLrVFCllJdE4=; b=iqI2fhtKL+Iksfztqnw+95xoMXujv/QNjpCLDiyJkhEN/x/pD2nYyEJ4oFlQ5iafCd 71gBpb2vHXudOAanUL+hvMvT7S/rM/B4qivqsji02z3VXUv4aYzjIglFP336cfBNynBB y3bP5R2Y9qz+EfjF4oVpP9LcLrd/S+9gsGP2qx/uvAsiWVRegVBC1tO0F8y5L8YFN20a jwZz1USdF+dLuoBU89SkS08HApmScmNFOu6SGGi3Rk/tuKn2P8EwJFco6pRvlRh2pUlY reuLBhXXIZabiMjA/Tlm/EsXEBIua/xNOgD5UjBWFn2kP+UCquiz+YhNCZAc7pAPcLPp IyIQ== X-Gm-Message-State: AOJu0Yymq/IeHB/jA+k4scQ5NRS1dV4NYxrLeSL0yXaBOH5yrSMBW1w4 HmCH2xSVZiooC4Gq3+Q2tGo= X-Google-Smtp-Source: AGHT+IGnln5uiJ4nlKdejrL6FFhxPLeP+xk9o7x6jurIGMRJIWgU8H82ztch3fonH9Dsnecc8CcBwg== X-Received: by 2002:a17:906:8a47:b0:9b8:9b30:aff with SMTP id gx7-20020a1709068a4700b009b89b300affmr1942188ejc.1.1696436314609; Wed, 04 Oct 2023 09:18:34 -0700 (PDT) Received: from localhost ([2a02:ed3:916:6300:c3db:b80e:a694:a54f]) by smtp.gmail.com with ESMTPSA id 11-20020a170906058b00b009add084a00csm3062313ejn.36.2023.10.04.09.18.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 04 Oct 2023 09:18:34 -0700 (PDT) Date: Wed, 4 Oct 2023 19:18:32 +0300 From: Efraim Flashner To: Ekaitz Zarraga Cc: 66343@debbugs.gnu.org, "guix-devel\\\\@gnu.org" , Ludovic =?utf-8?Q?Court=C3=A8s?= , Simon Tournier Subject: Re: [bug#66343] Add more setups to Guix docs Message-ID: Mail-Followup-To: Ekaitz Zarraga , 66343@debbugs.gnu.org, "guix-devel\\\\@gnu.org" , Ludovic =?utf-8?Q?Court=C3=A8s?= , Simon Tournier References: MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="LqsDJrgsblVMOcs9" Content-Disposition: inline In-Reply-To: X-PGP-Key-ID: 0x41AAE7DCCA3D8351 X-PGP-Key: https://flashner.co.il/~efraim/efraim_flashner.asc X-PGP-Fingerprint: A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351 Received-SPF: pass client-ip=2a00:1450:4864:20::634; envelope-from=efraim.flashner@gmail.com; helo=mail-ej1-x634.google.com X-Spam_score_int: 5 X-Spam_score: 0.5 X-Spam_bar: / X-Spam_report: (0.5 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, PDS_OTHER_BAD_TLD=1.999, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: guix-devel-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Scanner: mx0.migadu.com X-Migadu-Spam-Score: -5.32 X-Spam-Score: -5.32 X-Migadu-Queue-Id: 3E35459C50 X-TUID: xQOEWqm2E6Tc --LqsDJrgsblVMOcs9 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: quoted-printable I think we can mention guix.vim also On Wed, Oct 04, 2023 at 03:36:18PM +0000, Ekaitz Zarraga wrote: >=20 > ------- Original Message ------- > On Wednesday, October 4th, 2023 at 15:27, Ludovic Court=C3=A8s wrote: >=20 >=20 > > Hi, > > > > Ekaitz Zarraga ekaitz@elenq.tech skribis: > > > > > From 0c2be98f05bb288699a8e39dcef6428eb5a9dc3f Mon Sep 17 00:00:00 2001 > > > Message-ID: 0c2be98f05bb288699a8e39dcef6428eb5a9dc3f.1695679042.git.e= kaitz@elenq.tech > > > From: Ekaitz Zarraga ekaitz@elenq.tech > > > Date: Mon, 25 Sep 2023 16:16:28 +0200 > > > Subject: [PATCH] WIP: doc: contributing: Add alternative setups secti= on > > > > > > Start with Guile Studio and Vim/NeoVim. > > > > > > * doc/contributing.texi (Alternative Setups): Add section explaining > > > other setups that are similar to the one in The Perfect Setup > > > > > > Not a maintainer either but I like it! > > > > > +@node Alternative Setups > > > + > > > > > > I think you=E2=80=99re missing an @section here. > > > > > +@node Vim and NeoVim > > > +@subsection Vim and Neovim > > > > > > Which spelling is the right one? :-) > > > > Maybe send it to guix-patches@gnu.org so it passes on everyone=E2=80=99= s radar, > > but otherwise LGTM! > > > > Ludo=E2=80=99. >=20 > Great! > Thanks Ludo. >=20 > Fixed! >=20 > I add guix-patches in the loop. >=20 > Thanks all, > Ekaitz > From 8ea037b7d8f3472323682594266f5810fd87f291 Mon Sep 17 00:00:00 2001 > Message-ID: <8ea037b7d8f3472323682594266f5810fd87f291.1696433643.git.ekai= tz@elenq.tech> > From: Ekaitz Zarraga > Date: Mon, 25 Sep 2023 16:16:28 +0200 > Subject: [PATCH] doc: contributing: Add alternative setups section >=20 > Start with Guile Studio and Vim/NeoVim. >=20 > * doc/contributing.texi (Alternative Setups): Add section explaining > other setups that are similar to the one in The Perfect Setup > --- > doc/contributing.texi | 77 +++++++++++++++++++++++++++++++++++++++---- > 1 file changed, 70 insertions(+), 7 deletions(-) >=20 > diff --git a/doc/contributing.texi b/doc/contributing.texi > index 0de47a403b..c476097bf5 100644 > --- a/doc/contributing.texi > +++ b/doc/contributing.texi > @@ -23,6 +23,7 @@ Contributing > * Building from Git:: The latest and greatest. > * Running Guix Before It Is Installed:: Hacker tricks. > * The Perfect Setup:: The right tools. > +* Alternative Setups:: Other posible tools that do the job. > * Packaging Guidelines:: Growing the distribution. > * Coding Style:: Hygiene of the contributor. > * Submitting Patches:: Share your work. > @@ -453,6 +454,75 @@ The Perfect Setup > Emacs Manual} and @ref{Minor Mode,,, debbugs-ug, The Debbugs User > Guide}. > =20 > +@node Alternative Setups > +@section Alternative Setups > + > +Alternative setups than Emacs may let you work on Guix with a > +similar development experience and they might work better with the > +tools you currently use or help you make the transition to Emacs. > + > +The options listed below only provide the alternatives to the Emacs > +based setup, which is the most widely used in the Guix community. If > +you want to really understand how is the perfect setup for Guix > +development supposed to work, we encourage you to read the section > +before this regardless the editor you choose to use. > + > +@menu > +* Guile Studio:: First step in your transition to Emacs. > +* Vim and NeoVim:: When you are evil to the root. > +@end menu > + > +@node Guile Studio > +@subsection Guile Studio > + > +Guile Studio is a pre-configured Emacs with mostly everything you need > +to start hacking in Guile. If you are not familiar with Emacs it makes > +the transition easier for you. > + > +@example > +guix install guile-studio > +@end example > + > +Guile Studio comes with Geiser preinstalled and prepared for action. > + > +@node Vim and NeoVim > +@subsection Vim and NeoVim > + > + > +Vim (and NeoVim) are also packaged in Guix, just in case you decided > +to go for the evil path. > + > +@example > +guix install vim > +@end example > + > +If you want to enjoy a similar development experience to that in the per= fect > +setup, you should install several plugins to configure the editor. Vim (= and > +NeoVim) have the equivalent to Paredit, > +@uref{https://www.vim.org/scripts/script.php?script_id=3D3998, > +@code{paredit.vim}}, that will help you with the structural editing of S= cheme > +files (the support for very large files is not great, though). > + > +@example > +guix install vim-paredit > +@end example > + > +We also recommend that you run @code{:set autoindent} so that your code = is > +automatically indented as you type. > + > +For the interaction with Git, > +@uref{https://www.vim.org/scripts/script.php?script_id=3D2975 > +@code{fugitive.vim}} is the most commonly used plugin: > + > +@example > +guix install vim-fugitive > +@end example > + And of course if you want to interact with Guix directly from inside of vim, using the built-in terminal emulator, we have our very own @code{guix.vim} package! @example guix install vim-guix-vim @end example > +In NeoVim you can even make a similar setup to Geiser using > +@url{https://conjure.fun/, Conjure} that lets you connect to a running G= uile > +process and inject your code there live (sadly it's not packaged in Guix= yet). > + > + > @node Packaging Guidelines > @section Packaging Guidelines > =20 > @@ -1257,13 +1327,6 @@ Formatting Code > @noindent > @xref{Invoking guix style}, for more information. > =20 > -@cindex Vim, Scheme code editing > -If you are editing code with Vim, we recommend that you run @code{:set > -autoindent} so that your code is automatically indented as you type. > -Additionally, > -@uref{https://www.vim.org/scripts/script.php?script_id=3D3998, > -@code{paredit.vim}} may help you deal with all these parentheses. > - > We require all top-level procedures to carry a docstring. This > requirement can be relaxed for simple private procedures in the > @code{(guix build @dots{})} name space, though. >=20 > base-commit: 284f8508bebcae510261c7c223dc28f9badf87ce > --=20 > 2.41.0 >=20 --=20 Efraim Flashner =D7=A8=D7=A0=D7=A9=D7=9C=D7=A4 = =D7=9D=D7=99=D7=A8=D7=A4=D7=90 GPG key =3D A28B F40C 3E55 1372 662D 14F7 41AA E7DC CA3D 8351 Confidentiality cannot be guaranteed on emails sent or received unencrypted --LqsDJrgsblVMOcs9 Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAABCAAdFiEEoov0DD5VE3JmLRT3Qarn3Mo9g1EFAmUdkFUACgkQQarn3Mo9 g1FewQ/9Eo1+2qUv29Cd90lqjA8MjYoYHlf5JAitb5BOmmKCvSNsdi9CWNwVzXP3 tGVxO5Tn9xuDkz0PJsJhduqiMAJBrNW2ejOGSBXuPd0eosW1CSy3Eg3N5b27NGcH EXs5qaJjSke3giMPJRAqW+o5SRdjGoOaPeLIcSlrMOIxRkAxLKEeV3yTrsgBDKJJ rhnHBdDgyYQhkS31umGXsForZxS59dfOzK/uCZ9jWMG+ak2cWQ6DqmybYbqlgOdB Ouw0oCB812RlYkvSL8pCjirAJF2UA99KIk9JiaWbjRJl2tzix515SLWJ3bcEaGLE CIsvAuAx84Eukm0w6hk5wAJabTMaLMQYInCC2yg1uyVgEmjCIYxhNgjbeCS2vG8C qBVhqoxZjl39oeQUk1KAXOUEJ46sZpn7olEUnfZZzd7zqdQKLAQeXlMMDfy71xhn kGb2DW91w1QIQo+ZMbuQZ7LGprWg+SfnG4eyfDAbJKPPDIMHYqrXRvHGkXwmhiTH QexKgy+iY8TMKS0OpgmrER5t7cxQqoLmZdN/PyN+fD02OOV83IDI4nDGX2lPnAut p8gWvn/RuMi4saraSbx6jT0SRT4Ly7v4nWPIV5zAL7dWTCMfu1gbm7iNR0REgD0U Zxrt/WbZmhXVdkT+q9nkAf+Q8Tc2gkm5X1GJRk15CqRkV2x5BK4= =o4JO -----END PGP SIGNATURE----- --LqsDJrgsblVMOcs9--