From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id cHyeEK+27mFkcwAAgWs5BA (envelope-from ) for ; Mon, 24 Jan 2022 15:24:47 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id yKbyDK+27mFiNAAAauVa8A (envelope-from ) for ; Mon, 24 Jan 2022 15:24:47 +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 CC29338EFD for ; Mon, 24 Jan 2022 15:24:46 +0100 (CET) Received: from localhost ([::1]:52816 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nC0Gz-0002Gq-Sc for larch@yhetil.org; Mon, 24 Jan 2022 09:24:45 -0500 Received: from eggs.gnu.org ([209.51.188.92]:43112) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nC0EM-0005xu-BG for bug-guix@gnu.org; Mon, 24 Jan 2022 09:22:02 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:49768) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nC0EL-0005m4-Pr for bug-guix@gnu.org; Mon, 24 Jan 2022 09:22:01 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nC0EL-00060V-Mb for bug-guix@gnu.org; Mon, 24 Jan 2022 09:22:01 -0500 X-Loop: help-debbugs@gnu.org Subject: bug#53368: .guix-authorizations 'version' field documentation Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: bug-guix@gnu.org Resent-Date: Mon, 24 Jan 2022 14:22:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53368 X-GNU-PR-Package: guix X-GNU-PR-Keywords: To: Maxime Devos Received: via spool by 53368-submit@debbugs.gnu.org id=B53368.164303411823080 (code B ref 53368); Mon, 24 Jan 2022 14:22:01 +0000 Received: (at 53368) by debbugs.gnu.org; 24 Jan 2022 14:21:58 +0000 Received: from localhost ([127.0.0.1]:42671 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nC0EI-00060B-He for submit@debbugs.gnu.org; Mon, 24 Jan 2022 09:21:58 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:49262) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nC0EG-0005zx-J5 for 53368@debbugs.gnu.org; Mon, 24 Jan 2022 09:21:57 -0500 Received: from localhost (localhost [127.0.0.1]) by hera.aquilenet.fr (Postfix) with ESMTP id 299002FE; Mon, 24 Jan 2022 15:21:51 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at aquilenet.fr Received: from hera.aquilenet.fr ([127.0.0.1]) by localhost (hera.aquilenet.fr [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id eN4y1IBfqY1k; Mon, 24 Jan 2022 15:21:50 +0100 (CET) Received: from ribbon (91-160-117-201.subs.proxad.net [91.160.117.201]) by hera.aquilenet.fr (Postfix) with ESMTPSA id 001AC188; Mon, 24 Jan 2022 15:21:49 +0100 (CET) From: Ludovic =?UTF-8?Q?Court=C3=A8s?= References: <99e271fa-7b0e-30f6-0613-57e7942826a3@gmail.com> <9ad77607fe114f55cc6a0d23e31882faa63f3def.camel@telenet.be> Date: Mon, 24 Jan 2022 15:21:49 +0100 In-Reply-To: <9ad77607fe114f55cc6a0d23e31882faa63f3def.camel@telenet.be> (Maxime Devos's message of "Thu, 20 Jan 2022 14:07:50 +0100") Message-ID: <874k5tusci.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/27.2 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spamd-Bar: / X-Rspamd-Server: hera X-Rspamd-Queue-Id: 299002FE X-Spamd-Result: default: False [-0.10 / 15.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; RCPT_COUNT_THREE(0.00)[3]; FREEMAIL_ENVRCPT(0.00)[gmail.com]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; TO_DN_SOME(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_COUNT_TWO(0.00)[2]; RCVD_TLS_ALL(0.00)[]; MID_RHS_MATCH_FROM(0.00)[]; FREEMAIL_CC(0.00)[gmail.com,debbugs.gnu.org] X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guix@gnu.org List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Christopher Rodriguez , 53368@debbugs.gnu.org Errors-To: bug-guix-bounces+larch=yhetil.org@gnu.org Sender: "bug-Guix" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1643034286; 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; bh=WhGRKRd/IQt5N58bam0pKBjyz46BlNPhejUDmSM0Acc=; b=t3T7dR2LAKrcFk5uwUg4iysDhH+w7P6ZFWCHHH9aeIASli/1Qs2sBiRNP4VaYE9LF83fqi 5GtDlAW1CVM664iqLWgOmu9A1tvyTnLade0epv/sBsr6wi0sSw5MoRlSV7YSvZl1YQSn1S 7zUbEEa5WweG6DpKaRVVFr3pKmc2CUlj2C9aV7RikrBIFHVcVedjr6ztXOvH31ao5A7IGt KgAcZP3+pg34lD/3ISsqpl8VtebpjV1I7QyYNaAmY40eayr54iQu+ZlLqEzOa5VXIQvlON buLVl/9fFp0tfrCNBa+dnq7d6ZHyrE6dKktsMzpnDK5vRmX87NWGfA9rZFOOoA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1643034286; a=rsa-sha256; cv=none; b=a9+npIsExw9PW07PZ6cJUiX8S4UoxIuECN0FbuSsI0Mtx+5l4XHet/OGq43vWGtWrbMI9V YPtcDSe1iWRbxTA58ZkyInIOlfn9TGmrJPPeYn1ibC+kaKyZE7WVQuh+ceT3pqQNcTLsGa BxmzNI9v4VpXc6z3cTrBXtFey3IuMePZQKq1lwr5POEWwabsDuxqfGtW1mjxv0H9fgMb7h EsnuDiyO2MCdDyA92r7n2slkQk+9PW7cEIIq0uKNlVax6GgcNfdoFf0u8D4+SJTZ8Nwm2H ndza41ahyvc8v5bGz+3HpXInJAJJabvSiolxxtRmKApkPJlmeY0xp0w48Qi4nA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -3.63 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "bug-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="bug-guix-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: CC29338EFD X-Spam-Score: -3.63 X-Migadu-Scanner: scn1.migadu.com X-TUID: BXqXEwUlseOs Hi, Maxime Devos skribis: > 'version' does denote a file format version. Calling it an API version > is somewhat inaccurate, because it is not a application _programming_ > interface -- you can't write Scheme code in .guix-authorizations, > only S-exps that match the file format. > > While it is the version of the file format, it is not the version of > the file, which I believe is were the confusion came from? > > Also, changing 'version' to 'api-version' would probably prevent old > versions of Guix (that only recognise 'version') from pulling new > versions of Guix (that would have an 'api-version' in their > .guix-authorizations) (untested). I agree with everything you wrote. Christopher, with this in mind, do you think we need a sentence or two in the manual to clarify what the =E2=80=98version=E2=80=99 field is about? Thanks, Ludo=E2=80=99.