From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id QPV1LIoM8WMUiwAAbAwnHQ (envelope-from ) for ; Sat, 18 Feb 2023 18:36:10 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id +PmLLIoM8WNEBQAA9RJhRA (envelope-from ) for ; Sat, 18 Feb 2023 18:36:10 +0100 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 7F4A811440 for ; Sat, 18 Feb 2023 18:36:10 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pTR7z-0003Ge-QZ; Sat, 18 Feb 2023 12:36:03 -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 ) id 1pTR7y-0003GA-NK for guix-patches@gnu.org; Sat, 18 Feb 2023 12:36:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1pTR7y-0005BO-7g for guix-patches@gnu.org; Sat, 18 Feb 2023 12:36:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1pTR7y-0004uU-4l for guix-patches@gnu.org; Sat, 18 Feb 2023 12:36:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#61246] [PATCH v3 2/3] doc: Explain how to use local guix repositories. Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 18 Feb 2023 17:36:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 61246 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: =?UTF-8?Q?Andr=C3=A9?= Batista Cc: 61246@debbugs.gnu.org Received: via spool by 61246-submit@debbugs.gnu.org id=B61246.167674174318850 (code B ref 61246); Sat, 18 Feb 2023 17:36:02 +0000 Received: (at 61246) by debbugs.gnu.org; 18 Feb 2023 17:35:43 +0000 Received: from localhost ([127.0.0.1]:44892 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTR7e-0004ty-JD for submit@debbugs.gnu.org; Sat, 18 Feb 2023 12:35:42 -0500 Received: from mail-qt1-f175.google.com ([209.85.160.175]:43753) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1pTR7c-0004tZ-4r for 61246@debbugs.gnu.org; Sat, 18 Feb 2023 12:35:40 -0500 Received: by mail-qt1-f175.google.com with SMTP id fu23so741316qtb.10 for <61246@debbugs.gnu.org>; Sat, 18 Feb 2023 09:35:40 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id :in-reply-to:date:references:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to; bh=UwaTDRGV+Fd4Vempq2jvu+4MLvscGX+Kmt8Cjm5sut8=; b=Fd5Xec8nTpl8TzN6jrBQwrSYj16lwTlV+rAu/BhL236PNZ8LCpM6+w8ofmTYuBiicD nsuox7xz1iQ/Qghk0xsAse4vhNifJFNS2A7CMA5sswIR9xKXX/igyHKRTPuhr0YjO4gW jBJS45XNixzeGzfJ1IBbk7zICFpPTo5AojjCcFxbL3voeGX1OQmTSeYV+FXBU2sTbfrW IJ4FLUGfUskee9dvCcF9evp0eNCIzXVcpzhz9kvFJkNT4GMbbmBo1fRATOSHuNsXYXQw cZlu/u0lysRoheU6HDtJEC00/vDuv4LqA2nVnlmU88xT30imHEy9kE+z6Vl00JQ3SFr4 gvAA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:user-agent:message-id :in-reply-to:date:references:subject:cc:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=UwaTDRGV+Fd4Vempq2jvu+4MLvscGX+Kmt8Cjm5sut8=; b=hHrCASdxZLmW1dObNl6v0PwdBoVi76ImaLA4jDvSoDep4sg8ofLH3xKhU2pYQoo+Xx loFCW0thNdmagk1NYoWRArpeA2JVBkA1YESZJ1SXkeoXXWTZEKB004fsuJ6T/UQaQGoM /E7ZiLrK4XjQSb4AaEFU3vb6jipRKcJgA3VHtAkZlbNmmbbgDtSGP3NCujUD8/jtTv6a BtsvQnMPvkcWRiPLiVYkGp0s5I5rDHWNci2S/qaKP+P/L7DaktA0maXB67bzu188Zhu+ 5A5QyZyaC6CrmkWsRyF/H8kBZ1mH0iz75GkCARAxtq31PI7pv/GyGVVeU5W6DY9P10s6 IFRw== X-Gm-Message-State: AO0yUKURGlHfe1y7szd1lCIt/bEP4dyBP86f0PE7NhTNxrv5H0/USlZC Nit9pC8OXpSrIDJxAmjY8rGd4Q23nZ2ZPrBi X-Google-Smtp-Source: AK7set/oSGlAIYP1FB7xzb5ooqs1USJj8PUkJJa6nyHdDM/Ti6SzS0DaW0Pbbp0iobfBm/SeDH4EaA== X-Received: by 2002:a05:622a:13d1:b0:3bd:de7:6163 with SMTP id p17-20020a05622a13d100b003bd0de76163mr15497341qtk.16.1676741734307; Sat, 18 Feb 2023 09:35:34 -0800 (PST) Received: from hurd (dsl-157-123.b2b2c.ca. [66.158.157.123]) by smtp.gmail.com with ESMTPSA id o190-20020a375ac7000000b0073b45004754sm5650882qkb.34.2023.02.18.09.35.33 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 18 Feb 2023 09:35:33 -0800 (PST) From: Maxim Cournoyer References: <87a61ogomz.fsf@gmail.com> <20230217190640.1914-1-nandre@riseup.net> <87r0uoqd2j.fsf@gmail.com> Date: Sat, 18 Feb 2023 12:35:32 -0500 In-Reply-To: ("=?UTF-8?Q?Andr=C3=A9?= Batista"'s message of "Fri, 17 Feb 2023 20:24:45 -0300") Message-ID: <87fsb2q3kr.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Fd5Xec8n; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Seal: i=1; s=key1; d=yhetil.org; t=1676741770; a=rsa-sha256; cv=none; b=Qv5ADYnVtagCL7AKe6gWtt8lflPIUnlwjHsaU3ri5+CWgz/aW4glyiblKkJiKOpMaDKs1m py6FhVw1IeqK/dGL9A6YgySQJVd6c3Vbzx3O5Rcygp01WWYuME301SEhbWuOfkAcE85e5o Gua3hHUROu3esbFjyRCLANPwUKH+EfhLOHg01p2ZeH2s9LbJO5YHmhhXVa2iJfdNPYj0WH MuiPhv5LLKBoFo4kB9iCOSY9H0b/lFllZTqT31/vIPJgvjHyD7pSrm4ldWnQmkPc800uZW 2mLEcVA4A5Xu9QoRmpl5Z3hGrcieQw4Mkez3AjWdpA9xPPTxdYNLhb0EzqO6SQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1676741770; 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: content-transfer-encoding:content-transfer-encoding:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=UwaTDRGV+Fd4Vempq2jvu+4MLvscGX+Kmt8Cjm5sut8=; b=MYAj/Fk8JWCM114+QT6wiPv2r0xF1np7YMsZt0X/lknVVViQd78biwEWPyCtvoAWbW2NEk ChQj7cr+WrX9dQwOfojMgVgiNsLv0DnOy+JxMrUiZJ0vVl02Dn1viWuAPJohRx0gpkXC+w cS3kHSr5KdmvNzBI+u42zbvTbqxjyvjSE8VlvHuEpt7j5U6hhpxZ/dkAowsmi5T/X+yhcw LRbRZXyZbShF7aOmOYOmoFH1trVRiOdJHsMu2CawigKmRW4diSsTnMKhDNw6VirrVuVg/A ADb2O5bZYFrMgCR6G3nKlqZHInXdIpsvOS4YbR63M1M9wRA63T8Bp6St430B4Q== X-Migadu-Spam-Score: 5.87 X-Migadu-Scanner: scn1.migadu.com X-Migadu-Queue-Id: 7F4A811440 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Fd5Xec8n; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none) X-Spam-Score: 5.87 X-TUID: lsNnKqqZykP5 Hi Andr=C3=A9, Andr=C3=A9 Batista writes: > Hi, > > sex 17 fev 2023 =C3=A0s 14:58:12 (1676656692), maxim.cournoyer@gmail.com = enviou: >> Hello, >> >> Andr=C3=A9 Batista writes: >> > +Note that you can specify a local directory on the @code{url} field a= bove if >> > +the channel that you intend to use resides on a local file system. H= owever, >> > +in this case @command{guix} checks said directory for ownership befor= e any >> > +further processing. This means that if the user is not the directory= owner, >> > +but wants to use it as their default, they will then need to set it a= s a safe >> > +directory in their global git configuration file. Otherwise, @comman= d{guix} >> > +will refuse to even read it. Supposing your system-wide local direct= ory is at >> > +@code{/src/guix.git}, you would then create a git configuration file = at >> > +@code{~/.gitconfig} with the following contents: >> > + >> > +@example >> > +[safe] >> > + directory =3D /src/guix.git >> > +@end example >> >> Perhaps you meant to use @command{git} in the above instead of >> @command{guix}, since it's specific to Git (and the configure snippet is >> for Git) ? > > Not really. It's guix itself and its subcommands which will fail in > this scenario, not git, even though it's because guix is using git > configuration through libgit2. To me it would be misleading to use > @command{git} there. I could come up with a more detailed > description, however, I don't think this would be the place to be > diving on a detailed discussion of guix internals. I'm up to > suggestions though if you think this patch would make people wonder > if it is a typo. I understand. How about a very subtle nudge at the fact that Guix uses git (via libgit2) under the hood? Something like the following, where I've used a footnote (untested): --8<---------------cut here---------------start------------->8--- Note that you can specify a local directory on the @code{url} field above if the channel that you intend to use resides on a local file system. However, in this case @command{guix}@footnote{More accurately, @command{git}, which Guix utilizes via the @code{libgit2} library.} checks said directory for ownership before any further processing. This means that if the user is not the directory owner, but wants to use it as their default, they will then need to set it as a safe directory in their global git configuration file. Otherwise, @command{guix} will refuse to even read it. Supposing your system-wide local directory is at @code{/src/guix.git}, you would then create a git configuration file at @code{~/.gitconfig} with the following contents: --8<---------------cut here---------------end--------------->8--- --=20 Thanks, Maxim