[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Bug#1091868: marked as done (debian-policy: Document Git-Tag-Tagger and Git-Tag-Info fields)

Your message dated Tue, 23 Dec 2025 13:34:04 +0000
with message-id <E1vY2Wa-002y43-2E@fasolo.debian.org>
and subject line Bug#1091868: fixed in debian-policy 4.7.3.0
has caused the Debian Bug report #1091868,
regarding debian-policy: Document Git-Tag-Tagger and Git-Tag-Info fields
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact owner@bugs.debian.org
immediately.)


-- 
1091868: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1091868
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: debian-policy
X-debbugs-cc: ijackson@chiark.greenend.org.uk

Here is a patch documenting the new tag2upload fields, in accordance
with the spec.[1]  Seeking seconds.

[1]  https://salsa.debian.org/dgit-team/dgit/-/blob/master/TAG2UPLOAD-DESIGN.txt

-- 
Sean Whitton

From a76c70f226250c902d3401983d03e3a8074996cb Mon Sep 17 00:00:00 2001
From: Sean Whitton <spwhitton@spwhitton.name>
Date: Wed, 1 Jan 2025 19:14:06 +0000
Subject: [PATCH] Document Git-Tag-Tagger and Git-Tag-Info fields

---
 policy/ch-controlfields.rst    | 44 ++++++++++++++++++++++++++++++++++
 policy/upgrading-checklist.rst |  5 ++++
 2 files changed, 49 insertions(+)

diff --git a/policy/ch-controlfields.rst b/policy/ch-controlfields.rst
index 530755a..8686381 100644
--- a/policy/ch-controlfields.rst
+++ b/policy/ch-controlfields.rst
@@ -237,6 +237,10 @@ is described above, in :ref:`s-controlsyntax`.
 
 -  :ref:`Dgit <s-f-Dgit>`
 
+-  :ref:`Git-Tag-Tagger <s-f-Git-Tag-Tagger>`
+
+-  :ref:`Git-Tag-Info <s-f-Git-Tag-Info>`
+
 -  :ref:`Standards-Version <s-f-Standards-Version>` (mandatory)
 
 -  :ref:`Build-Depends et al <s-sourcebinarydeps>`
@@ -291,6 +295,10 @@ The fields in this file are:
 
 -  :ref:`Changed-By <s-f-Changed-By>`
 
+-  :ref:`Git-Tag-Tagger <s-f-Git-Tag-Tagger>`
+
+-  :ref:`Git-Tag-Info <s-f-Git-Tag-Info>`
+
 -  :ref:`Description <s-f-Description>` (mandatory in some cases)
 
 -  :ref:`Closes <s-f-Closes>`
@@ -1307,6 +1315,42 @@ This list is intentionally incomplete. You should consult the
 documentation of the tool or package in question for which keywords it
 defines and when they are needed.
 
+.. _s-f-Git-Tag-Tagger:
+
+``Git-Tag-Tagger``
+~~~~~~~~~~~~~~~~~~
+
+Name and e-mail address of the person who made the Git tag from which this
+upload was generated (and to which it corresponds) in accordance with the
+tagging protocol described in the :manpage:`tag2upload(5)` manual page.
+The syntax is the same as for the :ref:`Maintainer field <s-f-Maintainer>`.
+The value comes from the ``tagger`` line of the raw Git tag.
+
+Uploads signed by an implemention of the tag2upload service must include this
+field.  Uploads not generated in accordance with the tag2upload protocol must
+not include this field.
+
+.. _s-f-Git-Tag-Info:
+
+``Git-Tag-Info``
+~~~~~~~~~~~~~~~~
+
+Other information about the Git tag from which this upload was generated (and
+to which it corresponds) in accordance with the tagging protocol described in
+the :manpage:`tag2upload(5)` manual page.
+
+The value is of the form ``tag=TAGOBJID fp=FINGERPRINT`` where ``TAGOBJID`` is
+the Git object ID of the Git tag object, and ``FINGERPRINT`` is the
+fingerprint (in hexadecimal, without spaces) of the PGP key used to sign the
+Git tag.
+
+The Git tag object is obtainable from the *dgit-repos* server, as described
+under ``Dgit``, above.
+
+Uploads signed by an implemention of the tag2upload service must include this
+field.  Uploads not generated in accordance with the tag2upload protocol must
+not include this field.
+
 .. _s5.7:
 
 User-defined fields
diff --git a/policy/upgrading-checklist.rst b/policy/upgrading-checklist.rst
index 22df672..6ea5f06 100644
--- a/policy/upgrading-checklist.rst
+++ b/policy/upgrading-checklist.rst
@@ -44,6 +44,11 @@ Version 4.7.1
 
 Unreleased.
 
+5.6.32 & 5.6.33
+    New sections documenting the ``Git-Tag-Tagger`` and ``Git-Tag-Info``
+    fields in Debian source control and ``.changes`` files.
+
+
 10.1
     Two different packages must not install programs with different
     functionality to the same filenames, even names under different
-- 
2.39.5

Attachment: signature.asc
Description: PGP signature


--- End Message ---
--- Begin Message --- 
Source: debian-policy
Source-Version: 4.7.3.0
Done: Sean Whitton <spwhitton@spwhitton.name>

We believe that the bug you reported is fixed in the latest version of
debian-policy, which is due to be installed in the Debian FTP archive.

A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 1091868@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Sean Whitton <spwhitton@spwhitton.name> (supplier of updated debian-policy package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@ftp-master.debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Format: 1.8
Date: Tue, 23 Dec 2025 13:19:12 +0000
Source: debian-policy
Architecture: source
Version: 4.7.3.0
Distribution: unstable
Urgency: medium
Maintainer: Debian Policy Editors <debian-policy@lists.debian.org>
Changed-By: Sean Whitton <spwhitton@spwhitton.name>
Closes: 1091868 1100455 1100632 1110017 1114994
Changes:
 debian-policy (4.7.3.0) unstable; urgency=medium
 .
   * Policy: Document range of subordinate user IDs
     Wording: Sean Whitton <spwhitton@spwhitton.name>
     Seconded: Chris Hofstaedtler <zeha@debian.org>
     Seconded: Holger Levsen <holger@layer-acht.org>
     Closes: #1100632
   * Policy: Git-Tag-Tagger & Git-Tag-Info fields
     Wording: Sean Whitton <spwhitton@spwhitton.name>
     Seconded: Ian Jackson <ijackson@chiark.greenend.org.uk>
     Seconded: Stuart Prescott <stuart@debian.org>
     Closes: #1091868
   * Policy: Remove MSDOS-Filename field
     Wording: Guillem Jover <guillem@debian.org>
     Seconded: Sean Whitton <spwhitton@spwhitton.name>
     Seconded: Chris Hofstaedtler <zeha@debian.org>
     Seconded: Holger Levsen <holger@layer-acht.org>
     Closes: #1114994
   * Policy: Priority field no longer recommended
     Wording: Nilesh Patra <nilesh@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Seconded: Sean Whitton <spwhitton@spwhitton.name>
     Closes: #1110017
   * Fix missing word in 10.1 & upgrading checklist.
   * Rewrite "date"->"day-of-month" in Policy 3.2.1 (Closes: #1100455).
     Thanks to Ahmed Siam for reporting the issue.
   * d/control: Drop Priority & Rules-Requires-Root fields.
Checksums-Sha1:
 c5f2f98b722f93cfbf4e928a760d21d100fc407a 2363 debian-policy_4.7.3.0.dsc
 a21034f9c95f626407903a974904806951f45301 577360 debian-policy_4.7.3.0.tar.xz
 3ec1c1dece834bd623f962f1063a70a7ee28a8ee 1193264 debian-policy_4.7.3.0.git.tar.xz
 5b3198675115a6e0d90e6d6a16ef6a3b28c2ec1a 17159 debian-policy_4.7.3.0_source.buildinfo
Checksums-Sha256:
 2d4e7b9dd194c23f229ac4215fba2b7cb2287d91a10d5910e6abe09485c5ed97 2363 debian-policy_4.7.3.0.dsc
 5a76e3daf5895cdc29e209fc214d871c6b2c6f3f20bf15cbcbb12fc3d42e3c03 577360 debian-policy_4.7.3.0.tar.xz
 6c52d45f5a1f041b80f0897c7f4736b4cb3d96898bd3163116d0c7135ad8614e 1193264 debian-policy_4.7.3.0.git.tar.xz
 5547246a677d843f1fcb30f3460dafb73426e20e0f5dbc7f8f0b507eccc52f09 17159 debian-policy_4.7.3.0_source.buildinfo
Files:
 71a11bd21e49d74969689eb3927e3e32 2363 doc optional debian-policy_4.7.3.0.dsc
 001ab90ed46de7b9d50b4eb536324b22 577360 doc optional debian-policy_4.7.3.0.tar.xz
 4c19eeda897f19cfd73b8b9a9ab1a85e 1193264 doc None debian-policy_4.7.3.0.git.tar.xz
 7215a823b916606419dbcf61add20e4b 17159 doc optional debian-policy_4.7.3.0_source.buildinfo
Git-Tag-Info: tag=738e46b1058f4cc78a6f22d592cd165d17d8b2dc fp=9b917007ae030e36e4fc248b695b7ae4bf066240
Git-Tag-Tagger: Sean Whitton <spwhitton@spwhitton.name>

-----BEGIN PGP SIGNATURE-----

iQIzBAEBCgAdFiEEN02M5NuW6cvUwJcqYG0ITkaDwHkFAmlKl44ACgkQYG0ITkaD
wHlqsxAAnu401Ekuc6cK8XWWTC23nwlz31CLCb5Z9wGKgJjlYgvzpjvmLcXBXfuL
TnxGhDd9K0OuSjLAo64ar8eRGjUHic0LG1vNKP531Rt/tAKsQJb1DY7EP0Jgspiw
xPHTvi//eSqdu0Uw1nxs5jZT1feHW4i/HMmtCPVx4ROg+ElkwYXYBW3Ng2500VXR
Pg5/FimhjohUJFDvqV07ef9vWLIhlswY8DRYIh4Yr6HLJa0xOiyDG6eyKF0nZ3G/
nEaDI2RcLrXxeb7L+24Kyjp/BidNEVSEFKaj1g1toaAR/ovN+/thljFTF9lqJxEe
Iv4rv7afW9PXDmH0L0tkqlFoQsDTJ784KF118acTU4KdDraDturWSEnOrgXcL5o6
AIXqUFeV6P6MMelVAA1sfkG1/uZqzTpWh7FMgwi2FBSNF1s9QxGgq4HV0q7F+/5z
IyYKom1a1iP8duihb30yv/QL9rv3rufDjklWUkcETe5lkzDoJb3wcyrI9YTz9PVx
S47xn9p30MyqkM8DMpv9xiQQIuEl+RUpuWoBLLNjEeoCJ92OmR7l7ksrRk/iWD3t
eHY1Q1vHPcDW0W+A5UtgUrJrrEwB+5TVRqOk6lQPUp4imgNGqkLyoxeggvYoozYR
RQMNNOzEyEbRi7hFDLVtOywAdvj61nWBMTfoT3Y5MoTrhuL7Dyo=
=KsEn
-----END PGP SIGNATURE-----

Attachment: pgp8PRU7gf2B2.pgp
Description: PGP signature


--- End Message ---
Reply to: