From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id unR6DdhQ22HMYAAAgWs5BA (envelope-from ) for ; Sun, 09 Jan 2022 22:17:12 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id MKprBdhQ22HoYwEAG6o9tA (envelope-from ) for ; Sun, 09 Jan 2022 22:17:12 +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 B75023FB31 for ; Sun, 9 Jan 2022 22:17:11 +0100 (CET) Received: from localhost ([::1]:40604 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n6fYr-0000oe-RS for larch@yhetil.org; Sun, 09 Jan 2022 16:17:09 -0500 Received: from eggs.gnu.org ([209.51.188.92]:47336) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n6fYl-0000oS-8G for guix-patches@gnu.org; Sun, 09 Jan 2022 16:17:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:58553) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1n6fYk-0007K6-IV for guix-patches@gnu.org; Sun, 09 Jan 2022 16:17:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1n6fYk-00048p-Dq for guix-patches@gnu.org; Sun, 09 Jan 2022 16:17:02 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#53144] [PATCH 01/13] doc: Give some tips on Minetest packaging. Resent-From: Liliana Marie Prikler Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 09 Jan 2022 21:17:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 53144 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Maxime Devos , 53144@debbugs.gnu.org Received: via spool by 53144-submit@debbugs.gnu.org id=B53144.164176296513146 (code B ref 53144); Sun, 09 Jan 2022 21:17:02 +0000 Received: (at 53144) by debbugs.gnu.org; 9 Jan 2022 21:16:05 +0000 Received: from localhost ([127.0.0.1]:51456 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n6fXo-0003PY-Ts for submit@debbugs.gnu.org; Sun, 09 Jan 2022 16:16:05 -0500 Received: from mail-wr1-f65.google.com ([209.85.221.65]:41564) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n6fXm-0003Hd-Oo for 53144@debbugs.gnu.org; Sun, 09 Jan 2022 16:16:03 -0500 Received: by mail-wr1-f65.google.com with SMTP id v6so23064125wra.8 for <53144@debbugs.gnu.org>; Sun, 09 Jan 2022 13:16:02 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=message-id:subject:from:to:date:in-reply-to:references:user-agent :mime-version:content-transfer-encoding; bh=2YHTPqZq6nNsyuh2AVtocD0anax4z0XgUL58CaQpwRg=; b=Gmea0PlC99FPLeuDn+Y9bk9Bbm9Y2l5DRNxDCu/TDKUaG+hNHRiWyYAXheenJsClLO 5iqNJpwUgS1VN1iva0NBfVEXWEv5APIIlxQsr285IasvDgg+yU+QD4sxMaR1CmdHO6nB BAl2hmvIzbnB08+Mrs3H31iXoowQvRajrY12sT1IS95eBjg0sEdo9bvPG3qntOK2I/hy W+iYJdIqmH+ALUCzlwR3hwMRo1xWLRy3LkFZf47M5rNpCNzPvigvCre/hG/u3shyMxhA uP3Frus9fe8lgjQWpJfULfejkQgmA1Mrae8wNf4yKyKtiUkDxjszRcGhyWMVFV1fhGqe 41Fw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:message-id:subject:from:to:date:in-reply-to :references:user-agent:mime-version:content-transfer-encoding; bh=2YHTPqZq6nNsyuh2AVtocD0anax4z0XgUL58CaQpwRg=; b=DuMZjEx3GVKpW3FjgRalKljGFFhxgHak9n6knHLor1jWhpvvPSCo1dks3mqFLIakZK 6U2bkxeriUC+R4q2Q8wKqIf+lNUFse1zlIoC43ECUBOpNSfeo1sAD9xeal7ySd4EmVmP t3UsGM8F6uW/yoXWuVHx0qbBUZ5QJW5HR8jsMJbqafcP0T0k8JOG89ZliuCDKHm0tbwo GKC2erksawllv+I6Ec//M4/j3LitIypvfHhDFmOTHbh+wewGQwyy8sEVweZVC0tLhMZB 1kjx1uevXrv9gD2eiE6pv/aGLcHqeEFsfOKgfOvI19DKzeWYL752zMhfj7QNy5g8XHPR 2B3w== X-Gm-Message-State: AOAM532p8k/oYw5EK8R2IDfj2SvwORZwGJ8Vdh+KMWs22fq3SoA9XO/Z m73ShpjYAVXEgQyAJfpjzRU= X-Google-Smtp-Source: ABdhPJwgp/khpk2ofUsNRRSTdvUZ+Q5hq6Zhe51q1tNLRwJ3O3dlykYh7PXC8bTZE+2kzyRzPzWdnQ== X-Received: by 2002:a05:6000:1acb:: with SMTP id i11mr60583334wry.244.1641762956651; Sun, 09 Jan 2022 13:15:56 -0800 (PST) Received: from nijino.fritz.box (85-127-52-93.dsl.dynamic.surfer.at. [85.127.52.93]) by smtp.gmail.com with ESMTPSA id h2sm4973808wrr.96.2022.01.09.13.15.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 09 Jan 2022 13:15:56 -0800 (PST) Message-ID: From: Liliana Marie Prikler Date: Sun, 09 Jan 2022 22:15:54 +0100 In-Reply-To: <20220109191015.33058-1-maximedevos@telenet.be> References: <20220109191015.33058-1-maximedevos@telenet.be> Content-Type: text/plain; charset="UTF-8" User-Agent: Evolution 3.42.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit 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" 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=1641763031; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to: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=2YHTPqZq6nNsyuh2AVtocD0anax4z0XgUL58CaQpwRg=; b=d3obMxQf3XDc7wAcQM21m+dI1DjExgtiM+Gqif1lOw9ZF4KzrYdaqyLsWHbco3nATRHSTE BBX24Jc0sO4Id+BSWk5Xukn7k6r/VxRBszBD+ywUO2BYdXzRtS1qHtzqT4Fo8SQu18HUcZ TFCz9Mzoum2bGzadyqGFc8ubAm70Q2ODA5lz8LQyvdCKbFbo+Ru3pdaP3XHDDobkgbl+AQ Oi89oeieRb0347gzO9V3Zyld4oUl8fmJU2iOkoh/grF8CPYIrbSukIPSm/k7jh2bnu8CJI osK8LlwgVYbrmPVZDP7zkkrqdWCgzfc1Js40l8Q0m15cMPiLh9IDIjakojqtqA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1641763031; a=rsa-sha256; cv=none; b=ZCBgSuO6si38huM2HtAY4t2hStpoZ1NxZuJuEnIiVZaSv1pPSmBSsHA2IjOs9qmYp9cyGc BHSgoAZuiQ9aSHnVp7VGghXCU/LrZT1vbm7fKnY7zXY63+5tVsSUfJ5fm9CLfFDBIWboSR wWa50oX0TFvApBep3HQE96qGlUlyrU4ljdvdzv34iHoHrcJ4NgqyV7p0WtduY0Yd9Bcxb5 CFA4wSGgsS3/AyWrmVOKXkqaHwkLmBPcrRBER/YriMnKt2Tip+uafbZRTrwLEgPXcIb1IZ ExP65RcdKqsFMrdXwIOLeS2/2hFj+20PtuXYs/iJ50SMiMYHFtUNmL53eZUlfA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Gmea0PlC; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); 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" X-Migadu-Spam-Score: -3.01 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=Gmea0PlC; dmarc=fail reason="SPF not aligned (relaxed)" header.from=gmail.com (policy=none); 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" X-Migadu-Queue-Id: B75023FB31 X-Spam-Score: -3.01 X-Migadu-Scanner: scn0.migadu.com X-TUID: 0ctpXZAgnWgI Am Sonntag, dem 09.01.2022 um 19:10 +0000 schrieb Maxime Devos: > * doc/contributing.texi (Minetest Packages): New section. > * doc/guix.texi: Copyright update. > --- >  doc/contributing.texi | 42 > ++++++++++++++++++++++++++++++++++++++++++ >  doc/guix.texi         |  2 +- >  2 files changed, 43 insertions(+), 1 deletion(-) > > diff --git a/doc/contributing.texi b/doc/contributing.texi > index 72f5ce1e0e..5b91fc7867 100644 > --- a/doc/contributing.texi > +++ b/doc/contributing.texi > @@ -394,6 +394,7 @@ needed is to review and apply the patch. >  * Synopses and Descriptions::   Helping users find the right > package. >  * Snippets versus Phases::      Whether to use a snippet, or a build > phase. >  * Emacs Packages::              Your Elisp fix. > +* Minetest Packages::           Building blocks. >  * Python Modules::              A touch of British comedy. >  * Perl Modules::                Little pearls. >  * Java Packages::               Coffee break. > @@ -703,6 +704,47 @@ When encountering problems, it is wise to check > for the presence of the >  file, and whether any dependencies and their versions listed therein > are >  satisfied. >   > +@node Minetest Packages > +@subsection Minetest Packages > +@cindex minetest, packaging > + > +A Minetest mod @code{foo} is named @code{minetest-foo} -- the author > +name from ContentDB is not included, unless required to resolve a > name > +collision. > + > +Sometimes, it might be unclear what the version of a Minetest mod > is. > +For example, ContentDB and the importer reports 2020-01-01, but > +according to the forums the version is 2.1.  Usually, in these cases > the > +version on ContentDB is the newest and intended for distribution. As > +such, you can use the version from ContentDB without any special > +comments. We might want to quote an authoritative resource on that, perhaps in the footnote? > +@c Currently it's always checked out from git, but in principle > +@c tarballs could be used. > + > +Even though the source code is often checked out from version > control, > +it is not necessary to use @code{git-version} or @code{hg-version}: > the > +releases on ContentDB are formal releases; in fact they are > upstream's > +official source of Minetest packages and they are not mutated in- > place. > + > +@c Example (zip): mods by TenPlus1 > +@c Example (git): basic_materials, ethereal > +While ContentDB provides the source code of packages in zip form, it > is > +recommended not to use these, because users can and do delete old > +versions.  Likewise, sometimes the maintainer initially did tag > versions > +but later stops doing so, breaking @command{guix refresh -u}.  As > such, > +it is recommended not to use git tags in @code{origin} records and > +instead refer to the commit directly. This combination of version+commit is something I'd generally discourage (my reasoning for doing so already explained elsewhere), so to me it might make sense to still explicitly point attention to it. Perhaps setting a package-property such as (upstream . contentdb), which would also make it clear why we don't e.g. want the latest-git updater to apply? Otherwise LGTM.