add FAQ entry about OS X commandline vs. HFS+ encoding issue, see #143.

a real fix for this is in development, but needs some time.

1 files changed, 12 insertions, 0 deletions

diff --git a/docs/faq.rst b/docs/faq.rst
index 37e7b2dfe..d13fe67f1 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -86,6 +86,18 @@ If it crashes with a UnicodeError, what can I do?
 
         export LANG=en_US.UTF-8  # or similar, important is correct charset
 
+I can't extract non-ascii filenames by giving them on the commandline on OS X!?
+    This is due to different ways to represent some characters in unicode.
+    HFS+ likes the decomposed form while the commandline seems to be the composed
+    form usually. If you run into that, for now maybe just try:
+
+    - avoiding the non-ascii characters on the commandline by e.g. extracting
+      the parent directory (or even everything)
+    - try to enter the composed form on the commandline
+    - mount the repo using FUSE and use some file manager
+
+    See issue #143 on the issue tracker for more about this.
+
 If I want to run |project_name| on a ARM CPU older than ARM v6?
     You need to enable the alignment trap handler to fixup misaligned accesses::