config-faqs: Document how to make unicode characters in paths work
Signed-off-by: Edwin Kempin <ekempin@google.com>
Change-Id: Ia299bb3d3bb642b215a909a5fa11f86a5e022939
diff --git a/resources/Documentation/config-faqs.md b/resources/Documentation/config-faqs.md
index c87333b..8e0ba49 100644
--- a/resources/Documentation/config-faqs.md
+++ b/resources/Documentation/config-faqs.md
@@ -7,6 +7,7 @@
* [How to setup code owner overrides](#setupOverrides)
* [What's the best place to keep the global plugin
configuration](#globalPluginConfiguration)
+* [How to make unicode characters in file paths work?](#unicodeCharsInFilePaths)
## <a id="updateCodeOwnersConfig">How to update the code-owners.config file for a project
@@ -153,6 +154,20 @@
domains](config.html#pluginCodeOwnersAllowedEmailDomain)) that cannot be set on
project level and hence must be set in `gerrit.config`.
+## <a id="unicodeCharsInFilePaths">How to make unicode characters in file paths work?
+
+The @PLUGIN@ plugin uses the Java NIO API which reads the default character
+encoding from the system language settings. On Unix this means the `LANG` and
+`LC_CTYPE` environment variables (setting one of them is sufficent). To enable
+unicode characters in file paths e.g. set: `LANG=en_US.UTF-8`
+
+If paths are used that are not valid according to the system language setting
+(e.g. if a path contains unicode characters but `LANG` is `en_US.iso88591`)
+the Java NIO API throws a `java.nio.file.InvalidPathException` with the message
+`Malformed input or input contains unmappable characters`. If such an exception
+occurs code-owner requests return `409 Conflict`, telling the user about the
+invalid path.
+
---
Back to [@PLUGIN@ documentation index](index.html)