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

Bug#208011: marked as done (Mandate UTF-8 for control files)

Your message dated Thu, 12 Mar 2009 04:47:02 +0000
with message-id <E1Lhcow-0006in-QN@ries.debian.org>
and subject line Bug#143941: fixed in debian-policy 3.8.1.0
has caused the Debian Bug report #143941,
regarding Mandate UTF-8 for control 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 owner@bugs.debian.org
immediately.)


-- 
143941: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=143941
Debian Bug Tracking System
Contact owner@bugs.debian.org with problems
--- Begin Message --- 
Package: debian-policy
Version: 3.6.1.0
Severity: wishlist
Tags: patch

This proposal aims to use UTF-8 encoding not only for debian/changelog,
but also for debian/control. Patch attached, as well as plain text for
better reading.

Kind regards,

Martin

--- debian-policy-3.6.1.0.orig/policy.sgml	Tue Aug 19 14:32:23 2003
+++ debian-policy-3.6.1.0/policy.sgml	Sun Aug 31 13:30:14 2003
@@ -2250,6 +2250,12 @@
 	  See <ref id="substvars"> for details.
 	</p>
 
+	<p>
+	  It is recommended that the control fields be encoded in 
+	  UTF-8 encoding, see <ref id="pkg-dpkgchangelog"> for
+	  further information on this.
+	</p>
+
       </sect>
 
       <sect id="binarycontrolfiles">

5.2. Source package control files -- `debian/control'
-----------------------------------------------------

     The `debian/control' file contains the most vital (and
     version-independent) information about the source package and about
     the binary packages it creates.

     The first paragraph of the control file contains information about the
     source package in general.  The subsequent sets each describe a binary
     package that the source tree builds.

     The fields in the general paragraph (the first one, for the source
     package) are:
        * `Source' (mandatory)
        * `Maintainer' (mandatory)
        * `Section' (recommended)
        * `Priority' (recommended)
        * `Build-Depends' et al
        * `Standards-Version' (recommended)

     The fields in the binary package paragraphs are:
        * `Package' (mandatory)
        * `Architecture' (mandatory)
        * `Section' (recommended)
        * `Priority' (recommended)
        * `Essential'
        * `Depends' et al
        * `Description' (mandatory)

     The syntax and semantics of the fields are described below.

     These fields are used by `dpkg-gencontrol' to generate control files
     for binary packages (see below), by `dpkg-genchanges' to generate the
     `.changes' file to accompany the upload, and by `dpkg-source' when it
     creates the `.dsc' source control file as part of a source archive.

     The fields here may contain variable references - their values will be
     substituted by `dpkg-gencontrol', `dpkg-genchanges' or `dpkg-source'
     when they generate output control files.  See Section 4.9, `Variable
     substitutions: `debian/substvars'' for details.

     It is recommended that the control fields be encoded in UTF-8
     encoding, see Section C.2.2, ``debian/changelog'' for further
     information on this.


C.2.2. `debian/changelog'
-------------------------

     See Section 4.4, `Debian changelog: `debian/changelog''.

     It is recommended that the entire changelog be encoded in the UTF-8
     (http://www.cis.ohio-state.edu/cgi-bin/rfc/rfc2279.html) encoding of
     Unicode (http://www.unicode.org/).[1]

[1]  Support for Unicode, and specifically UTF-8, is steadily increasing
     among popular applications in Debian.  For example, in unstable, GNOME
     2 has excellent support (almost level 2) in almost all its
     applications; the big remaining one is gnome-terminal, of which one
     requires development versions in order to support UTF-8 (available in
     Debian experimental now if you want to play).  I think that by the
     time sarge is released, UTF-8 support will start to hit critical mass.

     I think it is fairly obvious that we need to eventually transition to
     UTF-8 for our package infrastructure; it is really the only sane
     charset in an international environment.  Now, we can't switch to
     using UTF-8 for package control fields and the like until dpkg has
     better support, but one thing we can start doing today is requesting
     that Debian changelogs are UTF-8 encoded.  At some point in time, we
     can start requiring them to do so.

     Checking for non-UTF8 characters in a changelog is trivial.  Dump the
     file through

          iconv -f utf-8 -t ucs-4

     discard the output, and check the return value.  If there are any
     characters in the stream which are invalid UTF-8 sequences, iconv will
     exit with an error code; and this will be the case for the vast
     majority of other character sets.

Attachment: pgpjyTeonzCVa.pgp
Description: PGP signature


--- End Message ---
--- Begin Message --- 
Source: debian-policy
Source-Version: 3.8.1.0

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:

debian-policy_3.8.1.0.dsc
  to pool/main/d/debian-policy/debian-policy_3.8.1.0.dsc
debian-policy_3.8.1.0.tar.gz
  to pool/main/d/debian-policy/debian-policy_3.8.1.0.tar.gz
debian-policy_3.8.1.0_all.deb
  to pool/main/d/debian-policy/debian-policy_3.8.1.0_all.deb



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 143941@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Russ Allbery <rra@debian.org> (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@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.8
Date: Wed, 11 Mar 2009 20:50:52 -0700
Source: debian-policy
Binary: debian-policy
Architecture: source all
Version: 3.8.1.0
Distribution: unstable
Urgency: low
Maintainer: Debian Policy List <debian-policy@lists.debian.org>
Changed-By: Russ Allbery <rra@debian.org>
Description: 
 debian-policy - Debian Policy Manual and related documents
Closes: 143941 163666 241333 416450 426877 446712 470994 473019 473439 479080 483418 487701 488039 489460 491985 492624 503685 511804 513955 514326
Changes: 
 debian-policy (3.8.1.0) unstable; urgency=low
 .
   * Policy: Clarify what "sensible behavior" is for init scripts
     Wording: Steve Langasek <vorlon@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Closes: #426877
   * Policy: Remove alternative changelog formats from main manual
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Ben Pfaff <blp@cs.stanford.edu>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #489460
   * Policy: Mandate UTF-8 for changelog files
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Seconded: Kurt Roeckx <kurt@roeckx.be>
     Closes: #241333
   * Policy: Mandate UTF-8 for control files
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Kurt Roeckx <kurt@roeckx.be>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #143941
   * Policy: New option in DEB_BUILD_OPTIONS to avoid running test-suites
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #416450
   * Policy: Expand expected capabilities for local in /bin/sh scripts
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Guillem Jover <guillem@debian.org>
     Seconded: Raphaël Hertzog <hertzog@debian.org>
     Closes: #473019
   * Policy: Clarify Essential definition and caution when adding to it
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Jörg Sommer <joerg@alea.gnuu.de>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #479080
   * Policy: Allow user mail spools to be mode 0600 or 0660
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Kurt Roeckx <kurt@roeckx.be>
     Seconded: Andrew McMillan <awm@debian.org>
     Closes: #470994
   * Policy: Remove special handling of init scripts ending in .sh
     Wording: Kel Modderman <kel@otaku42.de>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Henrique de Moraes Holschuh <hmh@debian.org>
     Closes: #513955
   * Policy: /var/run and /var/lock may be volatile
     Wording: Colin Watson <cjwatson@debian.org>
     Seconded: Russ Allbery <rra@debian.org>
     Seconded: Bill Allombert <Bill.Allombert@math.u-bordeaux1.fr>
     Closes: #514326
   * Policy: debian/control allows comments starting with #
     Wording: Russ Allbery <rra@debian.org>
     Seconded: Julien Cristau <jcristau@debian.org>
     Seconded: Adeodato Simó <dato@net.com.org.es>
     Seconded: Guillem Jover <guillem@debian.org>
     Closes: #446712
   * Improve the documentation of maintainer script actions for diversions
     in the informative appendix to allow for addition of a new diversion
     on upgrade and handle error cases correctly.  Thanks to Olivier Berger
     for the report and Raphaël Hertzog for the review.  (Closes: #483418)
   * Clarify the meaning of architecture restrictions on build dependencies
     in the presence of alternatives.  Thanks to Guillem Jover for the
     explanation and review and Emilio Pozuelo Monfort and Don Armstrong
     for wording review.  (Closes: #163666)
   * Change the term "category" to "archive area" when referring to main,
     contrib, and non-free.  This is closer to the wording of the Social
     Contract.  (Closes: #473439)
   * Use <user>:<group> notation rather than <user>.<group> notation in
     multiple places.  Thanks, Kurt Roeckx.  (Closes: #488039)
   * Fix typo in 3.8.0.0 upgrading-checklist entry.  Patch from Kobayashi
     Noritada.  (Closes: #487701)
   * Mention debugging packages as an explicit example of packages with
     extra priority.  Thanks, Charles Plessy.  (Closes: #491985)
   * Clarify that translation is only required for user-visible debconf
     messages.  Capitalize "Debian Configuration Management Specification"
     uniformly.  Thanks, Julian Andres Klode.  (Closes: #492624)
   * Add --wildcards to the sample tar command in appendix B.1 for
     extracting the package copyright file, adjusting for new tar option
     behavior.  Thanks, Yan Morin.  (Closes: #503685)
   * Reword the requirement that maintainer scripts exit with a zero
     status on success to avoid double-negatives.
   * Include the full name of each menu category rather than only the
     portion relative to the parent heading to be clearer in long category
     lists.  Thanks, Christoph Berg.  (Closes: #511804)
   * Build-Depend on texlive rather than tetex-extra.  texlive appears to
     be sufficient for how Policy uses debiandoc-sgml and pulls in far
     fewer packages.
   * Remove the postinst and prerm scripts.  doc-base registration is now
     handled by triggers and no longer required and removal of /usr/doc
     links was completed long ago.
   * Reference GPL-2 rather than the GPL symlink in debian/copyright.
Checksums-Sha1: 
 028523613316f116df03d2b1499558ee87623752 1099 debian-policy_3.8.1.0.dsc
 a770f0706e0024419f615a7a3f0bad952204c553 642159 debian-policy_3.8.1.0.tar.gz
 e642a568cb83485d06b0db322492e693745bb6ee 1600318 debian-policy_3.8.1.0_all.deb
Checksums-Sha256: 
 05f5301cc49576d720bb86dbc6a0b5a0c3d987672d4784ba6233f50b6381bc6c 1099 debian-policy_3.8.1.0.dsc
 e870fddebf1f5d117165d495274e862262b0bc5044af03cbf6efadde4d1987c4 642159 debian-policy_3.8.1.0.tar.gz
 aabed48106680ea0412d4745cabfe549f1f66a66b401c3fa0377c57625e56d39 1600318 debian-policy_3.8.1.0_all.deb
Files: 
 aedf88a7b4300ad291f58322db840b45 1099 doc optional debian-policy_3.8.1.0.dsc
 2d8e596c21f7b15a78ceeb985a36ed41 642159 doc optional debian-policy_3.8.1.0.tar.gz
 cb433141e17276e5ba252b81303d99ab 1600318 doc optional debian-policy_3.8.1.0_all.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEARECAAYFAkm4hvcACgkQ+YXjQAr8dHZfigCeOjTIesMnR7YH/zapV1XcNfWX
7OgAnREkqxjFZC932xKiKI8SgVN9rwoN
=8ruN
-----END PGP SIGNATURE-----

--- End Message ---
Reply to: