README.source: New file

1 files changed, 14 insertions, 0 deletions

diff --git a/README.source b/README.source
new file mode 100644
index 0000000..b4789ce
--- /dev/null
+++ b/README.source
@@ -0,0 +1,14 @@
+"Failed to set default locale"
+==============================
+
+This warning is thrown by bsdtar and bsdcpio when neither `LC_ALL` nor `LANG`
+are set, because these utilities call `setlocale()` with `""` as the second
+argument:
+
+    #if HAVE_SETLOCALE
+            if (setlocale(LC_ALL, "") == NULL)
+                    lafe_warnc(0, "Failed to set default locale");
+    #endif
+
+This causes libarchive's `test_read_disk` and `test_write_disk_lookup` tests to
+fail, so the `build` makefile runs oh-autotest with `LC_ALL=C`.