From patchwork Tue Apr 1 07:34:42 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Andrew Wong X-Patchwork-Id: 41121 Return-Path: X-Original-To: patchwork@mira.cbaines.net Delivered-To: patchwork@mira.cbaines.net Received: by mira.cbaines.net (Postfix, from userid 113) id 9307F27BBEA; Tue, 1 Apr 2025 08:55:37 +0100 (BST) X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on mira.cbaines.net X-Spam-Level: X-Spam-Status: No, score=-6.4 required=5.0 tests=BAYES_00,DKIM_INVALID, DKIM_SIGNED,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_BLOCKED, RCVD_IN_VALIDITY_CERTIFIED,RCVD_IN_VALIDITY_RPBL,RCVD_IN_VALIDITY_SAFE, SPF_HELO_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) by mira.cbaines.net (Postfix) with ESMTPS id 2F38527BBE2 for ; Tue, 1 Apr 2025 08:55:37 +0100 (BST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tzWSq-0004G0-Iz; Tue, 01 Apr 2025 03:55:17 -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 1tzWSk-0004BR-8w for guix-patches@gnu.org; Tue, 01 Apr 2025 03:55:10 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1tzWSg-000492-TS for guix-patches@gnu.org; Tue, 01 Apr 2025 03:55:08 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:References:In-Reply-To:Date:From:To:Subject; bh=rEw/HbYuRgONznjQipsSBAnT0veh+bsKQv1n7w/HlCw=; b=G9UFcEUjpo1+XGpWU9V4gv3NP38O/8vzOvx+aPpJzcwgpKGcdEhTgcPYyeJppnKhgUL1ivq4AiKXlgsb3CybOUqK7/oXDplffeZINThoA+JLc8gcnR2Fs0Bwqm0CeJfdHQoDw9EsrjQkx5uQVjcRcWptq1HZjPr7gGzVEM4vuvKuCZflREboh0TQaTmqlFHpWg2p6IdOsfl4KID+8MOBqOSNRa5igQwLtrFLMjXHx7U0h1z2OWrnxN2kuST9yRwZKP1T4ol2o+/Vhempj341vHbbR1oVOcLtb2e96PO3QbO3Mh/CEMQCpnMzzZ59WMFXuRi+arkI9XVn7GsyNo9KBA==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1tzWSg-0005tc-Lu for guix-patches@gnu.org; Tue, 01 Apr 2025 03:55:06 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#76910] [PATCH v3 5/5] gnu: Add hyprland plugin maintainer note Resent-From: Andrew Wong Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Tue, 01 Apr 2025 07:55:06 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 76910 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: 76910@debbugs.gnu.org Cc: Andrew Wong Received: via spool by 76910-submit@debbugs.gnu.org id=B76910.174349405522234 (code B ref 76910); Tue, 01 Apr 2025 07:55:06 +0000 Received: (at 76910) by debbugs.gnu.org; 1 Apr 2025 07:54:15 +0000 Received: from localhost ([127.0.0.1]:45027 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1tzWRq-0005mW-JH for submit@debbugs.gnu.org; Tue, 01 Apr 2025 03:54:15 -0400 Received: from qs51p00im-qukt01080302.me.com ([17.57.155.21]:30483) by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1tzWRl-0005lW-Tz for 76910@debbugs.gnu.org; Tue, 01 Apr 2025 03:54:10 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=icloud.com; s=1a1hai; bh=rEw/HbYuRgONznjQipsSBAnT0veh+bsKQv1n7w/HlCw=; h=From:To:Subject:Date:Message-ID:MIME-Version:x-icloud-hme; b=No+VaB58sD4T+mg0OXMlNownj3lK9ez7cpmbSLOoIWQlh87y7e5/r8hC6vyh7w9o+ jSGy97sA6wPyicov/NC5eEN91DKDxaNwuodN8Zo+GxVesD+pMK3VzQdnEJo94OEb5w Wmm+HEuN91/rv1rQeA/Up/OZhCTLXK1wGmW3AcM1IZn1CoCNI+aPOyoqYwwsdjyC0n CMSqPRWgpQIk3t8XSIjQe/CjHvsUI5ggYx2shaWAMYoR5ZRA/L1YO/docOj/o/MrL6 +cgB1nbYQDuDSdwQARtudck2i9ylhJnNdt2DZQ0TXmbTRoHAlaoHTZNFVohZUzLU+F 2rhJQOZfWLb4g== Received: from wongworks.lan (qs51p00im-dlb-asmtp-mailmevip.me.com [17.57.155.28]) by qs51p00im-qukt01080302.me.com (Postfix) with ESMTPSA id 06E9D114021A; Tue, 1 Apr 2025 07:54:02 +0000 (UTC) Date: Tue, 1 Apr 2025 03:34:42 -0400 Message-ID: X-Mailer: git-send-email 2.49.0 In-Reply-To: References: MIME-Version: 1.0 X-Proofpoint-GUID: J-Xv6m_FuQvGx6nVq26C2akVpyr1fK8n X-Proofpoint-ORIG-GUID: J-Xv6m_FuQvGx6nVq26C2akVpyr1fK8n X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1095,Hydra:6.0.680,FMLib:17.12.68.34 definitions=2025-04-01_03,2025-03-27_02,2024-11-22_01 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 bulkscore=0 suspectscore=0 mlxscore=0 phishscore=0 clxscore=1015 mlxlogscore=999 adultscore=0 spamscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2308100000 definitions=main-2504010051 X-Apple-Remote-Links: v=1;h=KCk=;charset=UTF-8 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: , Reply-to: Andrew Wong X-ACL-Warn: , Andrew Wong via Guix-patches X-Patchwork-Original-From: Andrew Wong via Guix-patches via From: Andrew Wong Errors-To: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org Sender: guix-patches-bounces+patchwork=mira.cbaines.net@gnu.org X-getmail-retrieved-from-mailbox: Patches Change-Id: I971940d515b1820532abbc31754d31d6f2efd515 --- gnu/packages/wm.scm | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/gnu/packages/wm.scm b/gnu/packages/wm.scm index 537150e138..03ccc0dce6 100644 --- a/gnu/packages/wm.scm +++ b/gnu/packages/wm.scm @@ -447,6 +447,33 @@ (define-public hyprland `((upstream-name . "source"))) (license license:bsd-3))) + +;; READ THIS regarding Hyprland plugin versioning +;; +;; Each Hyprland plugin contains a .toml file with an entry called `commit_pins' +;; containing pairs of commit hashes. The first hash is Hyprland's commit hash, and +;; the second hash is the hash of the plugin repository which hyprpm would switch to +;; before compiling the plugin[1]. Therefore, to remain consistent with hyprpm, when +;; upgrading a plugin, maintainers should check its .toml file and use the hash +;; corresponding to the packaged Hyprland version. If Hyprland's packaged commit is +;; not listed, packagers should use the latest working commit. For plugins that lack +;; their own version numbers, we will use git-version, with the newest supported +;; Hyprland version as the VERSION argument. +;; +;; A flaw with this way of doing things is that the correct version of a plugin will +;; not automatically be built if a transformation is used to select a different +;; version of Hyprland from what is packaged, or if Hyprland is updated without its +;; plugins. However, with the rapid pace (as of 1 Apr 2025) of Hyprland and related +;; softwares, we can reasonably hope that soon, either A) hyprpm will develop enough +;; to become usable as a Guix-managed build tool, or B) hyprpm will become obsolete +;; by the introduction of a stable, versioned Hyprland API. +;; +;; You can safely test plugins by launching hyprland from a shell (wayland sessions +;; can run within each other) and loading the plugin into it using hyprctl's +;; '--instance' option and 'plugin load' command. +;; +;; [1] https://wiki.hyprland.org/Plugins/Development/Plugin-Guidelines/#commit-pins + (define hyprland-plugin (lambda (plugin-name plugin-provision) "Generate a packaged plugin from Hyprland's official plugin repository."