From 4eb94fbedd0ad67102bd24c7660212723f4be88a Mon Sep 17 00:00:00 2001
From: Bruno Haible <bruno@clisp.org>
Date: Sun, 1 Sep 2019 19:34:05 +0200
Subject: build: Explain how to avoid skipped tests.

* HACKING: Explain which locales to install, to avoid skipped tests.
---
 HACKING | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

(limited to 'HACKING')

diff --git a/HACKING b/HACKING
index 1db20b6..3c58cd2 100644
--- a/HACKING
+++ b/HACKING
@@ -49,6 +49,20 @@ You will need reasonably recent versions of the build tools:
 And, of course, the packages listed in the DEPENDENCIES file.
 
 
+Additional requirements for maintainers
+---------------------------------------
+
+If you are a maintainer, you will want to minimize the number of tests that
+are skipped. To this effect, you need to install a couple of locales, used by
+the tests. By default, only those enabled in /etc/locale.gen are preinstalled.
+
+$ sudo localedef -i ar_SA -f ISO-8859-6 ar_SA.ISO-8859-6
+$ sudo localedef -i fr_FR -f ISO-8859-1 fr_FR.ISO-8859-1
+$ sudo localedef -i fr_FR -f UTF-8 fr_FR.UTF-8
+$ sudo localedef -i ja_JP -f EUC-JP ja_JP.EUC-JP
+$ sudo localedef -i zh_CN -f GB18030 zh_CN.GB18030
+
+
 Building off the Git repository
 ===============================
 
-- 
cgit v1.2.1