Package: debian-policy X-debbugs-cc: ijack...@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 <spwhit...@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
signature.asc
Description: PGP signature
