[Git][haskell-team/package-plan][sten] 2 commits: Document that a locale must be configured for test-packages.pl to not fail.

[Nicholas D Steeves (@sten)]

Nicholas D Steeves pushed to branch sten at Debian Haskell Group / package-plan


Commits:
e3d8a97c by Nicholas D Steeves at 2026-04-22T12:35:50-04:00
Document that a locale must be configured for test-packages.pl to not fail.

- - - - -
b1240da8 by Nicholas D Steeves at 2026-04-24T17:48:18-04:00
fix various quoting typos

- - - - -


1 changed file:

- README.md


Changes:

=====================================
README.md
=====================================
@@ -68,7 +68,7 @@ In addition to `packages.txt`, the follwing files are taken into account:
    This can be used for packages not on hackage, or when the cabal-file editing
    feature on hackage has been used. In that case, the unmodified cabal file
    ought to be added here.
- * `patches/<pkg>/<version>/
+ * `patches/<pkg>/<version>/`
    A directory of patches, in the same format as `debian/patches` (so that the
    files can be taken unmodified from there). The patches are applied to the
    Cabal files of the “internal“ repository.
@@ -93,6 +93,12 @@ The script has a few dependencies, so run
       libsdl2-ttf-dev libzmq3-dev ca-certificates libyaml-dev \
       libgraphene-1.0-dev libgtk-4-dev libpq-dev
 
+Please note that `test-packages.pl` will fail when a UTF-8 locale has not been
+configured; This means it will fail in most schroots, by default, and in some
+containers. When the LANG and/or LC_ALL environment variable does not contain
+"UTF-8", this indicates that UTF-8 has probably not been configured.  It is then
+necessary to `sudo dpkg-reconfigure locales`.
+
 To test the package plan, run
 
     cabal update
@@ -101,7 +107,7 @@ To test the package plan, run
 this tool will
 
  * read `packages.txt`.
- * read the hackage index from `~/.cabal/packages/hackage.haskell.org/00-index.tar"
+ * read the hackage index from `~/.cabal/packages/hackage.haskell.org/00-index.tar`
    (hence the need to run `cabal update`).
  * read the LTS version ranges from `lts.config`.
  * read the Debian package index using `grep-aptavail`.
@@ -144,6 +150,9 @@ The following Dockerfile may help test in a reproducible environment
      libxml2-dev libpcre2-dev libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev \
      libsdl2-ttf-dev libzmq3-dev ca-certificates libyaml-dev libpq-dev
 
+Please note that `test-packages.pl` will fail when a UTF-8 locale has
+not been configured.
+
     # Replace the following with
     # git clone <URI> -b <BRANCH_NAME>
     # to test a specific branch.
@@ -182,6 +191,7 @@ Following packages are required for compilation:
  * ghc (obliviously)
  * libghc-attoparsec-dev
  * libghc-process-extras-dev
+ * a configured locale
 
 This program finds packages with newer minor versions. These are likely
 non-disruptive to upgrade, so if you have a few moments to spare, you can work



View it on GitLab: https://salsa.debian.org/haskell-team/package-plan/-/compare/74e320ac5406932505a36776970c6decadb665aa...b1240da83dee39978112291e1e5ceffcf3c24e9a

-- 
View it on GitLab: https://salsa.debian.org/haskell-team/package-plan/-/compare/74e320ac5406932505a36776970c6decadb665aa...b1240da83dee39978112291e1e5ceffcf3c24e9a
You're receiving this email because of your account on salsa.debian.org. Manage all notifications: https://salsa.debian.org/-/profile/notifications | Help: https://salsa.debian.org/help


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://alioth-lists.debian.net/pipermail/pkg-haskell-commits/attachments/20260428/be61d71f/attachment-0001.htm>