Browse Source

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.
Thomas Waldmann 9 years ago
parent
commit
d2e5ce90f2
1 changed files with 12 additions and 0 deletions
  1. 12 0
      docs/faq.rst

+ 12 - 0
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::