[Git][haskell-team/package-plan][sten] 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:
bd6669ec 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.

- - - - -


1 changed file:

- README.md


Changes:

=====================================
README.md
=====================================
@@ -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 LANG and LC_ALL are
+not set and/or when their supporting locales are not installed; This
+means it will fail in most schroots, by default, and in some containers.
+When a locale has not been configured, `sudo dpkg-reconfigure locales`
+must be executed.
+
 To test the package plan, run
 
     cabal update
@@ -144,6 +150,10 @@ 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 LANG and LC_ALL are
+not set and/or when their supporting locales are not installed.  Take
+care to install and configure a locale.
+
     # Replace the following with
     # git clone <URI> -b <BRANCH_NAME>
     # to test a specific branch.
@@ -182,6 +192,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
@@ -197,7 +208,6 @@ required. Add patches as required. Repeat.
 
 Only when the plan is sound, start uploading.
 
-
 How do I... conveniently edit the patches
 -----------------------------------------
 



View it on GitLab: https://salsa.debian.org/haskell-team/package-plan/-/commit/bd6669ec02c162dc98a4768591ae4d33c1def2fb

-- 
View it on GitLab: https://salsa.debian.org/haskell-team/package-plan/-/commit/bd6669ec02c162dc98a4768591ae4d33c1def2fb
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/20260423/40dbccbb/attachment-0001.htm>