From 0c80cd7dea64d78cf8577402f2e1bea390a86fec Mon Sep 17 00:00:00 2001 From: Andrea Mazzoleni Date: Wed, 26 Aug 2026 15:17:33 +0200 Subject: [PATCH] Document Windows non-ASCII case matching limitation under known issues --- doc/snapraid-de.1 | 20 ++++++++++++++++++++ doc/snapraid-de.d | 21 +++++++++++++++++++++ doc/snapraid-de.txt | 23 +++++++++++++++++++++++ doc/snapraid-es.1 | 21 +++++++++++++++++++++ doc/snapraid-es.d | 22 ++++++++++++++++++++++ doc/snapraid-es.txt | 24 ++++++++++++++++++++++++ doc/snapraid-fr.1 | 20 ++++++++++++++++++++ doc/snapraid-fr.d | 21 +++++++++++++++++++++ doc/snapraid-fr.txt | 23 +++++++++++++++++++++++ doc/snapraid-it.1 | 21 +++++++++++++++++++++ doc/snapraid-it.d | 22 ++++++++++++++++++++++ doc/snapraid-it.txt | 24 ++++++++++++++++++++++++ doc/snapraid-ja.1 | 16 ++++++++++++++++ doc/snapraid-ja.d | 17 +++++++++++++++++ doc/snapraid-ja.txt | 19 +++++++++++++++++++ doc/snapraid-ko.1 | 16 ++++++++++++++++ doc/snapraid-ko.d | 17 +++++++++++++++++ doc/snapraid-ko.txt | 19 +++++++++++++++++++ doc/snapraid-pl.1 | 20 ++++++++++++++++++++ doc/snapraid-pl.d | 21 +++++++++++++++++++++ doc/snapraid-pl.txt | 23 +++++++++++++++++++++++ doc/snapraid-pt.1 | 20 ++++++++++++++++++++ doc/snapraid-pt.d | 21 +++++++++++++++++++++ doc/snapraid-pt.txt | 23 +++++++++++++++++++++++ doc/snapraid-ro.1 | 20 ++++++++++++++++++++ doc/snapraid-ro.d | 21 +++++++++++++++++++++ doc/snapraid-ro.txt | 23 +++++++++++++++++++++++ doc/snapraid-ru.1 | 21 +++++++++++++++++++++ doc/snapraid-ru.d | 22 ++++++++++++++++++++++ doc/snapraid-ru.txt | 24 ++++++++++++++++++++++++ doc/snapraid-sv.1 | 16 ++++++++++++++++ doc/snapraid-sv.d | 17 +++++++++++++++++ doc/snapraid-sv.txt | 19 +++++++++++++++++++ doc/snapraid-uk.1 | 18 ++++++++++++++++++ doc/snapraid-uk.d | 19 +++++++++++++++++++ doc/snapraid-uk.txt | 21 +++++++++++++++++++++ doc/snapraid-zh.1 | 14 ++++++++++++++ doc/snapraid-zh.d | 15 +++++++++++++++ doc/snapraid-zh.txt | 17 +++++++++++++++++ doc/snapraid.1 | 18 ++++++++++++++++++ doc/snapraid.d | 19 +++++++++++++++++++ doc/snapraid.txt | 21 +++++++++++++++++++++ 42 files changed, 839 insertions(+) diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1 index d24f8b4c..cc6d344f 100644 --- a/doc/snapraid-de.1 +++ b/doc/snapraid-de.1 @@ -2465,6 +2465,26 @@ Um sicherzustellen, dass SnapRAID solche Änderungen erkennt, aktualisieren Sie den Änderungszeitstempel der Datei (z. B. mit dem Dienstprogramm \[dq]touch\[dq]). Andernfalls wird der Unterschied erst bei einem nachfolgenden \[dq]scrub\[dq] oder \[dq]check\[dq] als Hash\-Fehlübereinstimmung erkannt. +.SS Nicht\-ASCII\-Groß\-/Kleinschreibung unter Windows +SnapRAID verwendet auf allen Plattformen eine standardmäßige, vorhersehbare +UTF\-8\-Kodierung und beschränkt den Vergleich ohne Berücksichtigung der +Groß\-/Kleinschreibung auf ASCII\-Zeichen. +.PP +Windows\-Dateisysteme leiden unter dem veralteten Konzept, die Unempfindlichkeit +gegenüber der Groß\-/Kleinschreibung bei Unicode\-Dateinamen über willkürliche, +systemabhängige Folding\-Tabellen zu erzwingen. Infolgedessen verschleiert Windows +die Realität des Dateisystems, indem es völlig unterschiedliche +Unicode\-Bytesequenzen so behandelt, als wären sie dieselbe Datei. +.PP +Beispielsweise sind \`À.txt\` und \`à.txt\` unterschiedliche Unicode\-Namen, dennoch +behandelt Windows sie unlogischerweise als identisch, während SnapRAID ihre +tatsächliche Unterscheidung beibehält. +.PP +Diese Einschränkung wird durch den inkonsistenten Umgang von Windows mit +Unicode\-Dateinamen und das Beharren auf einer Groß\-/Kleinschreibungs\-Aliasing +verursacht. Um Abweichungen durch das Case\-Folding von Windows zu vermeiden, +geben Sie für alle Nicht\-ASCII\-Zeichen in Konfigurationspfaden und Filtern +stets die exakte Groß\-/Kleinschreibung an. .SH ÜBERSETZUNG (TRANSLATION) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. diff --git a/doc/snapraid-de.d b/doc/snapraid-de.d index 94101262..a240515c 100644 --- a/doc/snapraid-de.d +++ b/doc/snapraid-de.d @@ -1954,6 +1954,27 @@ Bekannte Probleme (Known Issues) Andernfalls wird der Unterschied erst bei einem nachfolgenden "scrub" oder "check" als Hash-Fehlübereinstimmung erkannt. + Nicht-ASCII-Groß-/Kleinschreibung unter Windows + SnapRAID verwendet auf allen Plattformen eine standardmäßige, vorhersehbare + UTF-8-Kodierung und beschränkt den Vergleich ohne Berücksichtigung der + Groß-/Kleinschreibung auf ASCII-Zeichen. + + Windows-Dateisysteme leiden unter dem veralteten Konzept, die Unempfindlichkeit + gegenüber der Groß-/Kleinschreibung bei Unicode-Dateinamen über willkürliche, + systemabhängige Folding-Tabellen zu erzwingen. Infolgedessen verschleiert Windows + die Realität des Dateisystems, indem es völlig unterschiedliche + Unicode-Bytesequenzen so behandelt, als wären sie dieselbe Datei. + + Beispielsweise sind `À.txt` und `à.txt` unterschiedliche Unicode-Namen, dennoch + behandelt Windows sie unlogischerweise als identisch, während SnapRAID ihre + tatsächliche Unterscheidung beibehält. + + Diese Einschränkung wird durch den inkonsistenten Umgang von Windows mit + Unicode-Dateinamen und das Beharren auf einer Groß-/Kleinschreibungs-Aliasing + verursacht. Um Abweichungen durch das Case-Folding von Windows zu vermeiden, + geben Sie für alle Nicht-ASCII-Zeichen in Konfigurationspfaden und Filtern + stets die exakte Groß-/Kleinschreibung an. + Übersetzung (Translation) Dieses Dokument ist eine automatische Übersetzung des englischen Handbuchs. Die maßgebliche Version finden Sie im englischen Handbuch. diff --git a/doc/snapraid-de.txt b/doc/snapraid-de.txt index 1d63aa41..c799fe8a 100644 --- a/doc/snapraid-de.txt +++ b/doc/snapraid-de.txt @@ -2093,6 +2093,29 @@ Sie den Änderungszeitstempel der Datei (z. B. mit dem Dienstprogramm "touch"). Andernfalls wird der Unterschied erst bei einem nachfolgenden "scrub" oder "check" als Hash-Fehlübereinstimmung erkannt. +16.5 Nicht-ASCII-Groß-/Kleinschreibung unter Windows +---------------------------------------------------- + +SnapRAID verwendet auf allen Plattformen eine standardmäßige, vorhersehbare +UTF-8-Kodierung und beschränkt den Vergleich ohne Berücksichtigung der +Groß-/Kleinschreibung auf ASCII-Zeichen. + +Windows-Dateisysteme leiden unter dem veralteten Konzept, die Unempfindlichkeit +gegenüber der Groß-/Kleinschreibung bei Unicode-Dateinamen über willkürliche, +systemabhängige Folding-Tabellen zu erzwingen. Infolgedessen verschleiert Windows +die Realität des Dateisystems, indem es völlig unterschiedliche +Unicode-Bytesequenzen so behandelt, als wären sie dieselbe Datei. + +Beispielsweise sind `À.txt` und `à.txt` unterschiedliche Unicode-Namen, dennoch +behandelt Windows sie unlogischerweise als identisch, während SnapRAID ihre +tatsächliche Unterscheidung beibehält. + +Diese Einschränkung wird durch den inkonsistenten Umgang von Windows mit +Unicode-Dateinamen und das Beharren auf einer Groß-/Kleinschreibungs-Aliasing +verursacht. Um Abweichungen durch das Case-Folding von Windows zu vermeiden, +geben Sie für alle Nicht-ASCII-Zeichen in Konfigurationspfaden und Filtern +stets die exakte Groß-/Kleinschreibung an. + 17 ÜBERSETZUNG (TRANSLATION) ============================ diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1 index 494e056d..d04b32d9 100644 --- a/doc/snapraid-es.1 +++ b/doc/snapraid-es.1 @@ -2419,6 +2419,27 @@ Para asegurarse de que SnapRAID reconozca dichos cambios, actualice la marca de tiempo de modificación del archivo (por ejemplo, con la utilidad \[dq]touch\[dq]). De lo contrario, la diferencia solo se detectará como una falta de coincidencia de hash durante un \[dq]scrub\[dq] o \[dq]check\[dq] posterior. +.SS Coincidencia de mayúsculas y minúsculas no ASCII en Windows +SnapRAID utiliza una codificación UTF\-8 estándar y predecible en todas las +plataformas, limitando la coincidencia insensible a mayúsculas y minúsculas +a los caracteres ASCII. +.PP +Los sistemas de archivos de Windows adolecen del diseño heredado de imponer +la insensibilidad a mayúsculas y minúsculas en nombres de archivo Unicode a +través de tablas de plegado arbitrarias y dependientes del sistema. En +consecuencia, Windows distorsiona la realidad del sistema de archivos al +tratar secuencias de bytes Unicode completamente diferentes como si fueran el +mismo archivo. +.PP +Por ejemplo, \`À.txt\` y \`à.txt\` son nombres Unicode distintos; sin embargo, +Windows los trata ilógicamente como idénticos, mientras que SnapRAID conserva +su verdadera distinción. +.PP +Esta limitación se debe al manejo inconsistente de los nombres de archivo +Unicode por parte de Windows y a su insistencia en aplicar alias que ignoran +mayúsculas y minúsculas. Para evitar discrepancias derivadas del plegado de +mayúsculas y minúsculas de Windows, especifique siempre la grafía exacta de +los caracteres no ASCII en las rutas de configuración y filtros. .SH TRADUCCIóN (TRANSLATION) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. diff --git a/doc/snapraid-es.d b/doc/snapraid-es.d index 5b34036e..37ef8e0b 100644 --- a/doc/snapraid-es.d +++ b/doc/snapraid-es.d @@ -1919,6 +1919,28 @@ Problemas conocidos (Known Issues) De lo contrario, la diferencia solo se detectará como una falta de coincidencia de hash durante un "scrub" o "check" posterior. + Coincidencia de mayúsculas y minúsculas no ASCII en Windows + SnapRAID utiliza una codificación UTF-8 estándar y predecible en todas las + plataformas, limitando la coincidencia insensible a mayúsculas y minúsculas + a los caracteres ASCII. + + Los sistemas de archivos de Windows adolecen del diseño heredado de imponer + la insensibilidad a mayúsculas y minúsculas en nombres de archivo Unicode a + través de tablas de plegado arbitrarias y dependientes del sistema. En + consecuencia, Windows distorsiona la realidad del sistema de archivos al + tratar secuencias de bytes Unicode completamente diferentes como si fueran el + mismo archivo. + + Por ejemplo, `À.txt` y `à.txt` son nombres Unicode distintos; sin embargo, + Windows los trata ilógicamente como idénticos, mientras que SnapRAID conserva + su verdadera distinción. + + Esta limitación se debe al manejo inconsistente de los nombres de archivo + Unicode por parte de Windows y a su insistencia en aplicar alias que ignoran + mayúsculas y minúsculas. Para evitar discrepancias derivadas del plegado de + mayúsculas y minúsculas de Windows, especifique siempre la grafía exacta de + los caracteres no ASCII en las rutas de configuración y filtros. + Traducción (Translation) Este documento es una traducción automática del manual en inglés. Consulte el manual en inglés para obtener la versión oficial. diff --git a/doc/snapraid-es.txt b/doc/snapraid-es.txt index 3f99d9ff..fa992f5f 100644 --- a/doc/snapraid-es.txt +++ b/doc/snapraid-es.txt @@ -2058,6 +2058,30 @@ de tiempo de modificación del archivo (por ejemplo, con la utilidad "touch"). De lo contrario, la diferencia solo se detectará como una falta de coincidencia de hash durante un "scrub" o "check" posterior. +16.5 Coincidencia de mayúsculas y minúsculas no ASCII en Windows +---------------------------------------------------------------- + +SnapRAID utiliza una codificación UTF-8 estándar y predecible en todas las +plataformas, limitando la coincidencia insensible a mayúsculas y minúsculas +a los caracteres ASCII. + +Los sistemas de archivos de Windows adolecen del diseño heredado de imponer +la insensibilidad a mayúsculas y minúsculas en nombres de archivo Unicode a +través de tablas de plegado arbitrarias y dependientes del sistema. En +consecuencia, Windows distorsiona la realidad del sistema de archivos al +tratar secuencias de bytes Unicode completamente diferentes como si fueran el +mismo archivo. + +Por ejemplo, `À.txt` y `à.txt` son nombres Unicode distintos; sin embargo, +Windows los trata ilógicamente como idénticos, mientras que SnapRAID conserva +su verdadera distinción. + +Esta limitación se debe al manejo inconsistente de los nombres de archivo +Unicode por parte de Windows y a su insistencia en aplicar alias que ignoran +mayúsculas y minúsculas. Para evitar discrepancias derivadas del plegado de +mayúsculas y minúsculas de Windows, especifique siempre la grafía exacta de +los caracteres no ASCII en las rutas de configuración y filtros. + 17 TRADUCCIóN (TRANSLATION) =========================== diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1 index 5165094d..0c3ccc5f 100644 --- a/doc/snapraid-fr.1 +++ b/doc/snapraid-fr.1 @@ -2466,6 +2466,26 @@ Pour vous assurer que SnapRAID reconnaît ces modifications, mettez à jour l\'horodatage de modification du fichier (par exemple avec l\'utilitaire \[dq]touch\[dq]). Sinon, la différence ne sera détectée que sous la forme d\'une non\-concordance de hachage lors d\'un \[dq]scrub\[dq] ou \[dq]check\[dq] ultérieur. +.SS Correspondance de casse non\-ASCII sous Windows +SnapRAID utilise un encodage UTF\-8 standard et prévisible sur toutes les +plates\-formes, limitant la correspondance insensible à la casse aux caractères +ASCII. +.PP +Les systèmes de fichiers Windows souffrent d\'une conception héritée du passé +qui impose l\'insensibilité à la casse sur les noms de fichiers Unicode via des +tables de correspondance arbitraires et dépendantes du système. Par conséquent, +Windows masque la réalité du système de fichiers en traitant des séquences d\'octets +Unicode complètement différentes comme s\'il s\'agissait du même fichier. +.PP +Par exemple, \`À.txt\` et \`à.txt\` sont des noms Unicode distincts, pourtant Windows +les traite illogiquement comme identiques, tandis que SnapRAID préserve leur +véritable distinction. +.PP +Cette limitation est causée par la gestion incohérente des noms de fichiers +Unicode par Windows et son insistance sur l\'aliasement insensible à la casse. +Pour éviter les écarts causés par le repliement de casse de Windows, spécifiez +toujours la casse exacte de tous les caractères non\-ASCII dans les chemins de +configuration et les filtres. .SH TRADUCTION (TRANSLATION) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. diff --git a/doc/snapraid-fr.d b/doc/snapraid-fr.d index b248c696..5829dcee 100644 --- a/doc/snapraid-fr.d +++ b/doc/snapraid-fr.d @@ -1963,6 +1963,27 @@ Problèmes connus (Known Issues) "touch"). Sinon, la différence ne sera détectée que sous la forme d'une non-concordance de hachage lors d'un "scrub" ou "check" ultérieur. + Correspondance de casse non-ASCII sous Windows + SnapRAID utilise un encodage UTF-8 standard et prévisible sur toutes les + plates-formes, limitant la correspondance insensible à la casse aux caractères + ASCII. + + Les systèmes de fichiers Windows souffrent d'une conception héritée du passé + qui impose l'insensibilité à la casse sur les noms de fichiers Unicode via des + tables de correspondance arbitraires et dépendantes du système. Par conséquent, + Windows masque la réalité du système de fichiers en traitant des séquences d'octets + Unicode complètement différentes comme s'il s'agissait du même fichier. + + Par exemple, `À.txt` et `à.txt` sont des noms Unicode distincts, pourtant Windows + les traite illogiquement comme identiques, tandis que SnapRAID préserve leur + véritable distinction. + + Cette limitation est causée par la gestion incohérente des noms de fichiers + Unicode par Windows et son insistance sur l'aliasement insensible à la casse. + Pour éviter les écarts causés par le repliement de casse de Windows, spécifiez + toujours la casse exacte de tous les caractères non-ASCII dans les chemins de + configuration et les filtres. + Traduction (Translation) Ce document est une traduction automatique du manuel en anglais. Veuillez vous référer au manuel en anglais pour la version officielle. diff --git a/doc/snapraid-fr.txt b/doc/snapraid-fr.txt index cfa1ea45..789288f7 100644 --- a/doc/snapraid-fr.txt +++ b/doc/snapraid-fr.txt @@ -2102,6 +2102,29 @@ l'horodatage de modification du fichier (par exemple avec l'utilitaire "touch"). Sinon, la différence ne sera détectée que sous la forme d'une non-concordance de hachage lors d'un "scrub" ou "check" ultérieur. +16.5 Correspondance de casse non-ASCII sous Windows +--------------------------------------------------- + +SnapRAID utilise un encodage UTF-8 standard et prévisible sur toutes les +plates-formes, limitant la correspondance insensible à la casse aux caractères +ASCII. + +Les systèmes de fichiers Windows souffrent d'une conception héritée du passé +qui impose l'insensibilité à la casse sur les noms de fichiers Unicode via des +tables de correspondance arbitraires et dépendantes du système. Par conséquent, +Windows masque la réalité du système de fichiers en traitant des séquences d'octets +Unicode complètement différentes comme s'il s'agissait du même fichier. + +Par exemple, `À.txt` et `à.txt` sont des noms Unicode distincts, pourtant Windows +les traite illogiquement comme identiques, tandis que SnapRAID préserve leur +véritable distinction. + +Cette limitation est causée par la gestion incohérente des noms de fichiers +Unicode par Windows et son insistance sur l'aliasement insensible à la casse. +Pour éviter les écarts causés par le repliement de casse de Windows, spécifiez +toujours la casse exacte de tous les caractères non-ASCII dans les chemins de +configuration et les filtres. + 17 TRADUCTION (TRANSLATION) =========================== diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1 index b714d85b..ba7a78fb 100644 --- a/doc/snapraid-it.1 +++ b/doc/snapraid-it.1 @@ -2441,6 +2441,27 @@ Per garantire che SnapRAID riconosca tali modifiche, aggiornare il timestamp di modifica del file (ad esempio con l\'utilità \[dq]touch\[dq]). Altrimenti, la differenza verrà rilevata solo come mancata corrispondenza dell\'hash durante un successivo \[dq]scrub\[dq] o \[dq]check\[dq]. +.SS Corrispondenza maiuscole/minuscole non ASCII in Windows +SnapRAID utilizza la codifica UTF\-8 standard e prevedibile su tutte le +piattaforme, limitando la corrispondenza senza distinzione tra maiuscole e +minuscole ai caratteri ASCII. +.PP +I filesystem di Windows soffrono della scelta progettuale obsoleta di imporre +l\'insensibilità al maiuscolo/minuscolo sui nomi di file Unicode tramite tabelle +di conversione arbitrarie e dipendenti dal sistema. Di conseguenza, Windows +maschera la realtà del filesystem trattando sequenze di byte Unicode +completamente diverse come se fossero lo stesso file. +.PP +Ad esempio, \`À.txt\` e \`à.txt\` sono nomi Unicode distinti, eppure Windows +illogicamente li tratta come identici, mentre SnapRAID ne preserva la reale +distinzione. +.PP +Questa limitazione è causata dalla gestione incoerente dei nomi di file Unicode +da parte di Windows e dalla sua insistenza nell\'applicare alias insensibili al +maiuscolo/minuscolo. Per prevenire discrepanze dovute alla conversione del +maiuscolo/minuscolo di Windows, specificare sempre l\'esatta combinazione di +maiuscole/minuscole per qualsiasi carattere non ASCII nei percorsi di +configurazione e nei filtri. .SH TRADUZIONE (TRANSLATION) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. diff --git a/doc/snapraid-it.d b/doc/snapraid-it.d index 92b32446..ea16afe1 100644 --- a/doc/snapraid-it.d +++ b/doc/snapraid-it.d @@ -1927,6 +1927,28 @@ Problemi noti (Known Issues) differenza verrà rilevata solo come mancata corrispondenza dell'hash durante un successivo "scrub" o "check". + Corrispondenza maiuscole/minuscole non ASCII in Windows + SnapRAID utilizza la codifica UTF-8 standard e prevedibile su tutte le + piattaforme, limitando la corrispondenza senza distinzione tra maiuscole e + minuscole ai caratteri ASCII. + + I filesystem di Windows soffrono della scelta progettuale obsoleta di imporre + l'insensibilità al maiuscolo/minuscolo sui nomi di file Unicode tramite tabelle + di conversione arbitrarie e dipendenti dal sistema. Di conseguenza, Windows + maschera la realtà del filesystem trattando sequenze di byte Unicode + completamente diverse come se fossero lo stesso file. + + Ad esempio, `À.txt` e `à.txt` sono nomi Unicode distinti, eppure Windows + illogicamente li tratta come identici, mentre SnapRAID ne preserva la reale + distinzione. + + Questa limitazione è causata dalla gestione incoerente dei nomi di file Unicode + da parte di Windows e dalla sua insistenza nell'applicare alias insensibili al + maiuscolo/minuscolo. Per prevenire discrepanze dovute alla conversione del + maiuscolo/minuscolo di Windows, specificare sempre l'esatta combinazione di + maiuscole/minuscole per qualsiasi carattere non ASCII nei percorsi di + configurazione e nei filtri. + Traduzione (Translation) Questo documento è una traduzione automatica del manuale in inglese. Fare riferimento al manuale in inglese per la versione ufficiale. diff --git a/doc/snapraid-it.txt b/doc/snapraid-it.txt index a744df1f..dc0ce9bc 100644 --- a/doc/snapraid-it.txt +++ b/doc/snapraid-it.txt @@ -2066,6 +2066,30 @@ di modifica del file (ad esempio con l'utilità "touch"). Altrimenti, la differenza verrà rilevata solo come mancata corrispondenza dell'hash durante un successivo "scrub" o "check". +16.5 Corrispondenza maiuscole/minuscole non ASCII in Windows +------------------------------------------------------------ + +SnapRAID utilizza la codifica UTF-8 standard e prevedibile su tutte le +piattaforme, limitando la corrispondenza senza distinzione tra maiuscole e +minuscole ai caratteri ASCII. + +I filesystem di Windows soffrono della scelta progettuale obsoleta di imporre +l'insensibilità al maiuscolo/minuscolo sui nomi di file Unicode tramite tabelle +di conversione arbitrarie e dipendenti dal sistema. Di conseguenza, Windows +maschera la realtà del filesystem trattando sequenze di byte Unicode +completamente diverse come se fossero lo stesso file. + +Ad esempio, `À.txt` e `à.txt` sono nomi Unicode distinti, eppure Windows +illogicamente li tratta come identici, mentre SnapRAID ne preserva la reale +distinzione. + +Questa limitazione è causata dalla gestione incoerente dei nomi di file Unicode +da parte di Windows e dalla sua insistenza nell'applicare alias insensibili al +maiuscolo/minuscolo. Per prevenire discrepanze dovute alla conversione del +maiuscolo/minuscolo di Windows, specificare sempre l'esatta combinazione di +maiuscole/minuscole per qualsiasi carattere non ASCII nei percorsi di +configurazione e nei filtri. + 17 TRADUZIONE (TRANSLATION) =========================== diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1 index 1530b957..5f71ba48 100644 --- a/doc/snapraid-ja.1 +++ b/doc/snapraid-ja.1 @@ -2196,6 +2196,22 @@ SnapRAIDにそのような変更を確実に認識させるには、ファイル を更新してください(たとえば、\[dq]touch\[dq] ユーティリティなどを使用)。そうしない 場合、その差分は後続の \[dq]scrub\[dq] または \[dq]check\[dq] 中のハッシュ不一致としてのみ 検出されます。 +.SS Windowsにおける非ASCII文字の大文字・小文字の一致 +SnapRAIDはすべてのプラットフォームで標準的で予測可能なUTF\-8エンコーディング +を使用し、大文字・小文字を区別しないマッチングをASCII文字に限定しています。 +.PP +Windowsファイルシステムは、任意のシステム依存のフォールディングテーブルを介して +Unicodeファイル名全体で大文字・小文字の不区別を強制するというレガシーな設計の +影響を受けています。その結果、Windowsは全く異なるUnicodeバイトシーケンスをあたかも +同じファイルであるかのように扱い、ファイルシステムの実態を覆い隠してしまいます。 +.PP +たとえば、\`À.txt\` と \`à.txt\` は明確に異なるUnicode名ですが、Windowsは非論理的にも +これらを同一として扱い、SnapRAIDはそれらの本来の区別を維持します。 +.PP +この制限は、WindowsによるUnicodeファイル名の非一貫な処理と、大文字・小文字を区別 +しないエイリアスへの固執によって引き起こされます。Windowsの大文字・小文字フォール +ディングに起因する不一致を防ぐため、設定パスおよびフィルター内の非ASCII文字には +常に正確な大文字・小文字を指定してください。 .SH 翻訳 (TRANSLATION) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d index 8bddd0fb..df5fd8c8 100644 --- a/doc/snapraid-ja.d +++ b/doc/snapraid-ja.d @@ -1696,6 +1696,23 @@ Name{number} 場合、その差分は後続の "scrub" または "check" 中のハッシュ不一致としてのみ 検出されます。 + Windowsにおける非ASCII文字の大文字・小文字の一致 + SnapRAIDはすべてのプラットフォームで標準的で予測可能なUTF-8エンコーディング + を使用し、大文字・小文字を区別しないマッチングをASCII文字に限定しています。 + + Windowsファイルシステムは、任意のシステム依存のフォールディングテーブルを介して + Unicodeファイル名全体で大文字・小文字の不区別を強制するというレガシーな設計の + 影響を受けています。その結果、Windowsは全く異なるUnicodeバイトシーケンスをあたかも + 同じファイルであるかのように扱い、ファイルシステムの実態を覆い隠してしまいます。 + + たとえば、`À.txt` と `à.txt` は明確に異なるUnicode名ですが、Windowsは非論理的にも + これらを同一として扱い、SnapRAIDはそれらの本来の区別を維持します。 + + この制限は、WindowsによるUnicodeファイル名の非一貫な処理と、大文字・小文字を区別 + しないエイリアスへの固執によって引き起こされます。Windowsの大文字・小文字フォール + ディングに起因する不一致を防ぐため、設定パスおよびフィルター内の非ASCII文字には + 常に正確な大文字・小文字を指定してください。 + 翻訳 (Translation) この文書は英語版マニュアルの自動翻訳です。 正確な記述については英語版マニュアルを参照してください。 diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt index 87adbbe8..cc449728 100644 --- a/doc/snapraid-ja.txt +++ b/doc/snapraid-ja.txt @@ -1835,6 +1835,25 @@ SnapRAIDにそのような変更を確実に認識させるには、ファイル 場合、その差分は後続の "scrub" または "check" 中のハッシュ不一致としてのみ 検出されます。 +16.5 Windowsにおける非ASCII文字の大文字・小文字の一致 +----------------------------------- + +SnapRAIDはすべてのプラットフォームで標準的で予測可能なUTF-8エンコーディング +を使用し、大文字・小文字を区別しないマッチングをASCII文字に限定しています。 + +Windowsファイルシステムは、任意のシステム依存のフォールディングテーブルを介して +Unicodeファイル名全体で大文字・小文字の不区別を強制するというレガシーな設計の +影響を受けています。その結果、Windowsは全く異なるUnicodeバイトシーケンスをあたかも +同じファイルであるかのように扱い、ファイルシステムの実態を覆い隠してしまいます。 + +たとえば、`À.txt` と `à.txt` は明確に異なるUnicode名ですが、Windowsは非論理的にも +これらを同一として扱い、SnapRAIDはそれらの本来の区別を維持します。 + +この制限は、WindowsによるUnicodeファイル名の非一貫な処理と、大文字・小文字を区別 +しないエイリアスへの固執によって引き起こされます。Windowsの大文字・小文字フォール +ディングに起因する不一致を防ぐため、設定パスおよびフィルター内の非ASCII文字には +常に正確な大文字・小文字を指定してください。 + 17 翻訳 (TRANSLATION) =================== diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1 index 6a09bb2b..58677bb4 100644 --- a/doc/snapraid-ko.1 +++ b/doc/snapraid-ko.1 @@ -2241,6 +2241,22 @@ SnapRAID는 파일 크기와 수정 타임스탬프(mtime)를 비교하여 파 SnapRAID가 이러한 변경 사항을 인식하도록 하려면 파일의 수정 타임스탬프를 업데이트하십시오(예: \[dq]touch\[dq] 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 \[dq]scrub\[dq] 또는 \[dq]check\[dq] 중에 해시 불일치로만 감지됩니다. +.SS Windows 비ASCII 대소문자 일치 +SnapRAID는 모든 플랫폼에서 표준적이고 예측 가능한 UTF\-8 인코딩을 사용하며, +대소문자를 구분하지 않는 일치를 ASCII 문자로 제한합니다. +.PP +Windows 파일 시스템은 임의의 시스템 종속 폴딩 테이블을 통해 유니코드 파일 이름 +전체에서 대소문자 구분을 없애도록 강제하는 레거시 디자인의 한계를 안고 있습니다. +결과적으로 Windows는 완전히 다른 유니코드 바이트 시퀀스를 마치 동일한 파일인 것처럼 +취급하여 파일 시스템의 실제 상태를 왜곡합니다. +.PP +예를 들어 \`À.txt\`와 \`à.txt\`는 고유한 유니코드 이름이지만, Windows는 비논리적으로 +이를 동일하게 취급하는 반면 SnapRAID는 이들의 진정한 차이를 보존합니다. +.PP +이 제한은 Windows의 일관성 없는 유니코드 파일 이름 처리와 대소문자를 구분하지 않는 +별칭 지정 고집으로 인해 발생합니다. Windows의 대소문자 폴딩으로 인한 불일치를 +방지하려면 구성 경로 및 필터의 비ASCII 문자에 대해 항상 정확한 대소문자를 +지정하십시오. .SH 번역 (TRANSLATION) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d index 753207d8..5cf7539c 100644 --- a/doc/snapraid-ko.d +++ b/doc/snapraid-ko.d @@ -1741,6 +1741,23 @@ Name{number} 업데이트하십시오(예: "touch" 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 "scrub" 또는 "check" 중에 해시 불일치로만 감지됩니다. + Windows 비ASCII 대소문자 일치 + SnapRAID는 모든 플랫폼에서 표준적이고 예측 가능한 UTF-8 인코딩을 사용하며, + 대소문자를 구분하지 않는 일치를 ASCII 문자로 제한합니다. + + Windows 파일 시스템은 임의의 시스템 종속 폴딩 테이블을 통해 유니코드 파일 이름 + 전체에서 대소문자 구분을 없애도록 강제하는 레거시 디자인의 한계를 안고 있습니다. + 결과적으로 Windows는 완전히 다른 유니코드 바이트 시퀀스를 마치 동일한 파일인 것처럼 + 취급하여 파일 시스템의 실제 상태를 왜곡합니다. + + 예를 들어 `À.txt`와 `à.txt`는 고유한 유니코드 이름이지만, Windows는 비논리적으로 + 이를 동일하게 취급하는 반면 SnapRAID는 이들의 진정한 차이를 보존합니다. + + 이 제한은 Windows의 일관성 없는 유니코드 파일 이름 처리와 대소문자를 구분하지 않는 + 별칭 지정 고집으로 인해 발생합니다. Windows의 대소문자 폴딩으로 인한 불일치를 + 방지하려면 구성 경로 및 필터의 비ASCII 문자에 대해 항상 정확한 대소문자를 + 지정하십시오. + 번역 (Translation) 이 문서는 영어 매뉴얼의 자동 번역본입니다. 공식 버전은 영어 매뉴얼을 참조하십시오. diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt index 08f404fc..0f272795 100644 --- a/doc/snapraid-ko.txt +++ b/doc/snapraid-ko.txt @@ -1880,6 +1880,25 @@ SnapRAID가 이러한 변경 사항을 인식하도록 하려면 파일의 수 업데이트하십시오(예: "touch" 유틸리티 사용). 그렇지 않으면 이 차이점은 이후의 "scrub" 또는 "check" 중에 해시 불일치로만 감지됩니다. +16.5 Windows 비ASCII 대소문자 일치 +--------------------------- + +SnapRAID는 모든 플랫폼에서 표준적이고 예측 가능한 UTF-8 인코딩을 사용하며, +대소문자를 구분하지 않는 일치를 ASCII 문자로 제한합니다. + +Windows 파일 시스템은 임의의 시스템 종속 폴딩 테이블을 통해 유니코드 파일 이름 +전체에서 대소문자 구분을 없애도록 강제하는 레거시 디자인의 한계를 안고 있습니다. +결과적으로 Windows는 완전히 다른 유니코드 바이트 시퀀스를 마치 동일한 파일인 것처럼 +취급하여 파일 시스템의 실제 상태를 왜곡합니다. + +예를 들어 `À.txt`와 `à.txt`는 고유한 유니코드 이름이지만, Windows는 비논리적으로 +이를 동일하게 취급하는 반면 SnapRAID는 이들의 진정한 차이를 보존합니다. + +이 제한은 Windows의 일관성 없는 유니코드 파일 이름 처리와 대소문자를 구분하지 않는 +별칭 지정 고집으로 인해 발생합니다. Windows의 대소문자 폴딩으로 인한 불일치를 +방지하려면 구성 경로 및 필터의 비ASCII 문자에 대해 항상 정확한 대소문자를 +지정하십시오. + 17 번역 (TRANSLATION) =================== diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1 index d49b9fd7..1e0722c1 100644 --- a/doc/snapraid-pl.1 +++ b/doc/snapraid-pl.1 @@ -2329,6 +2329,26 @@ Aby SnapRAID rozpoznał takie zmiany, zaktualizuj znacznik czasu modyfikacji pliku (na przykład za pomocą narzędzia \[dq]touch\[dq]). W przeciwnym razie różnica zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego \[dq]scrub\[dq] lub \[dq]check\[dq]. +.SS Dopasowywanie wielkości liter znaków spoza ASCII w systemie Windows +SnapRAID używa standardowego, przewidywalnego kodowania UTF\-8 na wszystkich +platformach, ograniczając dopasowywanie bez uwzględniania wielkości liter do +znaków ASCII. +.PP +Systemy plików Windows cierpią z powodu przestarzałego projektu narzucania +braku rozróżniania wielkości liter w nazwach plików Unicode za pomocą +arbitralnych, zależnych od systemu tabel składania znaków (folding tables). +W rezultacie Windows zaciera rzeczywistość systemu plików, traktując zupełnie +różne sekwencje bajtów Unicode tak, jakby były tym samym plikiem. +.PP +Na przykład \`À.txt\` i \`à.txt\` to odrębne nazwy Unicode, a jednak Windows +nielogicznie traktuje je jako identyczne, podczas gdy SnapRAID zachowuje ich +rzeczywiste rozróżnienie. +.PP +Ograniczenie to wynika z niespójnej obsługi nazw plików Unicode przez system +Windows oraz jego uporczywego stosowania aliasów bez uwzględniania wielkości +liter. Aby zapobiec rozbieżnościom wynikającym ze składania znaków przez +Windows, zawsze podawaj dokładną wielkość liter w przypadku znaków spoza ASCII +w ścieżkach konfiguracyjnych i filtrach. .SH TłUMACZENIE (TRANSLATION) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. diff --git a/doc/snapraid-pl.d b/doc/snapraid-pl.d index 14d5d730..b851fc59 100644 --- a/doc/snapraid-pl.d +++ b/doc/snapraid-pl.d @@ -1829,6 +1829,27 @@ Znane problemy (Known Issues) zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego "scrub" lub "check". + Dopasowywanie wielkości liter znaków spoza ASCII w systemie Windows + SnapRAID używa standardowego, przewidywalnego kodowania UTF-8 na wszystkich + platformach, ograniczając dopasowywanie bez uwzględniania wielkości liter do + znaków ASCII. + + Systemy plików Windows cierpią z powodu przestarzałego projektu narzucania + braku rozróżniania wielkości liter w nazwach plików Unicode za pomocą + arbitralnych, zależnych od systemu tabel składania znaków (folding tables). + W rezultacie Windows zaciera rzeczywistość systemu plików, traktując zupełnie + różne sekwencje bajtów Unicode tak, jakby były tym samym plikiem. + + Na przykład `À.txt` i `à.txt` to odrębne nazwy Unicode, a jednak Windows + nielogicznie traktuje je jako identyczne, podczas gdy SnapRAID zachowuje ich + rzeczywiste rozróżnienie. + + Ograniczenie to wynika z niespójnej obsługi nazw plików Unicode przez system + Windows oraz jego uporczywego stosowania aliasów bez uwzględniania wielkości + liter. Aby zapobiec rozbieżnościom wynikającym ze składania znaków przez + Windows, zawsze podawaj dokładną wielkość liter w przypadku znaków spoza ASCII + w ścieżkach konfiguracyjnych i filtrach. + Tłumaczenie (Translation) Ten dokument jest automatycznym tłumaczeniem angielskiej instrukcji. Wersję oficjalną stanowi oryginalny podręcznik w języku angielskim. diff --git a/doc/snapraid-pl.txt b/doc/snapraid-pl.txt index 42533df0..beacf99f 100644 --- a/doc/snapraid-pl.txt +++ b/doc/snapraid-pl.txt @@ -1968,6 +1968,29 @@ pliku (na przykład za pomocą narzędzia "touch"). W przeciwnym razie różnica zostanie wykryta dopiero jako niezgodność skrótu podczas kolejnego "scrub" lub "check". +16.5 Dopasowywanie wielkości liter znaków spoza ASCII w systemie Windows +------------------------------------------------------------------------ + +SnapRAID używa standardowego, przewidywalnego kodowania UTF-8 na wszystkich +platformach, ograniczając dopasowywanie bez uwzględniania wielkości liter do +znaków ASCII. + +Systemy plików Windows cierpią z powodu przestarzałego projektu narzucania +braku rozróżniania wielkości liter w nazwach plików Unicode za pomocą +arbitralnych, zależnych od systemu tabel składania znaków (folding tables). +W rezultacie Windows zaciera rzeczywistość systemu plików, traktując zupełnie +różne sekwencje bajtów Unicode tak, jakby były tym samym plikiem. + +Na przykład `À.txt` i `à.txt` to odrębne nazwy Unicode, a jednak Windows +nielogicznie traktuje je jako identyczne, podczas gdy SnapRAID zachowuje ich +rzeczywiste rozróżnienie. + +Ograniczenie to wynika z niespójnej obsługi nazw plików Unicode przez system +Windows oraz jego uporczywego stosowania aliasów bez uwzględniania wielkości +liter. Aby zapobiec rozbieżnościom wynikającym ze składania znaków przez +Windows, zawsze podawaj dokładną wielkość liter w przypadku znaków spoza ASCII +w ścieżkach konfiguracyjnych i filtrach. + 17 TłUMACZENIE (TRANSLATION) ============================ diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1 index c7385b00..0ba03f9f 100644 --- a/doc/snapraid-pt.1 +++ b/doc/snapraid-pt.1 @@ -2367,6 +2367,26 @@ Para garantir que o SnapRAID reconheça essas alterações, atualize o carimbo de data/hora de modificação do arquivo (por exemplo, com o utilitário \[dq]touch\[dq]). Caso contrário, a diferença só será detectada como uma incompatibilidade de hash durante um \[dq]scrub\[dq] ou \[dq]check\[dq] subsequente. +.SS Correspondência de maiúsculas/minúsculas não\-ASCII no Windows +O SnapRAID utiliza codificação UTF\-8 padrão e previsível em todas as plataformas, +limitando a correspondência insensível a maiúsculas e minúsculas a caracteres +ASCII. +.PP +Os sistemas de arquivos do Windows sofrem com o design legado de forçar a +insensibilidade a maiúsculas e minúsculas em nomes de arquivo Unicode por meio +de tabelas de conversão arbitrárias e dependentes do sistema. Consequentemente, +o Windows oculta a realidade do sistema de arquivos ao tratar sequências de bytes +Unicode completamente diferentes como se fossem o mesmo arquivo. +.PP +Por exemplo, \`À.txt\` e \`à.txt\` são nomes Unicode distintos, mas o Windows os +trata ilogicamente como idênticos, enquanto o SnapRAID preserva sua verdadeira +distinção. +.PP +Essa limitação é causada pelo tratamento inconsistente de nomes de arquivo +Unicode pelo Windows e por sua insistência no uso de aliases sem diferenciação de +maiúsculas/minúsculas. Para evitar discrepâncias decorrentes da conversão do +Windows, sempre especifique a combinação exata de maiúsculas e minúsculas para +caracteres não\-ASCII em caminhos de configuração e filtros. .SH TRADUçãO (TRANSLATION) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. diff --git a/doc/snapraid-pt.d b/doc/snapraid-pt.d index cd57e933..748d5fe3 100644 --- a/doc/snapraid-pt.d +++ b/doc/snapraid-pt.d @@ -1867,6 +1867,27 @@ Problemas Conhecidos (Known Issues) Caso contrário, a diferença só será detectada como uma incompatibilidade de hash durante um "scrub" ou "check" subsequente. + Correspondência de maiúsculas/minúsculas não-ASCII no Windows + O SnapRAID utiliza codificação UTF-8 padrão e previsível em todas as plataformas, + limitando a correspondência insensível a maiúsculas e minúsculas a caracteres + ASCII. + + Os sistemas de arquivos do Windows sofrem com o design legado de forçar a + insensibilidade a maiúsculas e minúsculas em nomes de arquivo Unicode por meio + de tabelas de conversão arbitrárias e dependentes do sistema. Consequentemente, + o Windows oculta a realidade do sistema de arquivos ao tratar sequências de bytes + Unicode completamente diferentes como se fossem o mesmo arquivo. + + Por exemplo, `À.txt` e `à.txt` são nomes Unicode distintos, mas o Windows os + trata ilogicamente como idênticos, enquanto o SnapRAID preserva sua verdadeira + distinção. + + Essa limitação é causada pelo tratamento inconsistente de nomes de arquivo + Unicode pelo Windows e por sua insistência no uso de aliases sem diferenciação de + maiúsculas/minúsculas. Para evitar discrepâncias decorrentes da conversão do + Windows, sempre especifique a combinação exata de maiúsculas e minúsculas para + caracteres não-ASCII em caminhos de configuração e filtros. + Tradução (Translation) Este documento é uma tradução automática do manual em inglês. Consulte o manual em inglês para a versão oficial. diff --git a/doc/snapraid-pt.txt b/doc/snapraid-pt.txt index a7705627..7779ae4d 100644 --- a/doc/snapraid-pt.txt +++ b/doc/snapraid-pt.txt @@ -2006,6 +2006,29 @@ de data/hora de modificação do arquivo (por exemplo, com o utilitário "touch" Caso contrário, a diferença só será detectada como uma incompatibilidade de hash durante um "scrub" ou "check" subsequente. +16.5 Correspondência de maiúsculas/minúsculas não-ASCII no Windows +------------------------------------------------------------------ + +O SnapRAID utiliza codificação UTF-8 padrão e previsível em todas as plataformas, +limitando a correspondência insensível a maiúsculas e minúsculas a caracteres +ASCII. + +Os sistemas de arquivos do Windows sofrem com o design legado de forçar a +insensibilidade a maiúsculas e minúsculas em nomes de arquivo Unicode por meio +de tabelas de conversão arbitrárias e dependentes do sistema. Consequentemente, +o Windows oculta a realidade do sistema de arquivos ao tratar sequências de bytes +Unicode completamente diferentes como se fossem o mesmo arquivo. + +Por exemplo, `À.txt` e `à.txt` são nomes Unicode distintos, mas o Windows os +trata ilogicamente como idênticos, enquanto o SnapRAID preserva sua verdadeira +distinção. + +Essa limitação é causada pelo tratamento inconsistente de nomes de arquivo +Unicode pelo Windows e por sua insistência no uso de aliases sem diferenciação de +maiúsculas/minúsculas. Para evitar discrepâncias decorrentes da conversão do +Windows, sempre especifique a combinação exata de maiúsculas e minúsculas para +caracteres não-ASCII em caminhos de configuração e filtros. + 17 TRADUçãO (TRANSLATION) ========================= diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1 index f7f80911..dc7f4863 100644 --- a/doc/snapraid-ro.1 +++ b/doc/snapraid-ro.1 @@ -2326,6 +2326,26 @@ Pentru a vă asigura că SnapRAID recunoaște astfel de modificări, actualizaț marcajul temporal de modificare al fișierului (de exemplu, cu utilitarul \[dq]touch\[dq]). În caz contrar, diferența va fi detectată doar ca o neconcordanță de hash în timpul unui \[dq]scrub\[dq] sau \[dq]check\[dq] ulterior. +.SS Potrivirea majusculelor/minusculelor non\-ASCII în Windows +SnapRAID utilizează codificarea UTF\-8 standard și previzibilă pe toate +platformele, limitând potrivirea fără distincție între majuscule și minuscule +la caracterele ASCII. +.PP +Sistemele de fișiere Windows suferă din cauza designului moștenit de a impune +insensibilitatea la majuscule/minuscule asupra numelor de fișiere Unicode prin +tabele arbitrare de conversie dependente de sistem. În consecință, Windows +maschează realitatea sistemului de fișiere tratând secvențe de octeți Unicode +complet diferite ca și cum ar fi același fișier. +.PP +De exemplu, \`À.txt\` și \`à.txt\` sunt nume Unicode distincte, însă Windows le +tratează în mod ilogic ca fiind identice, în timp ce SnapRAID le păstrează +distincția reală. +.PP +Această limitare este cauzată de gestionarea incoerentă a numelor de fișiere +Unicode de către Windows și de insistența sa asupra aplicării de aliasuri fără +distincție între majuscule și minuscule. Pentru a preveni discrepanțele apărute +din conversia efectuată de Windows, specificați întotdeauna forma exactă a +caracterelor non\-ASCII în căile de configurare și filtre. .SH TRADUCERE (TRANSLATION) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. diff --git a/doc/snapraid-ro.d b/doc/snapraid-ro.d index 8675aaee..8088688c 100644 --- a/doc/snapraid-ro.d +++ b/doc/snapraid-ro.d @@ -1826,6 +1826,27 @@ Probleme Cunoscute (Known Issues) "touch"). În caz contrar, diferența va fi detectată doar ca o neconcordanță de hash în timpul unui "scrub" sau "check" ulterior. + Potrivirea majusculelor/minusculelor non-ASCII în Windows + SnapRAID utilizează codificarea UTF-8 standard și previzibilă pe toate + platformele, limitând potrivirea fără distincție între majuscule și minuscule + la caracterele ASCII. + + Sistemele de fișiere Windows suferă din cauza designului moștenit de a impune + insensibilitatea la majuscule/minuscule asupra numelor de fișiere Unicode prin + tabele arbitrare de conversie dependente de sistem. În consecință, Windows + maschează realitatea sistemului de fișiere tratând secvențe de octeți Unicode + complet diferite ca și cum ar fi același fișier. + + De exemplu, `À.txt` și `à.txt` sunt nume Unicode distincte, însă Windows le + tratează în mod ilogic ca fiind identice, în timp ce SnapRAID le păstrează + distincția reală. + + Această limitare este cauzată de gestionarea incoerentă a numelor de fișiere + Unicode de către Windows și de insistența sa asupra aplicării de aliasuri fără + distincție între majuscule și minuscule. Pentru a preveni discrepanțele apărute + din conversia efectuată de Windows, specificați întotdeauna forma exactă a + caracterelor non-ASCII în căile de configurare și filtre. + Traducere (Translation) Acest document este o traducere automată a manualului în limba engleză. Consultați manualul în limba engleză pentru versiunea oficială. diff --git a/doc/snapraid-ro.txt b/doc/snapraid-ro.txt index 9a33ec2d..073bb1ed 100644 --- a/doc/snapraid-ro.txt +++ b/doc/snapraid-ro.txt @@ -1965,6 +1965,29 @@ marcajul temporal de modificare al fișierului (de exemplu, cu utilitarul "touch"). În caz contrar, diferența va fi detectată doar ca o neconcordanță de hash în timpul unui "scrub" sau "check" ulterior. +16.5 Potrivirea majusculelor/minusculelor non-ASCII în Windows +-------------------------------------------------------------- + +SnapRAID utilizează codificarea UTF-8 standard și previzibilă pe toate +platformele, limitând potrivirea fără distincție între majuscule și minuscule +la caracterele ASCII. + +Sistemele de fișiere Windows suferă din cauza designului moștenit de a impune +insensibilitatea la majuscule/minuscule asupra numelor de fișiere Unicode prin +tabele arbitrare de conversie dependente de sistem. În consecință, Windows +maschează realitatea sistemului de fișiere tratând secvențe de octeți Unicode +complet diferite ca și cum ar fi același fișier. + +De exemplu, `À.txt` și `à.txt` sunt nume Unicode distincte, însă Windows le +tratează în mod ilogic ca fiind identice, în timp ce SnapRAID le păstrează +distincția reală. + +Această limitare este cauzată de gestionarea incoerentă a numelor de fișiere +Unicode de către Windows și de insistența sa asupra aplicării de aliasuri fără +distincție între majuscule și minuscule. Pentru a preveni discrepanțele apărute +din conversia efectuată de Windows, specificați întotdeauna forma exactă a +caracterelor non-ASCII în căile de configurare și filtre. + 17 TRADUCERE (TRANSLATION) ========================== diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1 index 747e889a..62a13b70 100644 --- a/doc/snapraid-ru.1 +++ b/doc/snapraid-ru.1 @@ -2330,6 +2330,27 @@ SnapRAID обнаруживает изменения файлов путем с метку модификации файла (например, с помощью утилиты \[dq]touch\[dq]). В противном случае различие будет обнаружено только как несоответствие хэша во время последующего \[dq]scrub\[dq] или \[dq]check\[dq]. +.SS Сопоставление регистра символов non\-ASCII в Windows +SnapRAID использует стандартную, предсказуемую кодировку UTF\-8 на всех +платформах, ограничивая нечувствительное к регистру сопоставление символами +ASCII. +.PP +Файловые системы Windows страдают от устаревшего архитектурного решения, +навязывающего нечувствительность к регистру для имен файлов Unicode с помощью +произвольных, зависящих от системы таблиц сопоставления. В результате Windows +искажает реальность файловой системы, обрабатывая совершенно разные +последовательности байтов Unicode так, как если бы они были одним и тем же +файлом. +.PP +Например, \`À.txt\` и \`à.txt\` — это разные имена Unicode, однако Windows +нелогично считает их идентичными, тогда как SnapRAID сохраняет их подлинное +различие. +.PP +Это ограничение вызвано непоследовательной обработкой имен файлов Unicode в +Windows и ее упорным стремлением к псевдонимизации без учета регистра. Чтобы +предотвратить расхождения, возникающие из\-за преобразования регистра в Windows, +всегда указывайте точный регистр для любых символов non\-ASCII в путях +конфигурации и фильтрах. .SH Перевод (TRANSLATION) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d index 3f27c5e0..032960f5 100644 --- a/doc/snapraid-ru.d +++ b/doc/snapraid-ru.d @@ -1832,6 +1832,28 @@ Name{number} случае различие будет обнаружено только как несоответствие хэша во время последующего "scrub" или "check". + Сопоставление регистра символов non-ASCII в Windows + SnapRAID использует стандартную, предсказуемую кодировку UTF-8 на всех + платформах, ограничивая нечувствительное к регистру сопоставление символами + ASCII. + + Файловые системы Windows страдают от устаревшего архитектурного решения, + навязывающего нечувствительность к регистру для имен файлов Unicode с помощью + произвольных, зависящих от системы таблиц сопоставления. В результате Windows + искажает реальность файловой системы, обрабатывая совершенно разные + последовательности байтов Unicode так, как если бы они были одним и тем же + файлом. + + Например, `À.txt` и `à.txt` — это разные имена Unicode, однако Windows + нелогично считает их идентичными, тогда как SnapRAID сохраняет их подлинное + различие. + + Это ограничение вызвано непоследовательной обработкой имен файлов Unicode в + Windows и ее упорным стремлением к псевдонимизации без учета регистра. Чтобы + предотвратить расхождения, возникающие из-за преобразования регистра в Windows, + всегда указывайте точный регистр для любых символов non-ASCII в путях + конфигурации и фильтрах. + Перевод (Translation) Этот документ является автоматическим переводом английского руководства. Обратитесь к английскому руководству за официальной версией. diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt index fa140dee..d5f0dddd 100644 --- a/doc/snapraid-ru.txt +++ b/doc/snapraid-ru.txt @@ -1971,6 +1971,30 @@ SnapRAID обнаруживает изменения файлов путем с случае различие будет обнаружено только как несоответствие хэша во время последующего "scrub" или "check". +16.5 Сопоставление регистра символов non-ASCII в Windows +-------------------------------------------------------- + +SnapRAID использует стандартную, предсказуемую кодировку UTF-8 на всех +платформах, ограничивая нечувствительное к регистру сопоставление символами +ASCII. + +Файловые системы Windows страдают от устаревшего архитектурного решения, +навязывающего нечувствительность к регистру для имен файлов Unicode с помощью +произвольных, зависящих от системы таблиц сопоставления. В результате Windows +искажает реальность файловой системы, обрабатывая совершенно разные +последовательности байтов Unicode так, как если бы они были одним и тем же +файлом. + +Например, `À.txt` и `à.txt` — это разные имена Unicode, однако Windows +нелогично считает их идентичными, тогда как SnapRAID сохраняет их подлинное +различие. + +Это ограничение вызвано непоследовательной обработкой имен файлов Unicode в +Windows и ее упорным стремлением к псевдонимизации без учета регистра. Чтобы +предотвратить расхождения, возникающие из-за преобразования регистра в Windows, +всегда указывайте точный регистр для любых символов non-ASCII в путях +конфигурации и фильтрах. + 17 Перевод (TRANSLATION) ======================== diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1 index 664c6e1c..c14dc88f 100644 --- a/doc/snapraid-sv.1 +++ b/doc/snapraid-sv.1 @@ -2327,6 +2327,22 @@ För att säkerställa att SnapRAID känner igen sådana ändringar, uppdatera filens ändringstidsstämpel (till exempel med verktyget \[dq]touch\[dq]). Annars kommer skillnaden endast att upptäckas som en hash\-avvikelse under en efterföljande \[dq]scrub\[dq] eller \[dq]check\[dq]. +.SS Icke\-ASCII skiftlägesmatchning i Windows +SnapRAID använder standardiserad, förutsägbar UTF\-8\-kodning på alla plattformar +och begränsar skiftlägesokänslig matchning till ASCII\-tecken. +.PP +Windows filsystem lider av den föråldrade designen att tvinga fram +skiftlägesokänslighet över Unicode\-filnamn via godtyckliga, systemberoende +konverteringstabeller. Följaktligen döljer Windows filsystemets verklighet genom +att behandla helt olika Unicode\-bytesekvenser som om de vore samma fil. +.PP +Till exempel är \`À.txt\` och \`à.txt\` distinkta Unicode\-namn, men Windows behandlar +dem ologiskt som identiska, medan SnapRAID bevarar deras verkliga åtskillnad. +.PP +Denna begränsning orsakas av Windows inkonsekventa hantering av Unicode\-filnamn +och dess insisterande på skiftlägesokänslig aliasning. För att förhindra +avvikelser till följd av Windows skiftlägesvikning, ange alltid det exakta +skiftläget för eventuella icke\-ASCII\-tecken i konfigurationssökvägar och filter. .SH ÖVERSäTTNING (TRANSLATION) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. diff --git a/doc/snapraid-sv.d b/doc/snapraid-sv.d index 0d7c3655..da010728 100644 --- a/doc/snapraid-sv.d +++ b/doc/snapraid-sv.d @@ -1827,6 +1827,23 @@ Kända problem (Known Issues) kommer skillnaden endast att upptäckas som en hash-avvikelse under en efterföljande "scrub" eller "check". + Icke-ASCII skiftlägesmatchning i Windows + SnapRAID använder standardiserad, förutsägbar UTF-8-kodning på alla plattformar + och begränsar skiftlägesokänslig matchning till ASCII-tecken. + + Windows filsystem lider av den föråldrade designen att tvinga fram + skiftlägesokänslighet över Unicode-filnamn via godtyckliga, systemberoende + konverteringstabeller. Följaktligen döljer Windows filsystemets verklighet genom + att behandla helt olika Unicode-bytesekvenser som om de vore samma fil. + + Till exempel är `À.txt` och `à.txt` distinkta Unicode-namn, men Windows behandlar + dem ologiskt som identiska, medan SnapRAID bevarar deras verkliga åtskillnad. + + Denna begränsning orsakas av Windows inkonsekventa hantering av Unicode-filnamn + och dess insisterande på skiftlägesokänslig aliasning. För att förhindra + avvikelser till följd av Windows skiftlägesvikning, ange alltid det exakta + skiftläget för eventuella icke-ASCII-tecken i konfigurationssökvägar och filter. + Översättning (Translation) Detta dokument är en automatisk översättning av den engelska manualen. Se den engelska manualen för den officiella versionen. diff --git a/doc/snapraid-sv.txt b/doc/snapraid-sv.txt index a3ba946a..d56592ea 100644 --- a/doc/snapraid-sv.txt +++ b/doc/snapraid-sv.txt @@ -1966,6 +1966,25 @@ filens ändringstidsstämpel (till exempel med verktyget "touch"). Annars kommer skillnaden endast att upptäckas som en hash-avvikelse under en efterföljande "scrub" eller "check". +16.5 Icke-ASCII skiftlägesmatchning i Windows +--------------------------------------------- + +SnapRAID använder standardiserad, förutsägbar UTF-8-kodning på alla plattformar +och begränsar skiftlägesokänslig matchning till ASCII-tecken. + +Windows filsystem lider av den föråldrade designen att tvinga fram +skiftlägesokänslighet över Unicode-filnamn via godtyckliga, systemberoende +konverteringstabeller. Följaktligen döljer Windows filsystemets verklighet genom +att behandla helt olika Unicode-bytesekvenser som om de vore samma fil. + +Till exempel är `À.txt` och `à.txt` distinkta Unicode-namn, men Windows behandlar +dem ologiskt som identiska, medan SnapRAID bevarar deras verkliga åtskillnad. + +Denna begränsning orsakas av Windows inkonsekventa hantering av Unicode-filnamn +och dess insisterande på skiftlägesokänslig aliasning. För att förhindra +avvikelser till följd av Windows skiftlägesvikning, ange alltid det exakta +skiftläget för eventuella icke-ASCII-tecken i konfigurationssökvägar och filter. + 17 ÖVERSäTTNING (TRANSLATION) ============================= diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1 index 1f9898dc..1eb60c23 100644 --- a/doc/snapraid-uk.1 +++ b/doc/snapraid-uk.1 @@ -2531,6 +2531,24 @@ SnapRAID виявляє модифікації файлів шляхом пор модифікації файлу (наприклад, за допомогою утиліти \[dq]touch\[dq]). В іншому випадку різниця буде виявлена лише як невідповідність хешу під час наступного \[dq]scrub\[dq] або \[dq]check\[dq]. +.SS Зіставлення регістру символів non\-ASCII у Windows +SnapRAID використовує стандартне, передбачуване кодування UTF\-8 на всіх +платформах, обмежуючи нечутливе до регістру зіставлення символами ASCII. +.PP +Файлові системи Windows страждають від застарілого архітектурного рішення, +що нав\'язує нечутливість до регістру для імен файлів Unicode за допомогою +довільних, залежних від системи таблиць перетворення. Як наслідок, Windows +приховує реальність файлової системи, обробляючи абсолютно різні +послідовності байтів Unicode так, ніби це один і той самий файл. +.PP +Наприклад, \`À.txt\` та \`à.txt\` є різними іменами Unicode, але Windows нелогічно +вважає їх ідентичними, тоді як SnapRAID зберігає їхню справжню відмінність. +.PP +Це обмеження спричинене непослідовною обробкою імен файлів Unicode у Windows +та її наполегливим використанням псевдонімів без урахування регістру. Щоб +запобігти розбіжностям через зведення регістру у Windows, завжди вказуйте +точний регістр для будь\-яких символів non\-ASCII у шляхах конфігурації та +фільтрах. .SH Переклад (TRANSLATION) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d index 887ba8eb..9a637bd9 100644 --- a/doc/snapraid-uk.d +++ b/doc/snapraid-uk.d @@ -2019,6 +2019,25 @@ Name{number} випадку різниця буде виявлена лише як невідповідність хешу під час наступного "scrub" або "check". + Зіставлення регістру символів non-ASCII у Windows + SnapRAID використовує стандартне, передбачуване кодування UTF-8 на всіх + платформах, обмежуючи нечутливе до регістру зіставлення символами ASCII. + + Файлові системи Windows страждають від застарілого архітектурного рішення, + що нав'язує нечутливість до регістру для імен файлів Unicode за допомогою + довільних, залежних від системи таблиць перетворення. Як наслідок, Windows + приховує реальність файлової системи, обробляючи абсолютно різні + послідовності байтів Unicode так, ніби це один і той самий файл. + + Наприклад, `À.txt` та `à.txt` є різними іменами Unicode, але Windows нелогічно + вважає їх ідентичними, тоді як SnapRAID зберігає їхню справжню відмінність. + + Це обмеження спричинене непослідовною обробкою імен файлів Unicode у Windows + та її наполегливим використанням псевдонімів без урахування регістру. Щоб + запобігти розбіжностям через зведення регістру у Windows, завжди вказуйте + точний регістр для будь-яких символів non-ASCII у шляхах конфігурації та + фільтрах. + Переклад (Translation) Цей документ є автоматичним перекладом англійського посібника. Зверніться до англійського посібника для отримання офіційної версії. diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt index 23c67227..f99ac86d 100644 --- a/doc/snapraid-uk.txt +++ b/doc/snapraid-uk.txt @@ -2158,6 +2158,27 @@ SnapRAID виявляє модифікації файлів шляхом пор випадку різниця буде виявлена лише як невідповідність хешу під час наступного "scrub" або "check". +16.5 Зіставлення регістру символів non-ASCII у Windows +------------------------------------------------------ + +SnapRAID використовує стандартне, передбачуване кодування UTF-8 на всіх +платформах, обмежуючи нечутливе до регістру зіставлення символами ASCII. + +Файлові системи Windows страждають від застарілого архітектурного рішення, +що нав'язує нечутливість до регістру для імен файлів Unicode за допомогою +довільних, залежних від системи таблиць перетворення. Як наслідок, Windows +приховує реальність файлової системи, обробляючи абсолютно різні +послідовності байтів Unicode так, ніби це один і той самий файл. + +Наприклад, `À.txt` та `à.txt` є різними іменами Unicode, але Windows нелогічно +вважає їх ідентичними, тоді як SnapRAID зберігає їхню справжню відмінність. + +Це обмеження спричинене непослідовною обробкою імен файлів Unicode у Windows +та її наполегливим використанням псевдонімів без урахування регістру. Щоб +запобігти розбіжностям через зведення регістру у Windows, завжди вказуйте +точний регістр для будь-яких символів non-ASCII у шляхах конфігурації та +фільтрах. + 17 Переклад (TRANSLATION) ========================= diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1 index b291c1a8..9429e5a0 100644 --- a/doc/snapraid-zh.1 +++ b/doc/snapraid-zh.1 @@ -2092,6 +2092,20 @@ SnapRAID 通过比较文件大小和修改时间戳(mtime)来检测文件修 .PP 为确保 SnapRAID 识别此类更改,请更新文件的修改时间戳(例如使用 “touch” 实用程序)。 否则,该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 +.SS Windows 非 ASCII 大小写匹配 +SnapRAID 在所有平台上均使用标准且可预测的 UTF\-8 编码,仅对 ASCII 字符进行 +不区分大小写的匹配。 +.PP +Windows 文件系统受到遗留设计的困扰,即通过任意的、依赖于系统的大小写折叠表在 +Unicode 文件名之间强制实行不区分大小写。因此,Windows 掩盖了文件系统的真实情况, +将完全不同的 Unicode 字节序列视为同一个文件。 +.PP +例如,\`À.txt\` 和 \`à.txt\` 是不同的 Unicode 名称,但 Windows 却不合逻辑地将它们 +视为相同文件,而 SnapRAID 则保留了它们的真实区别。 +.PP +该限制是由于 Windows 对 Unicode 文件名的不一致处理及其对不区分大小写别名的 +执着所致。为了防止因 Windows 的大小写折叠而产生差异,请在配置路径和过滤器中 +始终为非 ASCII 字符指定准确的大小写。 .SH 翻译 (TRANSLATION) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d index bbd324a3..cce57683 100644 --- a/doc/snapraid-zh.d +++ b/doc/snapraid-zh.d @@ -1592,6 +1592,21 @@ Name{number} 为确保 SnapRAID 识别此类更改,请更新文件的修改时间戳(例如使用 “touch” 实用程序)。 否则,该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 + Windows 非 ASCII 大小写匹配 + SnapRAID 在所有平台上均使用标准且可预测的 UTF-8 编码,仅对 ASCII 字符进行 + 不区分大小写的匹配。 + + Windows 文件系统受到遗留设计的困扰,即通过任意的、依赖于系统的大小写折叠表在 + Unicode 文件名之间强制实行不区分大小写。因此,Windows 掩盖了文件系统的真实情况, + 将完全不同的 Unicode 字节序列视为同一个文件。 + + 例如,`À.txt` 和 `à.txt` 是不同的 Unicode 名称,但 Windows 却不合逻辑地将它们 + 视为相同文件,而 SnapRAID 则保留了它们的真实区别。 + + 该限制是由于 Windows 对 Unicode 文件名的不一致处理及其对不区分大小写别名的 + 执着所致。为了防止因 Windows 的大小写折叠而产生差异,请在配置路径和过滤器中 + 始终为非 ASCII 字符指定准确的大小写。 + 翻译 (Translation) 本文档是英文手册的自动翻译。 请参阅英文手册以获取权威版本。 diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt index fe978dcf..e9573688 100644 --- a/doc/snapraid-zh.txt +++ b/doc/snapraid-zh.txt @@ -1731,6 +1731,23 @@ SnapRAID 通过比较文件大小和修改时间戳(mtime)来检测文件修 为确保 SnapRAID 识别此类更改,请更新文件的修改时间戳(例如使用 “touch” 实用程序)。 否则,该差异仅在后续的 “scrub” 或 “check” 期间作为哈希不匹配被检测到。 +16.5 Windows 非 ASCII 大小写匹配 +-------------------------- + +SnapRAID 在所有平台上均使用标准且可预测的 UTF-8 编码,仅对 ASCII 字符进行 +不区分大小写的匹配。 + +Windows 文件系统受到遗留设计的困扰,即通过任意的、依赖于系统的大小写折叠表在 +Unicode 文件名之间强制实行不区分大小写。因此,Windows 掩盖了文件系统的真实情况, +将完全不同的 Unicode 字节序列视为同一个文件。 + +例如,`À.txt` 和 `à.txt` 是不同的 Unicode 名称,但 Windows 却不合逻辑地将它们 +视为相同文件,而 SnapRAID 则保留了它们的真实区别。 + +该限制是由于 Windows 对 Unicode 文件名的不一致处理及其对不区分大小写别名的 +执着所致。为了防止因 Windows 的大小写折叠而产生差异,请在配置路径和过滤器中 +始终为非 ASCII 字符指定准确的大小写。 + 17 翻译 (TRANSLATION) =================== diff --git a/doc/snapraid.1 b/doc/snapraid.1 index fffc8192..af8481cf 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -2333,6 +2333,24 @@ To ensure SnapRAID recognizes such changes, update the file\'s modification timestamp (for example, with the \[dq]touch\[dq] utility). Otherwise, the difference will only be detected as a hash mismatch during a subsequent \[dq]scrub\[dq] or \[dq]check\[dq]. +.SS Windows non\-ASCII case matching +SnapRAID uses standard, predictable UTF\-8 encoding across all platforms, +limiting case\-insensitive matching to ASCII characters. +.PP +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. +.PP +For example, \`À.txt\` and \`à.txt\` are distinct Unicode names, yet Windows +illogically treats them as identical, while SnapRAID preserves their true +distinction. +.PP +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. .SH COPYRIGHT This file is Copyright (C) 2026 Andrea Mazzoleni .SH SEE ALSO diff --git a/doc/snapraid.d b/doc/snapraid.d index 00b92345..604b5444 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -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 diff --git a/doc/snapraid.txt b/doc/snapraid.txt index e5b63aac..8c8fe892 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1972,6 +1972,27 @@ modification timestamp (for example, with the "touch" utility). Otherwise, the difference will only be detected as a hash mismatch during a subsequent "scrub" or "check". +16.5 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. + 17 COPYRIGHT ============