X-Loop: help-debbugs@HIDDEN Subject: bug#53221: Keeping Version header and tag in sync Resent-From: Jonas Bernoulli <jonas@HIDDEN> Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> Resent-CC: bug-gnu-emacs@HIDDEN Resent-Date: Wed, 12 Jan 2022 18:35:02 +0000 Resent-Message-ID: <handler.53221.B.1642012463695 <at> debbugs.gnu.org> Resent-Sender: help-debbugs@HIDDEN X-GNU-PR-Message: report 53221 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 53221 <at> debbugs.gnu.org Cc: Stefan Kangas <stefan@HIDDEN> X-Debbugs-Original-To: bug-gnu-emacs@HIDDEN Received: via spool by submit <at> debbugs.gnu.org id=B.1642012463695 (code B ref -1); Wed, 12 Jan 2022 18:35:02 +0000 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 <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1n7iRy-0000B9-Qy for submit <at> 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 <jonas@HIDDEN>) id 1n7iRw-00009w-1P for submit <at> 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 <jonas@HIDDEN>) id 1n7iRs-0006cI-0h for bug-gnu-emacs@HIDDEN; 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 <jonas@HIDDEN>) id 1n7iRp-0002XK-FJ for bug-gnu-emacs@HIDDEN; 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 <jonas@HIDDEN> Date: Wed, 12 Jan 2022 19:34:06 +0100 Message-ID: <8735lspzvl.fsf@HIDDEN> MIME-Version: 1.0 Content-Type: text/plain Received-SPF: none client-ip=212.243.197.30; envelope-from=jonas@HIDDEN; 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-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> 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
Content-Disposition: inline Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-Mailer: MIME-tools 5.505 (Entity 5.505) Content-Type: text/plain; charset=utf-8 X-Loop: help-debbugs@HIDDEN From: help-debbugs@HIDDEN (GNU bug Tracking System) To: Jonas Bernoulli <jonas@HIDDEN> Subject: bug#53221: Acknowledgement (Keeping Version header and tag in sync) Message-ID: <handler.53221.B.1642012463695.ack <at> debbugs.gnu.org> References: <8735lspzvl.fsf@HIDDEN> X-Gnu-PR-Message: ack 53221 X-Gnu-PR-Package: emacs Reply-To: 53221 <at> debbugs.gnu.org Date: Wed, 12 Jan 2022 18:35:02 +0000 Thank you for filing a new bug report with debbugs.gnu.org. This is an automatically generated reply to let you know your message has been received. Your message is being forwarded to the package maintainers and other interested parties for their attention; they will reply in due course. Your message has been sent to the package maintainer(s): bug-gnu-emacs@HIDDEN If you wish to submit further information on this problem, please send it to 53221 <at> debbugs.gnu.org. Please do not send mail to help-debbugs@HIDDEN unless you wish to report a problem with the Bug-tracking system. --=20 53221: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D53221 GNU Bug Tracking System Contact help-debbugs@HIDDEN with problems
Received: (at control) by debbugs.gnu.org; 13 Jan 2022 12:22:11 +0000 From debbugs-submit-bounces <at> debbugs.gnu.org Thu Jan 13 07:22:11 2022 Received: from localhost ([127.0.0.1]:60365 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>) id 1n7z7L-0002s8-BY for submit <at> 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 <stefankangas@HIDDEN>) id 1n7z7H-0002rd-Ei for control <at> 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 <control <at> debbugs.gnu.org>; 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 <stefan@HIDDEN> MIME-Version: 1.0 Date: Thu, 13 Jan 2022 04:22:01 -0800 Message-ID: <CADwFkmnxAWuDAL-hrnaSUtrgJnb82SdyyFUsxcUWnfJ==2VXXg@HIDDEN> Subject: control message for bug #53221 To: control <at> debbugs.gnu.org Content-Type: text/plain; charset="UTF-8" X-Spam-Score: 0.5 (/) X-Debbugs-Envelope-To: control X-BeenThere: debbugs-submit <at> debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: <debbugs-submit.debbugs.gnu.org> List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe> List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/> List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org> List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help> List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe> Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org> X-Spam-Score: -0.5 (/) severity 53221 wishlist quit
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.