Your message dated Thu, 20 Feb 2025 20:10:10 +0000
with message-id <e1tlcs6-00gm1i...@fasolo.debian.org>
and subject line Bug#1089110: fixed in debian-policy 4.7.1.0
has caused the Debian Bug report #1089110,
regarding [PATCH] Document that packages cannot require man / info / locale
files
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 ow...@bugs.debian.org
immediately.)
--
1089110: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1089110
Debian Bug Tracking System
Contact ow...@bugs.debian.org with problems
--- Begin Message ---
Package: debian-policy
Version: 4.7.0.1
Severity: wishlist
Tags: patch
X-Debbugs-Cc: j...@joshtriplett.org
Packages already tend to avoid requiring any files from /usr/share/man
or /usr/share/info, and don't require files in /usr/share/locale if
running in a C or C.UTF-8 locale.
The attached patch documents this in Policy, so that it's explicitly
supported for sysadmins to use dpkg exclusions or similar mechanisms to
delete /usr/share/doc, /usr/share/info, and /usr/share/locale.
To the best of my knowledge, this documents existing behavior, and will
not introduce any new bugs on any packages.
>From c0069a143c349375201273f3d25b676f501e85e2 Mon Sep 17 00:00:00 2001
Message-ID:
<c0069a143c349375201273f3d25b676f501e85e2.1733421983.git.j...@joshtriplett.org>
From: Josh Triplett <j...@joshtriplett.org>
Date: Thu, 5 Dec 2024 10:01:33 -0800
Subject: [PATCH] Document that packages cannot require man / info / locale
files
Packages already tend to avoid requiring any files from /usr/share/man
or /usr/share/info, and don't require files in /usr/share/locale if
running in a C or C.UTF-8 locale.
Document this in Policy, so that it's explicitly supported for sysadmins
to use dpkg exclusions or similar mechanisms to delete /usr/share/doc,
/usr/share/info, and /usr/share/locale.
Signed-off-by: Josh Triplett <j...@joshtriplett.org>
---
policy/ch-docs.rst | 8 ++++++++
policy/ch-files.rst | 12 ++++++++++++
2 files changed, 20 insertions(+)
diff --git a/policy/ch-docs.rst b/policy/ch-docs.rst
index f3db835..6167342 100644
--- a/policy/ch-docs.rst
+++ b/policy/ch-docs.rst
@@ -61,6 +61,11 @@ by a note at the beginning of the manual page or by showing
the missing
or changed portions in the original language instead of the target
language.
+Packages (other than manual page readers) must not require the existence
+of any files in ``/usr/share/man/`` in order to function. A package that
+optionally displays its own manual pages, such as to provide user help,
+must fail gracefully if the manual pages aren't installed.
+
.. _s12.2:
Info documents
@@ -100,6 +105,9 @@ To determine which section to use, you should look at
create a new section if none of the current sections are relevant).
[#]_
+Packages (other than info readers) must not require the existence of any
+files in ``/usr/share/info/`` in order to function.
+
.. _s-docs-additional:
Additional documentation
diff --git a/policy/ch-files.rst b/policy/ch-files.rst
index b34c183..90ddee1 100644
--- a/policy/ch-files.rst
+++ b/policy/ch-files.rst
@@ -574,6 +574,18 @@ is only removed). This should be done by the ``postrm``
script when it
is called with the argument ``purge`` (see
:ref:`s-removedetails`).
+.. _s-locale-files:
+
+Locale files
+------------
+
+The directory ``/usr/share/locale/`` contains localization files for
+different locales.
+
+Packages must not require the existence of any files in
+``/usr/share/locale/`` in order to function in a ``C`` or ``C.UTF-8``
+locale.
+
.. _s-permissions-owners:
Permissions and owners
--
2.45.2
--- End Message ---
--- Begin Message ---
Source: debian-policy
Source-Version: 4.7.1.0
Done: Sean Whitton <spwhit...@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 1089...@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Sean Whitton <spwhit...@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 ftpmas...@ftp-master.debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512
Format: 1.8
Date: Thu, 20 Feb 2025 17:44:53 +0800
Binary: debian-policy debian-policy-ja debian-policy-zh-cn
Source: debian-policy
Architecture: all source
Version: 4.7.1.0
Distribution: unstable
Urgency: medium
Maintainer: Debian Policy Editors <debian-policy@lists.debian.org>
Changed-By: Sean Whitton <spwhit...@spwhitton.name>
Closes: 1074014 1075856 1089110 1091913 1094664 1098339
Description:
debian-policy - Debian Policy Manual and related documents
debian-policy-ja - Debian Policy Manual and related documents (Japanese)
debian-policy-zh-cn - Debian Policy Manual and related documents (Simplified
Chinese)
Changes:
debian-policy (4.7.1.0) unstable; urgency=medium
.
[ Fei Ding & Ke Zhang ]
* New Simplified Chinese translation.
.
[ Sean Whitton ]
* Install new translation in new binary package.
* Merge two duplicate sets of .po files, locales/ & policy/locale/.
* Policy: Clarify filename conflicts for programs
Wording: Chris Hofstaedtler <z...@debian.org>
Seconded: Helmut Grohne <hel...@subdivi.de>
Seconded: Jochen Sprickerhof <jspri...@debian.org>
Seconded: Holger Levsen <hol...@layer-acht.org>
Closes: #1075856
* 5.6.31: Update default value of Rules-Requires-Root (Closes: #1091913).
Thanks to Niels Thykier for the report.
* Policy: Packages must/should not require man, info and locale files
Wording: Josh Triplett <j...@joshtriplett.org>
Seconded: Sean Whitton <spwhit...@spwhitton.name>
Seconded: Mattia Rizzolo <mat...@debian.org>
Closes: #1089110
* Policy: Packages must not install to /bin, /lib, /lib* or /sbin
Wording: Helmut Grohne <hel...@subdivi.de>
Seconded: Russ Allbery <r...@debian.org>
Seconded: Sam Hartman <hartm...@debian.org>
Seconded: Luca Boccassi <bl...@debian.org>
Seconded: Chris Hofstaedtler <z...@debian.org>
Seconded: Holger Levsen <hol...@layer-acht.org>
Seconded: Michael Biebl <bi...@debian.org>
Seconded: Jochen Sprickerhof <jspri...@debian.org>
Closes: #1074014
- Rewrite Helmut's text to avoid mentioning the merged-/usr transition
by name, and to avoid the transition-specific "aliased paths" jargon.
My hope is that this will be better for future readers.
* 10.1: Delete paragraph about compatibility symlinks /path -> /usr/path.
This paragraph is effectively superseded by the preceding Policy change.
* Fix formatting issue in 10.2 (Closes: #1094664).
Thanks to Roberto C. Sanchez for the report.
* Fix typo in 2.2.2 (Closes: #1098339).
Thanks to Ahmed Siam for the report.
Checksums-Sha1:
f7989401ee409df829dd0638b17191a21544aaf8 2204 debian-policy_4.7.1.0.dsc
7d697ab6f4e3007e8a7181ad94ca18d29052750a 575360 debian-policy_4.7.1.0.tar.xz
5c3b55b56dd23072ecffd4f5f4f24c3cd348cdf5 443660
debian-policy-ja_4.7.1.0_all.deb
e5aa420b2848708d06709c8a2ad456dc312b3299 436664
debian-policy-zh-cn_4.7.1.0_all.deb
09a16e26f379f7b0c72eb33978794826176f0c26 2408020 debian-policy_4.7.1.0_all.deb
6f70c081c30643274fcd7f820e30c09811f4848e 15398
debian-policy_4.7.1.0_amd64.buildinfo
Checksums-Sha256:
8598c5a0bbe60502587fe28d2b408279c4e719de905d75d8de01007aac34988e 2204
debian-policy_4.7.1.0.dsc
1ea69d75fd4d57136ecc49981ec092aee2a127ab966be7886978e9b3b22f693d 575360
debian-policy_4.7.1.0.tar.xz
ea56033162aed9679e1da29f21aaaa06b2b7fd5015ac19ad5fa54e7ddd8cfbc7 443660
debian-policy-ja_4.7.1.0_all.deb
dc35a78fd82ea067815f236471b571eb43ae9568ff3844394bab1540fd897c6b 436664
debian-policy-zh-cn_4.7.1.0_all.deb
d8a4d2cac2c9764d113816151568fac1b3b77151c3588b12adf6cab7ef0ed0bb 2408020
debian-policy_4.7.1.0_all.deb
fb2cd827fb473b7382487c4b9a9f77a9d3a4ced7f50dea639380b59dad3710e0 15398
debian-policy_4.7.1.0_amd64.buildinfo
Files:
9df1607d9f780b6ff37b3bad153e6180 2204 doc optional debian-policy_4.7.1.0.dsc
016c8fef7e324c94d61c17bcc204d6cb 575360 doc optional
debian-policy_4.7.1.0.tar.xz
c1e755a95b0480dee01158bd9a22b0ac 443660 doc optional
debian-policy-ja_4.7.1.0_all.deb
aad9e400f72016ffb3e3c763b2ad766c 436664 doc optional
debian-policy-zh-cn_4.7.1.0_all.deb
f88f37b604da99d4071320bf9b8b2843 2408020 doc optional
debian-policy_4.7.1.0_all.deb
15ab3c9479c265bb5d9935e78d841b01 15398 doc optional
debian-policy_4.7.1.0_amd64.buildinfo
-----BEGIN PGP SIGNATURE-----
iQIzBAEBCgAdFiEEm5FwB64DDjbk/CSLaVt65L8GYkAFAme2+ugACgkQaVt65L8G
YkAp9A/+Pw0CZDCEMSJuccw7MYvTGR4gflB5Xt1Srpf+ksYUOBeQpcoVkYtq3oSQ
2wupwf3tUQSkuz6BvlEEjNDsoz5aFev25MRUIzZ+4PFdzNXcuR3JDvhDumPekPWq
Z2qW2sAyUnLj5hYguFc5WQJX5BgDGZlO3ycHOFCCX7A2CM9h4kn8zfVhaXGFriqq
myYcxr6CyNBHeFbQs6wvG72GfhxEU13CFRlnCaXCrO2QNj4oP8tyr2t+Do2oYCVR
ZuDVEawTFRY2VKL5CWiGmwFln7T0lG+P0bXAEXXus9o3ewlDnTtlLiflxxnp1xkO
c9GGGIVEZ9gDQffdizOvJPcLJrSroGeYfZShsxHsqpAOrXBkrM0XP1COrpXwp5S5
UqXrUwihEEmPidf0irq2Di2RCvgGxdkHRpys8VSxfHAU8uoflJ4UOE3rbfLxjzjp
gWm//ccAhpl3PBI+Udk+8wxyDU7SRcbsQf09pIBkhHbMVKSbES+u1pVAoo33K0Cu
98cyhE7q7DgXsHxClOD3ClDVNx/M8fEejuSSEq7t1CF6Ggr2vALqMMvfCcJTalwO
wMN0/6lk+TvS4Opy2waIR2KXVURSfxlRcperPrZwmFwS9DVHVTEGobWW1TROnZ1d
80B25KW8Iz3DYFwAffZPKuire5lQMFkSBc3IHgCBfxXSlfyvAB0=
=FmXY
-----END PGP SIGNATURE-----
pgprLDEYahclM.pgp
Description: PGP signature
--- End Message ---
