From debbugs-submit-bounces@debbugs.gnu.org Wed Jan 12 13:34:23 2022 Received: (at submit) by debbugs.gnu.org; 12 Jan 2022 18:34:23 +0000 Received: from localhost ([127.0.0.1]:59068 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7iRy-0000B9-Qy for submit@debbugs.gnu.org; Wed, 12 Jan 2022 13:34:23 -0500 Received: from lists.gnu.org ([209.51.188.17]:48380) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7iRw-00009w-1P for submit@debbugs.gnu.org; Wed, 12 Jan 2022 13:34:21 -0500 Received: from eggs.gnu.org ([209.51.188.92]:45984) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7iRs-0006cI-0h for bug-gnu-emacs@gnu.org; Wed, 12 Jan 2022 13:34:19 -0500 Received: from mail.hostpark.net ([212.243.197.30]:38592) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n7iRp-0002XK-FJ for bug-gnu-emacs@gnu.org; Wed, 12 Jan 2022 13:34:15 -0500 Received: from localhost (localhost [127.0.0.1]) by mail.hostpark.net (Postfix) with ESMTP id 7836F160EE; Wed, 12 Jan 2022 19:34:08 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=bernoul.li; h= content-type:content-type:mime-version:message-id:date:date :subject:subject:from:from:received:received; s=sel2011a; t= 1642012446; bh=J8D5H1yDDxsLqmzdtuXbNWiKM9tjNrh67Mh+lAj0rzo=; b=K CqvJtyxqu0cpxv/DZZB4SdFO7z8AQPDDTPuZ/q99brbOW2jT696/BmFU3gXuWl+z 7G1zFU25nF1Tj9EtT78N2tnalRW4f8my+6GHZ2yhn8iLokxPr7HaFV81L/RCxPh1 x9tO03u2FbXDRRORwj/Uf+mZbKSx/71JYOq4Tv+lnc= X-Virus-Scanned: by Hostpark/NetZone Mailprotection at hostpark.net Received: from mail.hostpark.net ([127.0.0.1]) by localhost (mail1.hostpark.net [127.0.0.1]) (amavisd-new, port 10224) with ESMTP id 7TRxgXh6iplH; Wed, 12 Jan 2022 19:34:06 +0100 (CET) Received: from customer (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-256) server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mail.hostpark.net (Postfix) with ESMTPSA id 4ACDB164A8; Wed, 12 Jan 2022 19:34:06 +0100 (CET) From: Jonas Bernoulli To: bug-gnu-emacs@gnu.org Subject: Keeping Version header and tag in sync Date: Wed, 12 Jan 2022 19:34:06 +0100 Message-ID: <8735lspzvl.fsf@bernoul.li> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: none client-ip=212.243.197.30; envelope-from=jonas@bernoul.li; helo=mail.hostpark.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-Spam-Score: -2.3 (--) X-Debbugs-Envelope-To: submit Cc: Stefan Kangas X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) Hello, I have brought this up elsewhere and Stefan Kangas asked me to repeat it here so we don't forget about it. 1: https://github.com/magit/orgit/pull/45 [Non]GNU Elpa uses the [Package-]Version header to determine a package's version, while Melpa Stable uses the latest Git/Hg version tag. (Let's not talk about what Melpa "bleeding edge" does.) It is desirable that these package archives as well as other tools that use either one of these techniques agree which commit a version string refers too. To accomplish this we have to bump the version in both locations at the same time. At the exact same time! One should not bump the Version header in one commit, add a few more commits, and then tag the latest commit with the same version as was first used in the library header a few commits earlier. We are stuck with two sources for the same information and we should try hard to keep these two sources in agreement. This also means that when we invite new packages into [Non]GNU Elpa and instruct their maintainers to add the Version header, that we then also make them aware of this complication. IMO this is how it should be done given the current schism: 1. Update the `Version` header keyword. 2. Possibly make other release-related changes like updating the `NEWS` file or updating the version in manuals and such. 3. Create a commit with a message like "Release version VERSION", where VERSION is exactly the same version as used in the header. 4. Tag that commit using the same version as used in the header and commit message (optionally prefixed with `v` because that is the Git convention). Ideally the tag is signed and annotated. If it is annotated, then it should use a message like "Release version VERSION" or "PACKAGE-NAME VERSION". 5. When pushing the release commit, then don't forget to push the release tag as well. Obviously it would be nice to say the above with less words. ;) Jonas From debbugs-submit-bounces@debbugs.gnu.org Thu Jan 13 07:22:11 2022 Received: (at control) by debbugs.gnu.org; 13 Jan 2022 12:22:11 +0000 Received: from localhost ([127.0.0.1]:60365 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7z7L-0002s8-BY for submit@debbugs.gnu.org; Thu, 13 Jan 2022 07:22:11 -0500 Received: from mail-pj1-f42.google.com ([209.85.216.42]:41635) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1n7z7H-0002rd-Ei for control@debbugs.gnu.org; Thu, 13 Jan 2022 07:22:10 -0500 Received: by mail-pj1-f42.google.com with SMTP id b1-20020a17090a990100b001b14bd47532so11013125pjp.0 for ; Thu, 13 Jan 2022 04:22:07 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:mime-version:date:message-id:subject:to; bh=w6tcHJs8Oo5PMFO1zTlM3Kb57nUUOdaBn/5iDclb1Ec=; b=fG4rXpzFYx0pqib5ePd70fdLi1l2Ve2EeVPXZwMUOHq/ZjumaDBus0r8IUlRdcbQf8 HW3ABN6RdXIBqCAdWJCw+Dd4+e4fjOv7w8d6+ySfnJZ4Dj3pKMetin6kCpjZbtu7VL9V 4Tot1TJn4P6WQu4LR+iPMbGRZ/bMT34ptQZer08QSQHTiDjJV69Q19AxT2beqzTvLzzm k2A4+VENxWX5tO9FPAzzaE55fBIxaWeNyxOVPGJEEUu7Z2Hjw3wsTVwTyzpSmNB5Mg1+ R+K6v2VEuOUlElAmTob+5CjhS/CDUPsI1QpvjllSKTheAcXTgjpKYJKgayDpdnj8FVYn 34Tg== X-Gm-Message-State: AOAM533BBjwsCvV+eGpj/w/4Ych1DrvG9/NfURaCxaBbEYP15sC5Z8fL ptpvsq6tykKJww32dY4nPQ3VgCeAtOq+ZQsY7v3+je7XvQc= X-Google-Smtp-Source: ABdhPJxRg88q9UtvOBrjHviE1136vBqJve9L0WQVxN2ImE8HBgH8tyhKLPVmWE66JMgUAbjOO/X80NkjvWsclBXEmqU= X-Received: by 2002:a17:90b:4b0e:: with SMTP id lx14mr14253845pjb.132.1642076521771; Thu, 13 Jan 2022 04:22:01 -0800 (PST) Received: from 753933720722 named unknown by gmailapi.google.com with HTTPREST; Thu, 13 Jan 2022 04:22:01 -0800 From: Stefan Kangas MIME-Version: 1.0 Date: Thu, 13 Jan 2022 04:22:01 -0800 Message-ID: Subject: control message for bug #53221 To: control@debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.5 (/) severity 53221 wishlist quit