Bug#1131015: mention Files-Excluded/Included-* in copyright-format-1.0.xml

Simon Josefsson <[email protected]> Mon, 16 Mar 2026 23:51:33 +0100

Newsgroups	gmane.linux.debian.devel.policy
Message-ID	<87jyvbv156.fsf__18809.3576392689$1773701619$gmane$org@josefsson.org>

Package: debian-policy
Version: 4.7.3.0
Severity: wishlist

Hi!  The copyright specification

https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/

do not mention Files-Excluded/Included which are supported for a long
time by uscan and other tools.

What do you think about the attached patch to fix this?

/Simon

0001-Mention-Files-Excluded-Included-in-copyright-format.patch (text/x-diff, 1.7 KB)

From 8c3605b91938ed78f554569696581a4935ae4e4f Mon Sep 17 00:00:00 2001
From: Simon Josefsson <[email protected]>
Date: Mon, 16 Mar 2026 11:01:42 +0100
Subject: [PATCH] Mention Files-Excluded/Included in copyright-format

---
 copyright-format-1.0.xml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/copyright-format-1.0.xml b/copyright-format-1.0.xml
index 954a65b..8e1345b 100644
--- a/copyright-format-1.0.xml
+++ b/copyright-format-1.0.xml
@@ -246,6 +246,11 @@
             <link linkend="copyright-field">Copyright</link>: optional.
           </para>
         </listitem>
+        <listitem>
+          <para>
+            <link linkend="files-excluded-included-field">Files-Excluded, Files-Excluded-*, Files-Included, Files-Included-*</link>: optional.
+          </para>
+        </listitem>
       </itemizedlist>
       <para>
         The <varname>Copyright</varname> and <varname>License</varname>
@@ -498,6 +503,18 @@ License: MPL-1.1
       </para>
     </section>
 
+    <section id="files-excluded-included-field">
+      <title><varname>Files-Excluded, Files-Excluded-*, Files-Included, Files-Included-*</varname></title>
+      <para>
+        Formatted text, no synopsis: these fields are used by <ulink
+        url="https://manpages.debian.org/testing/devscripts/uscan.1.en.html#COPYRIGHT_FILE_EXAMPLES">uscan</ulink>
+        and <ulink
+        url="https://manpages.debian.org/testing/devscripts/mk-origtargz.1.en.html">mk-origtargz</ulink>
+        to automatically repack an upstream tarball, see the
+        documentation for details.
+      </para>
+    </section>
+
     <section id="license-field">
       <title><varname>License</varname></title>
       <para>
-- 
2.52.0

signature.asc (application/pgp-signature, 1.2 KB)