Add case-insensitivity note to the mount.exfat-fuse man page.

[android-x86/external-exfat.git] / fuse / mount.exfat-fuse.8

diff --git a/fuse/mount.exfat-fuse.8 b/fuse/mount.exfat-fuse.8
index 1cd2a0f..38586ca 100644 (file)
--- a/fuse/mount.exfat-fuse.8
+++ b/fuse/mount.exfat-fuse.8
@@ -81,6 +81,26 @@ Do not update access time when file is read.
 .SH EXIT CODES
 Zero is returned on successful mount. Any other code means an error.
 
+.SH BUGS
+exFAT is a case-insensitive file system. Some things can behave unexpectedly,
+e.g. directory renaming that changes only case of some characters:
+
+.B \t$ mv FOO Foo
+.br
+.B \tmv: cannot move \(cqFOO\(cq to a subdirectory of itself, \(cqFoo/FOO\(cq
+
+This happens because
+.B mv
+finds that destination exists (for case-insensitive file
+systems
+.B FOO
+and
+.B Foo
+are the same thing) and adds source basename to the destination. The file
+system gets
+.B rename(\(dqFOO\(dq,\ \(dqFoo/FOO\(dq)
+syscall and returns an error.
+
 .SH AUTHOR
 Andrew Nayenko