mirror of
https://github.com/amadvance/snapraid.git
synced 2026-11-21 23:46:27 -05:00
Document Windows non-ASCII case matching limitation under known issues
Some checks are pending
Build / build-mac (push) Waiting to run
Build / build-linux (push) Waiting to run
Build / build-arm32 (push) Waiting to run
Build / build-win (push) Waiting to run
Build / build-freebsd (push) Waiting to run
CodeQL Advanced / Analyze (c-cpp) (push) Waiting to run
CodeQL Advanced / Analyze (actions) (push) Waiting to run
Some checks are pending
Build / build-mac (push) Waiting to run
Build / build-linux (push) Waiting to run
Build / build-arm32 (push) Waiting to run
Build / build-win (push) Waiting to run
Build / build-freebsd (push) Waiting to run
CodeQL Advanced / Analyze (c-cpp) (push) Waiting to run
CodeQL Advanced / Analyze (actions) (push) Waiting to run
This commit is contained in:
parent
dd97bb2fa6
commit
ecec71773b
42 changed files with 839 additions and 0 deletions
|
|
@ -1833,6 +1833,25 @@ Known Issues
|
|||
Otherwise, the difference will only be detected as a hash mismatch
|
||||
during a subsequent "scrub" or "check".
|
||||
|
||||
Windows non-ASCII case matching
|
||||
SnapRAID uses standard, predictable UTF-8 encoding across all platforms,
|
||||
limiting case-insensitive matching to ASCII characters.
|
||||
|
||||
Windows filesystems suffer from the legacy design of enforcing case
|
||||
insensitivity across Unicode filenames via arbitrary, system-dependent
|
||||
folding tables. Consequently, Windows obscures the reality of the
|
||||
filesystem by treating completely different Unicode byte sequences as if
|
||||
they were the same file.
|
||||
|
||||
For example, `À.txt` and `à.txt` are distinct Unicode names, yet Windows
|
||||
illogically treats them as identical, while SnapRAID preserves their true
|
||||
distinction.
|
||||
|
||||
This limitation is caused by Windows's inconsistent handling of Unicode
|
||||
filenames and its insistence on case-insensitive aliasing. To prevent
|
||||
discrepancies arising from Windows's case folding, always specify the
|
||||
exact case for any non-ASCII characters in configuration paths and filters.
|
||||
|
||||
Copyright
|
||||
This file is Copyright (C) 2026 Andrea Mazzoleni
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue