From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id +LKQADjllGEeSAEAgWs5BA (envelope-from ) for ; Wed, 17 Nov 2021 12:19:20 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id uIr9NzfllGGEFwAA1q6Kng (envelope-from ) for ; Wed, 17 Nov 2021 11:19:19 +0000 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 ADBE712462 for ; Wed, 17 Nov 2021 12:19:19 +0100 (CET) Received: from localhost ([::1]:37410 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1mnIyE-0004Sx-Uu for larch@yhetil.org; Wed, 17 Nov 2021 06:19:18 -0500 Received: from eggs.gnu.org ([209.51.188.92]:33014) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mnIxp-0004RV-Jy for guix-devel@gnu.org; Wed, 17 Nov 2021 06:18:56 -0500 Received: from [2001:470:142:3::e] (port=55848 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mnIxn-0000Bf-Ou; Wed, 17 Nov 2021 06:18:52 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:In-Reply-To:Date:References:Subject:To: From; bh=nmPj65lxfcpaoavbj0uaVoMJaPKj5CVpsbTMmZ1DlJs=; b=QsWuuCrcq2p1zLtmAABk IvnzPmp++s0YJhNyLJm8r4/gKcTQaXEvvs9MEDa7zdVyuwRs3OB8aeuGCGzfx6ToBDctTTAB0RTNI 8kzC7TmL2JZPL8nXTYSLrZoimunocm7vH/MvJVzOnpwO9m5boPX02uMm4CcdGEkVNr0AoD1lfNrk/ 2d/6F6MeYdYubpybOf1CYOopNpMd2n4i+1O7/Bq9yXs7GWxx9qez/Kk4xf54cbzlkVcCO0gO7tfyj 5ZPJRsMEi6Qd/eZuJKyPSpSKkQ/oz1TrbYtfR4CD8Ucr8uuAwhnwSupQborjlsbh384PSX4hszZo1 h6yh0DhPBhs7ww==; Received: from 91-160-117-201.subs.proxad.net ([91.160.117.201]:50354 helo=ribbon) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1mnIxm-0000Dm-F5; Wed, 17 Nov 2021 06:18:50 -0500 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= To: zimoun Subject: Re: Recommend order for package fields? References: <3add15b77522d6e9ebd715a19d966666@selfhosted.xyz> <87r1bsqdy8.fsf@nckx> <86tugd9xlz.fsf@gmail.com> X-URL: http://www.fdn.fr/~lcourtes/ X-Revolutionary-Date: 27 Brumaire an 230 de la =?utf-8?Q?R=C3=A9volution?= X-PGP-Key-ID: 0x090B11993D9AEBB5 X-PGP-Key: http://www.fdn.fr/~lcourtes/ludovic.asc X-PGP-Fingerprint: 3CE4 6455 8A84 FDC6 9DB4 0CFB 090B 1199 3D9A EBB5 X-OS: x86_64-pc-linux-gnu Date: Wed, 17 Nov 2021 12:18:48 +0100 In-Reply-To: <86tugd9xlz.fsf@gmail.com> (zimoun's message of "Mon, 15 Nov 2021 17:45:12 +0100") Message-ID: <87bl2jxc6f.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-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: , Cc: Guix Devel Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" 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=1637147959; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=nmPj65lxfcpaoavbj0uaVoMJaPKj5CVpsbTMmZ1DlJs=; b=BBnL7SNt84Rd8mT2VN8P0+XCvLFbEDJZ5jniPl5vX/7G4xmHfL3mLfzonPh4rvqFtb23I+ ZwWOhDQatyNgaoV2HiyX3IIH7IzrK+STWcG7+2Vcl0TO5KhDBpCgeWzZD/w+VHJV8Nl9gE PU1+hbbAobxwfBIdCSm6BPv7/4PHTienC/dXOxsdjUP0ZiddUT6gg6wZcZy3RjBXJIa93+ iwQ179UKQ1wDjRJCwQIyyv/HlPYRdXDu3/Y0osb1hnXer9VOojyh/rAe6IjyWaB2wkaSBE SVlMUlxis/GApY9t3w3btcl/WctTe6UWH6lscyXMPGVtOpXgUAT1AndaUH97MQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1637147959; a=rsa-sha256; cv=none; b=mCl+VQiSPWy/Pnb/InDlv0ndts3jd3JWrKhzigQJKfaDtpSO7oofQO8LD635ZwxEGxObX0 hhVPsX3fmUAb2XdpH3y8QAPadrWp2+hWcJ2xMSwpeuiqGaMUy6qAyC4T7PtXHMTxwx8Rl1 8IEWT7LyvGe9guHyds+1GKGrd9iZVrlNbVtCL+qclBPdn7DxZOzsu2juW/8d4F10DahBQw u8YicCIgMcoa+dxNsPEARgIae542Lfvu/+lr4vnEKnr5JdK3P/7aGaD30hDVzr58UlfP07 4bC54qpi8+6WZ5kR71a3uftB1dMGfdfBp/fA3d0kyj8sp8qVuZL6Tlnr+2COlw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b=QsWuuCrc; 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" X-Migadu-Spam-Score: -3.75 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gnu.org header.s=fencepost-gnu-org header.b=QsWuuCrc; 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" X-Migadu-Queue-Id: ADBE712462 X-Spam-Score: -3.75 X-Migadu-Scanner: scn0.migadu.com X-TUID: wh0N+sTpSIW1 Hi, zimoun skribis: > On Sun, 07 Nov 2021 at 13:40, Tobias Geerinckx-Rice via Guix-patches via = wrote: > >> So the de-facto ordering of common fields is something like: >> >> name >> version >> source >> build-system >> outputs ; a bit inconsistent, yes, and sometimes put after *inputs >> arguments ; to the build-system >> native-inputs, inputs, propagated-inputs >> metadata: synopsis, description, home-page, properties, license=E2=80=A6 >> >> There's some minor variation in where to put inputs, but=20 >> (build-system trivial-build-system) definitely belongs here, above=20 >> arguments, no matter what. > > Does it make sense to add this ordering advice in the manual? Somewhere > under section =E2=80=9CContributing=E2=80=9D. I don=E2=80=99t think so; examples in the manual, =E2=80=98guix import=E2= =80=99, etc. are already mostly consistent. > Especially when there is probably some issues with the semantic, for > instance, compare [1] corner cases: It=E2=80=99s not a corner case, it=E2=80=99s lexical scoping. :-) > If yes, why not add a checker for =E2=80=9Cguix lint=E2=80=9D for warning= that? And > obviously, it could be nice to have an automatic tool for formatting; > something similar as etc/indent-code.el for ordering packages. ;-) I think =E2=80=98guix style=E2=80=99 should eventually be improved to repla= ce etc/indent-code.el. We could augment it with specific stylers, such as alphabetically sorting inputs. Thanks, Ludo=E2=80=99.