Merge pull request #187 from epics-containers/ggayDiamond-patch-1

Update configuration.md with VSCode locale settings

Author: gilesknap

docs/reference/configuration.md

@@ -52,5 +52,24 @@ For a much richer command line experience, it is recommended to use the zsh shel
     "terminal.integrated.defaultProfile.linux": "zsh",
 ```
 
+### Turn off locale detection
+
+If your host system locale settings differ from the dev container image settings, you may receive locale-related warning messages when using the integrated terminal in a dev container; e.g. during a module build:
+```
+perl: warning: Setting locale failed.
+perl: warning: Please check that your locale settings:
+        LANGUAGE = (unset),
+        LC_ALL = (unset),
+        LC_CTYPE = "C.UTF-8",
+        LANG = "en_US.UTF-8"
+    are supported and installed on your system.
+perl: warning: Falling back to the standard locale ("C").
+```
+You can either generate and add the required locale settings to your system (with sudo permissions),
+or simply turn off the locale detection in VSCode's settings to avoid having LANG set in the integrated terminal
+```
+Settings > Remote Dev_Container > Terminal > Integrated:Detect_Locale Off
+```
+
 | | |
-|---|---|
+|---|---|