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

Sean Whitton <[email protected]> Sun, 31 May 2026 12:30:31 +0100
Newsgroups gmane.linux.debian.devel.policy
Message-ID <878q8zx1d4.fsf__21791.7584859364$1780227568$gmane$org@melete.silentflame.com>
Simon Josefsson [29/May  8:49am +02] wrote:
> diff --git a/copyright-format-1.0.xml b/copyright-format-1.0.xml
> index 954a65b..a5a7aa0 100644
> --- a/copyright-format-1.0.xml
> +++ b/copyright-format-1.0.xml
> @@ -246,6 +246,11 @@
>              <link linkend=3D"copyright-field">Copyright</link>: optional.
>            </para>
>          </listitem>
> +        <listitem>
> +          <para>
> +            <link linkend=3D"files-excluded-included-field">Files-Exclud=
ed, Files-Excluded-*, Files-Included, Files-Included-*</link>: optional.
> +          </para>
> +        </listitem>
>        </itemizedlist>
>        <para>
>          The <varname>Copyright</varname> and <varname>License</varname>
> @@ -498,6 +503,27 @@ License: MPL-1.1
>        </para>
>      </section>
>
> +    <section id=3D"files-excluded-included-field">
> +      <title><varname>Files-Excluded, Files-Excluded-*, Files-Included, =
Files-Included-*</varname></title>
> +      <para>
> +        <link linkend=3D"white-space-lists">
> +	  Whitespace=E2=80=91separated filename patterns</link>, as in the
> +	  <link linkend=3D"files-field">Files</link> field (including
> +	  wildcards and directory names), used to indicate which parts
> +	  of the upstream source specified in the Source field will
> +	  not be included in the Debian source package. Files=E2=80=91Excluded
> +	  lists patterns for files or directories to
> +	  omit. Files=E2=80=91Included lists patterns for files that should
> +	  not be omitted even if they match a Files=E2=80=91Excluded rule. For
> +	  multi=E2=80=91orig.tar sources, Files=E2=80=91Excluded=E2=80=91COMPON=
ENT and
> +	  Files=E2=80=91Included=E2=80=91COMPONENT apply the same logic but onl=
y to
> +	  the specified orig.tar component. These fields may also be
> +	  used by maintainer tools to perform the exclusions, but such
> +	  tools should not require the machine-readable
> +	  debian/copyright file format for correct operation.
> +      </para>
> +    </section>
> +
>      <section id=3D"license-field">
>        <title><varname>License</varname></title>
>        <para>

Seconded, thanks.

--=20
Sean Whitton