From 6dd1f6c27a5aef760de70022964cca657ebe92e2 Mon Sep 17 00:00:00 2001
From: Andrea Mazzoleni <amadvance@gmail.com>
Date: Mon, 7 Sep 2026 14:00:27 +0200
Subject: [PATCH] Document risk of false success after partial fix recovery

---
 doc/snapraid-de.1   | 21 +++++++++++++++++++++
 doc/snapraid-de.d   | 22 ++++++++++++++++++++++
 doc/snapraid-de.txt | 24 ++++++++++++++++++++++++
 doc/snapraid-es.1   | 19 +++++++++++++++++++
 doc/snapraid-es.d   | 20 ++++++++++++++++++++
 doc/snapraid-es.txt | 22 ++++++++++++++++++++++
 doc/snapraid-fr.1   | 21 +++++++++++++++++++++
 doc/snapraid-fr.d   | 22 ++++++++++++++++++++++
 doc/snapraid-fr.txt | 24 ++++++++++++++++++++++++
 doc/snapraid-it.1   | 19 +++++++++++++++++++
 doc/snapraid-it.d   | 20 ++++++++++++++++++++
 doc/snapraid-it.txt | 22 ++++++++++++++++++++++
 doc/snapraid-ja.1   | 19 +++++++++++++++++++
 doc/snapraid-ja.d   | 20 ++++++++++++++++++++
 doc/snapraid-ja.txt | 22 ++++++++++++++++++++++
 doc/snapraid-ko.1   | 17 +++++++++++++++++
 doc/snapraid-ko.d   | 18 ++++++++++++++++++
 doc/snapraid-ko.txt | 20 ++++++++++++++++++++
 doc/snapraid-pl.1   | 20 ++++++++++++++++++++
 doc/snapraid-pl.d   | 21 +++++++++++++++++++++
 doc/snapraid-pl.txt | 23 +++++++++++++++++++++++
 doc/snapraid-pt.1   | 19 +++++++++++++++++++
 doc/snapraid-pt.d   | 20 ++++++++++++++++++++
 doc/snapraid-pt.txt | 22 ++++++++++++++++++++++
 doc/snapraid-ro.1   | 19 +++++++++++++++++++
 doc/snapraid-ro.d   | 20 ++++++++++++++++++++
 doc/snapraid-ro.txt | 22 ++++++++++++++++++++++
 doc/snapraid-ru.1   | 19 +++++++++++++++++++
 doc/snapraid-ru.d   | 20 ++++++++++++++++++++
 doc/snapraid-ru.txt | 22 ++++++++++++++++++++++
 doc/snapraid-sv.1   | 19 +++++++++++++++++++
 doc/snapraid-sv.d   | 20 ++++++++++++++++++++
 doc/snapraid-sv.txt | 22 ++++++++++++++++++++++
 doc/snapraid-uk.1   | 19 +++++++++++++++++++
 doc/snapraid-uk.d   | 20 ++++++++++++++++++++
 doc/snapraid-uk.txt | 22 ++++++++++++++++++++++
 doc/snapraid-zh.1   | 14 ++++++++++++++
 doc/snapraid-zh.d   | 15 +++++++++++++++
 doc/snapraid-zh.txt | 17 +++++++++++++++++
 doc/snapraid.1      | 19 +++++++++++++++++++
 doc/snapraid.d      | 20 ++++++++++++++++++++
 doc/snapraid.txt    | 22 ++++++++++++++++++++++
 42 files changed, 848 insertions(+)

diff --git a/doc/snapraid-de.1 b/doc/snapraid-de.1
index 428f2f63..829a6b9f 100644
--- a/doc/snapraid-de.1
+++ b/doc/snapraid-de.1
@@ -2508,6 +2508,27 @@ Vermeiden Sie die Verwendung der Erweiterung \`.unrecoverable\` für reguläre
 Dateien und stellen Sie sicher, dass \`exclude *.unrecoverable\` in Ihrer
 Konfiguration enthalten ist, um zu verhindern, dass solche Dateien im
 Paritätsdatensatz erfasst werden.
+.SS Wiederherstellung mit partiellem Fix 
+Wenn \`fix\` mit \`\-S, \-\-start\` oder \`\-B, \-\-count\` eingeschränkt wird,
+arbeitet SnapRAID nur auf den ausgewählten Blöcken und führt weder eine
+Finalisierung auf Dateiebene noch eine Quarantäne durch.
+.PP
+Wenn die Wiederherstellung Best\-Effort\-Daten erzeugt, bei denen nicht
+nachgewiesen werden kann, dass sie den aktuellen Inhalt darstellen, können
+solche Blöcke dennoch unter dem normalen Dateinamen geschrieben werden. Die mit
+diesen wiederhergestellten Blöcken verbundene Ungewissheit bleibt nach Beendigung
+des Befehls nicht erhalten.
+.PP
+Infolgedessen behandelt ein späterer \`fix\` diese lesbaren Blöcke als gültige
+Dateidaten und versucht nicht, sie erneut wiederherzustellen. Dies kann dazu
+führen, dass eine spätere Wiederherstellung Erfolg meldet, während die Datei
+weiterhin unvollständige oder veraltete Daten enthält.
+.PP
+Die Optionen \`\-S\` und \`\-B\` sind nur für die fortgeschrittene manuelle
+Wiederherstellung gedacht, typischerweise nachdem ein normaler \`fix\`
+fehlgeschlagen ist. Wenn ein partieller \`fix\` nicht wiederherstellbare Daten
+meldet, entfernen oder benennen Sie die betroffenen Dateien um, bevor Sie eine
+weitere Wiederherstellung versuchen, oder überprüfen Sie deren Inhalt manuell.
 .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 28e3f141..7abb53db 100644
--- a/doc/snapraid-de.d
+++ b/doc/snapraid-de.d
@@ -1999,6 +1999,28 @@ Bekannte Probleme (Known Issues)
 	Konfiguration enthalten ist, um zu verhindern, dass solche Dateien im
 	Paritätsdatensatz erfasst werden.
 
+  Wiederherstellung mit partiellem Fix
+	Wenn `fix` mit `-S, --start` oder `-B, --count` eingeschränkt wird,
+	arbeitet SnapRAID nur auf den ausgewählten Blöcken und führt weder eine
+	Finalisierung auf Dateiebene noch eine Quarantäne durch.
+
+	Wenn die Wiederherstellung Best-Effort-Daten erzeugt, bei denen nicht
+	nachgewiesen werden kann, dass sie den aktuellen Inhalt darstellen, können
+	solche Blöcke dennoch unter dem normalen Dateinamen geschrieben werden. Die mit
+	diesen wiederhergestellten Blöcken verbundene Ungewissheit bleibt nach Beendigung
+	des Befehls nicht erhalten.
+
+	Infolgedessen behandelt ein späterer `fix` diese lesbaren Blöcke als gültige
+	Dateidaten und versucht nicht, sie erneut wiederherzustellen. Dies kann dazu
+	führen, dass eine spätere Wiederherstellung Erfolg meldet, während die Datei
+	weiterhin unvollständige oder veraltete Daten enthält.
+
+	Die Optionen `-S` und `-B` sind nur für die fortgeschrittene manuelle
+	Wiederherstellung gedacht, typischerweise nachdem ein normaler `fix`
+	fehlgeschlagen ist. Wenn ein partieller `fix` nicht wiederherstellbare Daten
+	meldet, entfernen oder benennen Sie die betroffenen Dateien um, bevor Sie eine
+	weitere Wiederherstellung versuchen, oder überprüfen Sie deren Inhalt manuell.
+
 Ü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 f97a3852..de260118 100644
--- a/doc/snapraid-de.txt
+++ b/doc/snapraid-de.txt
@@ -2142,6 +2142,30 @@ Dateien und stellen Sie sicher, dass `exclude *.unrecoverable` in Ihrer
 Konfiguration enthalten ist, um zu verhindern, dass solche Dateien im
 Paritätsdatensatz erfasst werden.
 
+16.7 Wiederherstellung mit partiellem Fix
+-----------------------------------------
+
+Wenn `fix` mit `-S, --start` oder `-B, --count` eingeschränkt wird,
+arbeitet SnapRAID nur auf den ausgewählten Blöcken und führt weder eine
+Finalisierung auf Dateiebene noch eine Quarantäne durch.
+
+Wenn die Wiederherstellung Best-Effort-Daten erzeugt, bei denen nicht
+nachgewiesen werden kann, dass sie den aktuellen Inhalt darstellen, können
+solche Blöcke dennoch unter dem normalen Dateinamen geschrieben werden. Die mit
+diesen wiederhergestellten Blöcken verbundene Ungewissheit bleibt nach Beendigung
+des Befehls nicht erhalten.
+
+Infolgedessen behandelt ein späterer `fix` diese lesbaren Blöcke als gültige
+Dateidaten und versucht nicht, sie erneut wiederherzustellen. Dies kann dazu
+führen, dass eine spätere Wiederherstellung Erfolg meldet, während die Datei
+weiterhin unvollständige oder veraltete Daten enthält.
+
+Die Optionen `-S` und `-B` sind nur für die fortgeschrittene manuelle
+Wiederherstellung gedacht, typischerweise nachdem ein normaler `fix`
+fehlgeschlagen ist. Wenn ein partieller `fix` nicht wiederherstellbare Daten
+meldet, entfernen oder benennen Sie die betroffenen Dateien um, bevor Sie eine
+weitere Wiederherstellung versuchen, oder überprüfen Sie deren Inhalt manuell.
+
 
 17 ÜBERSETZUNG (TRANSLATION)
 ============================
diff --git a/doc/snapraid-es.1 b/doc/snapraid-es.1
index 8938850e..a1f72dc4 100644
--- a/doc/snapraid-es.1
+++ b/doc/snapraid-es.1
@@ -2459,6 +2459,25 @@ si su nombre base coincide con un archivo que se está reparando.
 Evite utilizar la extensión \`.unrecoverable\` para archivos normales y asegúrese
 de incluir \`exclude *.unrecoverable\` en su configuración para evitar que dichos
 archivos se rastreen en el conjunto de datos de paridad.
+.SS Recuperación con fix parcial 
+Cuando \`fix\` se restringe mediante \`\-S, \-\-start\` o \`\-B, \-\-count\`,
+SnapRAID opera únicamente sobre los bloques seleccionados y no realiza
+la finalización a nivel de archivo ni la cuarentena.
+.PP
+Si la recuperación produce datos de mejor esfuerzo que no pueden demostrarse
+como representativos del contenido actual, dichos bloques aún pueden escribirse
+con el nombre de archivo normal. La incertidumbre asociada con estos bloques
+recuperados no se conserva una vez finalizado el comando.
+.PP
+Como consecuencia, un \`fix\` posterior tratará estos bloques legibles como
+datos de archivo válidos y no intentará recuperarlos nuevamente. Esto puede
+hacer que una recuperación posterior informe éxito dejando datos incompletos
+o desactualizados en el archivo.
+.PP
+Las opciones \`\-S\` y \`\-B\` están destinadas únicamente a la recuperación manual
+avanzada, típicamente después de que un \`fix\` normal haya fallado. Si un \`fix\`
+parcial informa de datos no recuperables, elimine o renombre los archivos
+afectados antes de intentar otra recuperación, o verifique su contenido manualmente.
 .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 84277f3c..d3f16374 100644
--- a/doc/snapraid-es.d
+++ b/doc/snapraid-es.d
@@ -1961,6 +1961,26 @@ Problemas conocidos (Known Issues)
 	de incluir `exclude *.unrecoverable` en su configuración para evitar que dichos
 	archivos se rastreen en el conjunto de datos de paridad.
 
+  Recuperación con fix parcial
+	Cuando `fix` se restringe mediante `-S, --start` o `-B, --count`,
+	SnapRAID opera únicamente sobre los bloques seleccionados y no realiza
+	la finalización a nivel de archivo ni la cuarentena.
+
+	Si la recuperación produce datos de mejor esfuerzo que no pueden demostrarse
+	como representativos del contenido actual, dichos bloques aún pueden escribirse
+	con el nombre de archivo normal. La incertidumbre asociada con estos bloques
+	recuperados no se conserva una vez finalizado el comando.
+
+	Como consecuencia, un `fix` posterior tratará estos bloques legibles como
+	datos de archivo válidos y no intentará recuperarlos nuevamente. Esto puede
+	hacer que una recuperación posterior informe éxito dejando datos incompletos
+	o desactualizados en el archivo.
+
+	Las opciones `-S` y `-B` están destinadas únicamente a la recuperación manual
+	avanzada, típicamente después de que un `fix` normal haya fallado. Si un `fix`
+	parcial informa de datos no recuperables, elimine o renombre los archivos
+	afectados antes de intentar otra recuperación, o verifique su contenido manualmente.
+
 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 8b2de82a..dd04322b 100644
--- a/doc/snapraid-es.txt
+++ b/doc/snapraid-es.txt
@@ -2104,6 +2104,28 @@ Evite utilizar la extensión `.unrecoverable` para archivos normales y asegúres
 de incluir `exclude *.unrecoverable` en su configuración para evitar que dichos
 archivos se rastreen en el conjunto de datos de paridad.
 
+16.7 Recuperación con fix parcial
+---------------------------------
+
+Cuando `fix` se restringe mediante `-S, --start` o `-B, --count`,
+SnapRAID opera únicamente sobre los bloques seleccionados y no realiza
+la finalización a nivel de archivo ni la cuarentena.
+
+Si la recuperación produce datos de mejor esfuerzo que no pueden demostrarse
+como representativos del contenido actual, dichos bloques aún pueden escribirse
+con el nombre de archivo normal. La incertidumbre asociada con estos bloques
+recuperados no se conserva una vez finalizado el comando.
+
+Como consecuencia, un `fix` posterior tratará estos bloques legibles como
+datos de archivo válidos y no intentará recuperarlos nuevamente. Esto puede
+hacer que una recuperación posterior informe éxito dejando datos incompletos
+o desactualizados en el archivo.
+
+Las opciones `-S` y `-B` están destinadas únicamente a la recuperación manual
+avanzada, típicamente después de que un `fix` normal haya fallado. Si un `fix`
+parcial informa de datos no recuperables, elimine o renombre los archivos
+afectados antes de intentar otra recuperación, o verifique su contenido manualmente.
+
 
 17 TRADUCCIóN (TRANSLATION)
 ===========================
diff --git a/doc/snapraid-fr.1 b/doc/snapraid-fr.1
index ff631c0a..9f988151 100644
--- a/doc/snapraid-fr.1
+++ b/doc/snapraid-fr.1
@@ -2507,6 +2507,27 @@ nom de base correspond à un fichier en cours de réparation.
 assurez\-vous que la règle \`exclude *.unrecoverable\` est incluse dans votre
 configuration afin d\'empêcher le suivi de ces fichiers dans le jeu de données
 de parité.
+.SS Récupération avec fix partiel 
+Lorsque \`fix\` est restreint avec \`\-S, \-\-start\` ou \`\-B, \-\-count\`,
+SnapRAID opère uniquement sur les blocs sélectionnés et n\'effectue
+pas de finalisation au niveau du fichier ni de mise en quarantaine.
+.PP
+Si la récupération produit des données au mieux (best\-effort) qui ne
+peuvent pas être certifiées comme représentant le contenu actuel, ces
+blocs peuvent tout de même être écrits sous le nom de fichier normal.
+L\'incertitude associée à ces blocs récupérés n\'est pas conservée après
+la fin de l\'exécution de la commande.
+.PP
+Par conséquent, un \`fix\` ultérieur considérera ces blocs lisibles comme des
+données de fichier valides et ne tentera pas de les récupérer à nouveau.
+Cela peut conduire une récupération ultérieure à signaler un succès tout en
+laissant des données incomplètes ou obsolètes dans le fichier.
+.PP
+Les options \`\-S\` et \`\-B\` ne sont destinées qu\'à une récupération manuelle
+avancée, généralement après l\'échec d\'un \`fix\` normal. Si un \`fix\` partiel
+signale des données irrécupérables, supprimez ou renommez les fichiers
+concernés avant de tenter une nouvelle récupération, ou vérifiez manuellement
+leur contenu.
 .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 4d6821db..bd57df89 100644
--- a/doc/snapraid-fr.d
+++ b/doc/snapraid-fr.d
@@ -2006,6 +2006,28 @@ Problèmes connus (Known Issues)
 	configuration afin d'empêcher le suivi de ces fichiers dans le jeu de données
 	de parité.
 
+  Récupération avec fix partiel
+	Lorsque `fix` est restreint avec `-S, --start` ou `-B, --count`,
+	SnapRAID opère uniquement sur les blocs sélectionnés et n'effectue
+	pas de finalisation au niveau du fichier ni de mise en quarantaine.
+
+	Si la récupération produit des données au mieux (best-effort) qui ne
+	peuvent pas être certifiées comme représentant le contenu actuel, ces
+	blocs peuvent tout de même être écrits sous le nom de fichier normal.
+	L'incertitude associée à ces blocs récupérés n'est pas conservée après
+	la fin de l'exécution de la commande.
+
+	Par conséquent, un `fix` ultérieur considérera ces blocs lisibles comme des
+	données de fichier valides et ne tentera pas de les récupérer à nouveau.
+	Cela peut conduire une récupération ultérieure à signaler un succès tout en
+	laissant des données incomplètes ou obsolètes dans le fichier.
+
+	Les options `-S` et `-B` ne sont destinées qu'à une récupération manuelle
+	avancée, généralement après l'échec d'un `fix` normal. Si un `fix` partiel
+	signale des données irrécupérables, supprimez ou renommez les fichiers
+	concernés avant de tenter une nouvelle récupération, ou vérifiez manuellement
+	leur contenu.
+
 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 2b42a69d..03485bf8 100644
--- a/doc/snapraid-fr.txt
+++ b/doc/snapraid-fr.txt
@@ -2149,6 +2149,30 @@ assurez-vous que la règle `exclude *.unrecoverable` est incluse dans votre
 configuration afin d'empêcher le suivi de ces fichiers dans le jeu de données
 de parité.
 
+16.7 Récupération avec fix partiel
+----------------------------------
+
+Lorsque `fix` est restreint avec `-S, --start` ou `-B, --count`,
+SnapRAID opère uniquement sur les blocs sélectionnés et n'effectue
+pas de finalisation au niveau du fichier ni de mise en quarantaine.
+
+Si la récupération produit des données au mieux (best-effort) qui ne
+peuvent pas être certifiées comme représentant le contenu actuel, ces
+blocs peuvent tout de même être écrits sous le nom de fichier normal.
+L'incertitude associée à ces blocs récupérés n'est pas conservée après
+la fin de l'exécution de la commande.
+
+Par conséquent, un `fix` ultérieur considérera ces blocs lisibles comme des
+données de fichier valides et ne tentera pas de les récupérer à nouveau.
+Cela peut conduire une récupération ultérieure à signaler un succès tout en
+laissant des données incomplètes ou obsolètes dans le fichier.
+
+Les options `-S` et `-B` ne sont destinées qu'à une récupération manuelle
+avancée, généralement après l'échec d'un `fix` normal. Si un `fix` partiel
+signale des données irrécupérables, supprimez ou renommez les fichiers
+concernés avant de tenter une nouvelle récupération, ou vérifiez manuellement
+leur contenu.
+
 
 17 TRADUCTION (TRANSLATION)
 ===========================
diff --git a/doc/snapraid-it.1 b/doc/snapraid-it.1
index 4b835b72..f6d81663 100644
--- a/doc/snapraid-it.1
+++ b/doc/snapraid-it.1
@@ -2481,6 +2481,25 @@ se il suo nome di base corrisponde a un file in fase di ripristino.
 Evitare di utilizzare l\'estensione \`.unrecoverable\` per i normali file e
 assicurarsi che la regola \`exclude *.unrecoverable\` sia inclusa nella
 configurazione per evitare che tali file vengano tracciati nel dataset di parità.
+.SS Recupero con fix parziale 
+Quando \`fix\` viene limitato usando \`\-S, \-\-start\` o \`\-B, \-\-count\`,
+SnapRAID opera solo sui blocchi selezionati e non esegue la
+finalizzazione a livello di file né la quarantena.
+.PP
+Se il recupero produce dati \[dq]best\-effort\[dq] che non possono essere provati
+come rappresentativi del contenuto corrente, tali blocchi potrebbero
+comunque essere scritti con il normale nome di file. L\'incertezza associata
+a questi blocchi recuperati non persiste dopo il termine del comando.
+.PP
+Di conseguenza, un successivo \`fix\` tratterà questi blocchi leggibili come
+dati di file validi e non tenterà di recuperarli nuovamente. Ciò può far sì
+che un recupero successivo segnali il successo pur lasciando nel file dati
+incompleti o obsoleti.
+.PP
+Le opzioni \`\-S\` e \`\-B\` sono destinate esclusivamente al recupero manuale
+avanzato, tipicamente dopo che un normale \`fix\` è fallito. Se un \`fix\`
+parziale segnala dati irrecuperabili, rimuovere o rinominare i file interessati
+prima di tentare un altro recupero, oppure verificarne manualmente il contenuto.
 .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 bbbe8508..1ef8ae21 100644
--- a/doc/snapraid-it.d
+++ b/doc/snapraid-it.d
@@ -1969,6 +1969,26 @@ Problemi noti (Known Issues)
 	assicurarsi che la regola `exclude *.unrecoverable` sia inclusa nella
 	configurazione per evitare che tali file vengano tracciati nel dataset di parità.
 
+  Recupero con fix parziale
+	Quando `fix` viene limitato usando `-S, --start` o `-B, --count`,
+	SnapRAID opera solo sui blocchi selezionati e non esegue la
+	finalizzazione a livello di file né la quarantena.
+
+	Se il recupero produce dati "best-effort" che non possono essere provati
+	come rappresentativi del contenuto corrente, tali blocchi potrebbero
+	comunque essere scritti con il normale nome di file. L'incertezza associata
+	a questi blocchi recuperati non persiste dopo il termine del comando.
+
+	Di conseguenza, un successivo `fix` tratterà questi blocchi leggibili come
+	dati di file validi e non tenterà di recuperarli nuovamente. Ciò può far sì
+	che un recupero successivo segnali il successo pur lasciando nel file dati
+	incompleti o obsoleti.
+
+	Le opzioni `-S` e `-B` sono destinate esclusivamente al recupero manuale
+	avanzato, tipicamente dopo che un normale `fix` è fallito. Se un `fix`
+	parziale segnala dati irrecuperabili, rimuovere o rinominare i file interessati
+	prima di tentare un altro recupero, oppure verificarne manualmente il contenuto.
+
 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 93cd4328..8366933c 100644
--- a/doc/snapraid-it.txt
+++ b/doc/snapraid-it.txt
@@ -2112,6 +2112,28 @@ Evitare di utilizzare l'estensione `.unrecoverable` per i normali file e
 assicurarsi che la regola `exclude *.unrecoverable` sia inclusa nella
 configurazione per evitare che tali file vengano tracciati nel dataset di parità.
 
+16.7 Recupero con fix parziale
+------------------------------
+
+Quando `fix` viene limitato usando `-S, --start` o `-B, --count`,
+SnapRAID opera solo sui blocchi selezionati e non esegue la
+finalizzazione a livello di file né la quarantena.
+
+Se il recupero produce dati "best-effort" che non possono essere provati
+come rappresentativi del contenuto corrente, tali blocchi potrebbero
+comunque essere scritti con il normale nome di file. L'incertezza associata
+a questi blocchi recuperati non persiste dopo il termine del comando.
+
+Di conseguenza, un successivo `fix` tratterà questi blocchi leggibili come
+dati di file validi e non tenterà di recuperarli nuovamente. Ciò può far sì
+che un recupero successivo segnali il successo pur lasciando nel file dati
+incompleti o obsoleti.
+
+Le opzioni `-S` e `-B` sono destinate esclusivamente al recupero manuale
+avanzato, tipicamente dopo che un normale `fix` è fallito. Se un `fix`
+parziale segnala dati irrecuperabili, rimuovere o rinominare i file interessati
+prima di tentare un altro recupero, oppure verificarne manualmente il contenuto.
+
 
 17 TRADUZIONE (TRANSLATION)
 ===========================
diff --git a/doc/snapraid-ja.1 b/doc/snapraid-ja.1
index 905cf922..8d21ef3f 100644
--- a/doc/snapraid-ja.1
+++ b/doc/snapraid-ja.1
@@ -2229,6 +2229,25 @@ SnapRAID はファイル名のみに基づいて隔離ファイルを識別す
 通常のファイルには \`.unrecoverable\` 拡張子を使用しないようにし、それらのファイルが
 パリティデータセットで追跡されないように設定に \`exclude *.unrecoverable\` が含まれている
 ことを確認してください。
+.SS 部分的な fix による回復 
+\`fix\` を \`\-S, \-\-start\` または \`\-B, \-\-count\` で制限した場合、
+SnapRAID は選択されたブロックのみを処理し、ファイルレベルの完了処理や
+隔離を行いません。
+.PP
+回復によって現在の内容を表していると証明できないベストエフォートのデータが
+生成された場合でも、それらのブロックは通常のファイル名で書き込まれる
+可能性があります。これらの回復されたブロックに関連する不確実性は、コマンドの
+終了後には保持されません。
+.PP
+その結果、後続の \`fix\` はこれらの読み取り可能なブロックを有効なファイルデータ
+として扱い、再度の回復を試みません。これにより、ファイル内に不完全または
+古いデータが残っているにもかかわらず、後続の回復が成功と報告される場合が
+あります。
+.PP
+\`\-S\` および \`\-B\` オプションは、通常の \`fix\` が失敗した後の高度な手動回復
+のみを目的としています。部分的な \`fix\` で回復不能なデータが報告された場合は、
+別の回復を試みる前に対象のファイルを削除または名前変更するか、その内容を手動で
+確認してください。
 .SH 翻訳 (TRANSLATION) 
 この文書は英語版マニュアルの自動翻訳です。
 正確な記述については英語版マニュアルを参照してください。
diff --git a/doc/snapraid-ja.d b/doc/snapraid-ja.d
index 7045a2a4..0ee715e0 100644
--- a/doc/snapraid-ja.d
+++ b/doc/snapraid-ja.d
@@ -1731,6 +1731,26 @@ Name{number}
 	パリティデータセットで追跡されないように設定に `exclude *.unrecoverable` が含まれている
 	ことを確認してください。
 
+  部分的な fix による回復
+	`fix` を `-S, --start` または `-B, --count` で制限した場合、
+	SnapRAID は選択されたブロックのみを処理し、ファイルレベルの完了処理や
+	隔離を行いません。
+
+	回復によって現在の内容を表していると証明できないベストエフォートのデータが
+	生成された場合でも、それらのブロックは通常のファイル名で書き込まれる
+	可能性があります。これらの回復されたブロックに関連する不確実性は、コマンドの
+	終了後には保持されません。
+
+	その結果、後続の `fix` はこれらの読み取り可能なブロックを有効なファイルデータ
+	として扱い、再度の回復を試みません。これにより、ファイル内に不完全または
+	古いデータが残っているにもかかわらず、後続の回復が成功と報告される場合が
+	あります。
+
+	`-S` および `-B` オプションは、通常の `fix` が失敗した後の高度な手動回復
+	のみを目的としています。部分的な `fix` で回復不能なデータが報告された場合は、
+	別の回復を試みる前に対象のファイルを削除または名前変更するか、その内容を手動で
+	確認してください。
+
 翻訳 (Translation)
 	この文書は英語版マニュアルの自動翻訳です。
 	正確な記述については英語版マニュアルを参照してください。
diff --git a/doc/snapraid-ja.txt b/doc/snapraid-ja.txt
index 798001b0..c380515e 100644
--- a/doc/snapraid-ja.txt
+++ b/doc/snapraid-ja.txt
@@ -1874,6 +1874,28 @@ SnapRAID はファイル名のみに基づいて隔離ファイルを識別す
 パリティデータセットで追跡されないように設定に `exclude *.unrecoverable` が含まれている
 ことを確認してください。
 
+16.7 部分的な fix による回復
+-------------------
+
+`fix` を `-S, --start` または `-B, --count` で制限した場合、
+SnapRAID は選択されたブロックのみを処理し、ファイルレベルの完了処理や
+隔離を行いません。
+
+回復によって現在の内容を表していると証明できないベストエフォートのデータが
+生成された場合でも、それらのブロックは通常のファイル名で書き込まれる
+可能性があります。これらの回復されたブロックに関連する不確実性は、コマンドの
+終了後には保持されません。
+
+その結果、後続の `fix` はこれらの読み取り可能なブロックを有効なファイルデータ
+として扱い、再度の回復を試みません。これにより、ファイル内に不完全または
+古いデータが残っているにもかかわらず、後続の回復が成功と報告される場合が
+あります。
+
+`-S` および `-B` オプションは、通常の `fix` が失敗した後の高度な手動回復
+のみを目的としています。部分的な `fix` で回復不能なデータが報告された場合は、
+別の回復を試みる前に対象のファイルを削除または名前変更するか、その内容を手動で
+確認してください。
+
 
 17 翻訳 (TRANSLATION)
 ===================
diff --git a/doc/snapraid-ko.1 b/doc/snapraid-ko.1
index e0f08154..8780ed91 100644
--- a/doc/snapraid-ko.1
+++ b/doc/snapraid-ko.1
@@ -2273,6 +2273,23 @@ SnapRAID는 오직 파일 이름으로만 격리 파일을 식별하므로, 우
 .PP
 일반 파일에는 \`.unrecoverable\` 확장자를 사용하지 마시고, 해당 파일이 패리티 데이터셋에서
 추적되지 않도록 구성에 \`exclude *.unrecoverable\`이 포함되어 있는지 확인하십시오.
+.SS 부분 fix 복구 
+\`fix\`가 \`\-S, \-\-start\` 또는 \`\-B, \-\-count\`를 사용하여 제한되면,
+SnapRAID는 선택된 블록에서만 작동하며 파일 수준의 완료 처리나 격리를
+수행하지 않습니다.
+.PP
+복구 결과 현재 내용을 나타낸다고 입증할 수 없는 최선의(best\-effort) 데이터가
+생성되더라도, 이러한 블록은 일반 파일 이름으로 기록될 수 있습니다. 이러한
+복구된 블록과 관련된 불확실성은 명령이 종료된 후 유지되지 않습니다.
+.PP
+결과적으로 이후의 \`fix\`는 이러한 읽기 가능한 블록을 유효한 파일 데이터로
+취급하고 다시 복구하려고 시도하지 않습니다. 이로 인해 파일에 불완전하거나
+오래된 데이터가 남아 있음에도 후속 복구가 성공으로 보고될 수 있습니다.
+.PP
+\`\-S\` 및 \`\-B\` 옵션은 일반적으로 일반 \`fix\`가 실패한 후 고급 수동 복구만을
+위한 것입니다. 부분 \`fix\`에서 복구할 수 없는 데이터가 보고되면 다른 복구를
+시도하기 전에 영향을 받는 파일을 제거하거나 이름을 바꾸거나 해당 내용을
+수동으로 확인하십시오.
 .SH 번역 (TRANSLATION) 
 이 문서는 영어 매뉴얼의 자동 번역본입니다.
 공식 버전은 영어 매뉴얼을 참조하십시오.
diff --git a/doc/snapraid-ko.d b/doc/snapraid-ko.d
index 8f25a249..591f5fcb 100644
--- a/doc/snapraid-ko.d
+++ b/doc/snapraid-ko.d
@@ -1775,6 +1775,24 @@ Name{number}
 	일반 파일에는 `.unrecoverable` 확장자를 사용하지 마시고, 해당 파일이 패리티 데이터셋에서
 	추적되지 않도록 구성에 `exclude *.unrecoverable`이 포함되어 있는지 확인하십시오.
 
+  부분 fix 복구
+	`fix`가 `-S, --start` 또는 `-B, --count`를 사용하여 제한되면,
+	SnapRAID는 선택된 블록에서만 작동하며 파일 수준의 완료 처리나 격리를
+	수행하지 않습니다.
+
+	복구 결과 현재 내용을 나타낸다고 입증할 수 없는 최선의(best-effort) 데이터가
+	생성되더라도, 이러한 블록은 일반 파일 이름으로 기록될 수 있습니다. 이러한
+	복구된 블록과 관련된 불확실성은 명령이 종료된 후 유지되지 않습니다.
+
+	결과적으로 이후의 `fix`는 이러한 읽기 가능한 블록을 유효한 파일 데이터로
+	취급하고 다시 복구하려고 시도하지 않습니다. 이로 인해 파일에 불완전하거나
+	오래된 데이터가 남아 있음에도 후속 복구가 성공으로 보고될 수 있습니다.
+
+	`-S` 및 `-B` 옵션은 일반적으로 일반 `fix`가 실패한 후 고급 수동 복구만을
+	위한 것입니다. 부분 `fix`에서 복구할 수 없는 데이터가 보고되면 다른 복구를
+	시도하기 전에 영향을 받는 파일을 제거하거나 이름을 바꾸거나 해당 내용을
+	수동으로 확인하십시오.
+
 번역 (Translation)
 	이 문서는 영어 매뉴얼의 자동 번역본입니다.
 	공식 버전은 영어 매뉴얼을 참조하십시오.
diff --git a/doc/snapraid-ko.txt b/doc/snapraid-ko.txt
index 4cc2cba8..6ad6bac3 100644
--- a/doc/snapraid-ko.txt
+++ b/doc/snapraid-ko.txt
@@ -1918,6 +1918,26 @@ SnapRAID는 오직 파일 이름으로만 격리 파일을 식별하므로, 우
 일반 파일에는 `.unrecoverable` 확장자를 사용하지 마시고, 해당 파일이 패리티 데이터셋에서
 추적되지 않도록 구성에 `exclude *.unrecoverable`이 포함되어 있는지 확인하십시오.
 
+16.7 부분 fix 복구
+--------------
+
+`fix`가 `-S, --start` 또는 `-B, --count`를 사용하여 제한되면,
+SnapRAID는 선택된 블록에서만 작동하며 파일 수준의 완료 처리나 격리를
+수행하지 않습니다.
+
+복구 결과 현재 내용을 나타낸다고 입증할 수 없는 최선의(best-effort) 데이터가
+생성되더라도, 이러한 블록은 일반 파일 이름으로 기록될 수 있습니다. 이러한
+복구된 블록과 관련된 불확실성은 명령이 종료된 후 유지되지 않습니다.
+
+결과적으로 이후의 `fix`는 이러한 읽기 가능한 블록을 유효한 파일 데이터로
+취급하고 다시 복구하려고 시도하지 않습니다. 이로 인해 파일에 불완전하거나
+오래된 데이터가 남아 있음에도 후속 복구가 성공으로 보고될 수 있습니다.
+
+`-S` 및 `-B` 옵션은 일반적으로 일반 `fix`가 실패한 후 고급 수동 복구만을
+위한 것입니다. 부분 `fix`에서 복구할 수 없는 데이터가 보고되면 다른 복구를
+시도하기 전에 영향을 받는 파일을 제거하거나 이름을 바꾸거나 해당 내용을
+수동으로 확인하십시오.
+
 
 17 번역 (TRANSLATION)
 ===================
diff --git a/doc/snapraid-pl.1 b/doc/snapraid-pl.1
index 9f7cd2ec..3408915d 100644
--- a/doc/snapraid-pl.1
+++ b/doc/snapraid-pl.1
@@ -2368,6 +2368,26 @@ jego nazwa bazowa odpowiada naprawianemu plikowi.
 Unikaj używania rozszerzenia \`.unrecoverable\` dla zwykłych plików i upewnij się,
 że w konfiguracji uwzględniono regułę \`exclude *.unrecoverable\`, aby zapobiec
 śledzeniu takich plików w zbiorze danych parzystości.
+.SS Odzyskiwanie za pomocą częściowego fix 
+Gdy polecenie \`fix\` jest ograniczone za pomocą \`\-S, \-\-start\` lub \`\-B, \-\-count\`,
+SnapRAID działa tylko na wybranych blokach i nie przeprowadza finalizacji
+na poziomie plików ani kwarantanny.
+.PP
+Jeśli odzyskiwanie da dane typu best\-effort, co do których nie można udowodnić,
+że reprezentują bieżącą zawartość, takie bloki mogą nadal zostać zapisane pod
+zwykłą nazwą pliku. Niepewność związana z tymi odzyskanymi blokami nie jest
+zachowywana po zakończeniu polecenia.
+.PP
+W rezultacie późniejsze wykonanie \`fix\` potraktuje te czytelne bloki jako
+prawidłowe dane pliku i nie podejmie ponownej próby ich odzyskania. Może to
+spowodować, że późniejsze odzyskiwanie zgłosi sukces, pozostawiając w pliku
+niekompletne lub nieaktualne dane.
+.PP
+Opcje \`\-S\` i \`\-B\` są przeznaczone wyłącznie do zaawansowanego odzyskiwania
+ręcznego, zazwyczaj po niepowodzeniu normalnego \`fix\`. Jeśli częściowy \`fix\`
+zgłosi dane niemożliwe do odzyskania, przed podjęciem kolejnej próby odzyskiwania
+należy usunąć lub zmienić nazwę plików, których to dotyczy, albo ręcznie zweryfikować
+ich zawartość.
 .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 76b721d0..9935646c 100644
--- a/doc/snapraid-pl.d
+++ b/doc/snapraid-pl.d
@@ -1870,6 +1870,27 @@ Znane problemy (Known Issues)
 	że w konfiguracji uwzględniono regułę `exclude *.unrecoverable`, aby zapobiec
 	śledzeniu takich plików w zbiorze danych parzystości.
 
+  Odzyskiwanie za pomocą częściowego fix
+	Gdy polecenie `fix` jest ograniczone za pomocą `-S, --start` lub `-B, --count`,
+	SnapRAID działa tylko na wybranych blokach i nie przeprowadza finalizacji
+	na poziomie plików ani kwarantanny.
+
+	Jeśli odzyskiwanie da dane typu best-effort, co do których nie można udowodnić,
+	że reprezentują bieżącą zawartość, takie bloki mogą nadal zostać zapisane pod
+	zwykłą nazwą pliku. Niepewność związana z tymi odzyskanymi blokami nie jest
+	zachowywana po zakończeniu polecenia.
+
+	W rezultacie późniejsze wykonanie `fix` potraktuje te czytelne bloki jako
+	prawidłowe dane pliku i nie podejmie ponownej próby ich odzyskania. Może to
+	spowodować, że późniejsze odzyskiwanie zgłosi sukces, pozostawiając w pliku
+	niekompletne lub nieaktualne dane.
+
+	Opcje `-S` i `-B` są przeznaczone wyłącznie do zaawansowanego odzyskiwania
+	ręcznego, zazwyczaj po niepowodzeniu normalnego `fix`. Jeśli częściowy `fix`
+	zgłosi dane niemożliwe do odzyskania, przed podjęciem kolejnej próby odzyskiwania
+	należy usunąć lub zmienić nazwę plików, których to dotyczy, albo ręcznie zweryfikować
+	ich zawartość.
+
 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 12299f32..19b0c7b9 100644
--- a/doc/snapraid-pl.txt
+++ b/doc/snapraid-pl.txt
@@ -2013,6 +2013,29 @@ Unikaj używania rozszerzenia `.unrecoverable` dla zwykłych plików i upewnij s
 że w konfiguracji uwzględniono regułę `exclude *.unrecoverable`, aby zapobiec
 śledzeniu takich plików w zbiorze danych parzystości.
 
+16.7 Odzyskiwanie za pomocą częściowego fix
+-------------------------------------------
+
+Gdy polecenie `fix` jest ograniczone za pomocą `-S, --start` lub `-B, --count`,
+SnapRAID działa tylko na wybranych blokach i nie przeprowadza finalizacji
+na poziomie plików ani kwarantanny.
+
+Jeśli odzyskiwanie da dane typu best-effort, co do których nie można udowodnić,
+że reprezentują bieżącą zawartość, takie bloki mogą nadal zostać zapisane pod
+zwykłą nazwą pliku. Niepewność związana z tymi odzyskanymi blokami nie jest
+zachowywana po zakończeniu polecenia.
+
+W rezultacie późniejsze wykonanie `fix` potraktuje te czytelne bloki jako
+prawidłowe dane pliku i nie podejmie ponownej próby ich odzyskania. Może to
+spowodować, że późniejsze odzyskiwanie zgłosi sukces, pozostawiając w pliku
+niekompletne lub nieaktualne dane.
+
+Opcje `-S` i `-B` są przeznaczone wyłącznie do zaawansowanego odzyskiwania
+ręcznego, zazwyczaj po niepowodzeniu normalnego `fix`. Jeśli częściowy `fix`
+zgłosi dane niemożliwe do odzyskania, przed podjęciem kolejnej próby odzyskiwania
+należy usunąć lub zmienić nazwę plików, których to dotyczy, albo ręcznie zweryfikować
+ich zawartość.
+
 
 17 TłUMACZENIE (TRANSLATION)
 ============================
diff --git a/doc/snapraid-pt.1 b/doc/snapraid-pt.1
index 101c8acc..91ad2eff 100644
--- a/doc/snapraid-pt.1
+++ b/doc/snapraid-pt.1
@@ -2406,6 +2406,25 @@ nome base coincidir com o arquivo que está sendo restaurado.
 Evite usar a extensão \`.unrecoverable\` para arquivos comuns e certifique\-se de
 que \`exclude *.unrecoverable\` esteja incluído na sua configuração para evitar que
 esses arquivos sejam rastreados no conjunto de dados de paridade.
+.SS Recuperação com fix parcial 
+Quando o \`fix\` é restrito usando \`\-S, \-\-start\` ou \`\-B, \-\-count\`,
+o SnapRAID opera apenas nos blocos selecionados e não realiza a
+finalização em nível de arquivo nem a quarentena.
+.PP
+Se a recuperação produzir dados de melhor esforço (best\-effort) que não
+possam ser comprovados como representativos do conteúdo atual, esses
+blocos ainda poderão ser gravados com o nome de arquivo normal. A incerteza
+associada a esses blocos recuperados não persiste após o término do comando.
+.PP
+Como consequência, um \`fix\` posterior tratará esses blocos legíveis como
+dados de arquivo válidos e não tentará recuperá\-los novamente. Isso pode
+fazer com que uma recuperação posterior relate sucesso, deixando dados
+incompletos ou obsoletos no arquivo.
+.PP
+As opções \`\-S\` e \`\-B\` destinam\-se apenas à recuperação manual avançada,
+normalmente após a falha de um \`fix\` normal. Se um \`fix\` parcial relatar
+dados irrecuperáveis, remova ou renomeie os arquivos afetados antes de tentar
+outra recuperação, ou verifique manualmente seu conteúdo.
 .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 0f678cd7..52213fc3 100644
--- a/doc/snapraid-pt.d
+++ b/doc/snapraid-pt.d
@@ -1908,6 +1908,26 @@ Problemas Conhecidos (Known Issues)
 	que `exclude *.unrecoverable` esteja incluído na sua configuração para evitar que
 	esses arquivos sejam rastreados no conjunto de dados de paridade.
 
+  Recuperação com fix parcial
+	Quando o `fix` é restrito usando `-S, --start` ou `-B, --count`,
+	o SnapRAID opera apenas nos blocos selecionados e não realiza a
+	finalização em nível de arquivo nem a quarentena.
+
+	Se a recuperação produzir dados de melhor esforço (best-effort) que não
+	possam ser comprovados como representativos do conteúdo atual, esses
+	blocos ainda poderão ser gravados com o nome de arquivo normal. A incerteza
+	associada a esses blocos recuperados não persiste após o término do comando.
+
+	Como consequência, um `fix` posterior tratará esses blocos legíveis como
+	dados de arquivo válidos e não tentará recuperá-los novamente. Isso pode
+	fazer com que uma recuperação posterior relate sucesso, deixando dados
+	incompletos ou obsoletos no arquivo.
+
+	As opções `-S` e `-B` destinam-se apenas à recuperação manual avançada,
+	normalmente após a falha de um `fix` normal. Se um `fix` parcial relatar
+	dados irrecuperáveis, remova ou renomeie os arquivos afetados antes de tentar
+	outra recuperação, ou verifique manualmente seu conteúdo.
+
 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 be050168..34fd6f47 100644
--- a/doc/snapraid-pt.txt
+++ b/doc/snapraid-pt.txt
@@ -2051,6 +2051,28 @@ Evite usar a extensão `.unrecoverable` para arquivos comuns e certifique-se de
 que `exclude *.unrecoverable` esteja incluído na sua configuração para evitar que
 esses arquivos sejam rastreados no conjunto de dados de paridade.
 
+16.7 Recuperação com fix parcial
+--------------------------------
+
+Quando o `fix` é restrito usando `-S, --start` ou `-B, --count`,
+o SnapRAID opera apenas nos blocos selecionados e não realiza a
+finalização em nível de arquivo nem a quarentena.
+
+Se a recuperação produzir dados de melhor esforço (best-effort) que não
+possam ser comprovados como representativos do conteúdo atual, esses
+blocos ainda poderão ser gravados com o nome de arquivo normal. A incerteza
+associada a esses blocos recuperados não persiste após o término do comando.
+
+Como consequência, um `fix` posterior tratará esses blocos legíveis como
+dados de arquivo válidos e não tentará recuperá-los novamente. Isso pode
+fazer com que uma recuperação posterior relate sucesso, deixando dados
+incompletos ou obsoletos no arquivo.
+
+As opções `-S` e `-B` destinam-se apenas à recuperação manual avançada,
+normalmente após a falha de um `fix` normal. Se um `fix` parcial relatar
+dados irrecuperáveis, remova ou renomeie os arquivos afetados antes de tentar
+outra recuperação, ou verifique manualmente seu conteúdo.
+
 
 17 TRADUçãO (TRANSLATION)
 =========================
diff --git a/doc/snapraid-ro.1 b/doc/snapraid-ro.1
index 55b22623..0eb3d292 100644
--- a/doc/snapraid-ro.1
+++ b/doc/snapraid-ro.1
@@ -2365,6 +2365,25 @@ corespunde unui fișier în curs de reparare.
 Evitați utilizarea extensiei \`.unrecoverable\` pentru fișiere obișnuite și
 asigurați\-vă că \`exclude *.unrecoverable\` este inclus în configurație pentru
 a preveni urmărirea acestor fișiere în setul de date de paritate.
+.SS Recuperare cu fix parțial 
+Când \`fix\` este restricționat folosind \`\-S, \-\-start\` sau \`\-B, \-\-count\`,
+SnapRAID operează doar pe blocurile selectate și nu efectuează finalizarea
+la nivel de fișier sau carantina.
+.PP
+Dacă recuperarea produce date de tip „best\-effort” despre care nu se poate
+dovedi că reprezintă conținutul curent, astfel de blocuri pot fi totuși
+scrise sub numele de fișier normal. Incertitudinea asociată cu aceste blocuri
+recuperate nu este păstrată după terminarea comenzii.
+.PP
+În consecință, un \`fix\` ulterior va trata aceste blocuri lizibile drept date
+de fișier valide și nu va încerca să le recupereze din nou. Acest lucru poate
+face ca o recuperare ulterioară să raporteze succes, lăsând în același timp date
+incomplete sau învechite în fișier.
+.PP
+Opțiunile \`\-S\` și \`\-B\` sunt destinate exclusiv recuperării manuale avansate,
+de obicei după ce un \`fix\` normal a eșuat. Dacă un \`fix\` parțial raportează
+date nerecuperabile, eliminați sau redenumiți fișierele afectate înainte de a
+încerca o nouă recuperare, sau verificați manual conținutul acestora.
 .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 91ac49fe..49bc835a 100644
--- a/doc/snapraid-ro.d
+++ b/doc/snapraid-ro.d
@@ -1867,6 +1867,26 @@ Probleme Cunoscute (Known Issues)
 	asigurați-vă că `exclude *.unrecoverable` este inclus în configurație pentru
 	a preveni urmărirea acestor fișiere în setul de date de paritate.
 
+  Recuperare cu fix parțial
+	Când `fix` este restricționat folosind `-S, --start` sau `-B, --count`,
+	SnapRAID operează doar pe blocurile selectate și nu efectuează finalizarea
+	la nivel de fișier sau carantina.
+
+	Dacă recuperarea produce date de tip „best-effort” despre care nu se poate
+	dovedi că reprezintă conținutul curent, astfel de blocuri pot fi totuși
+	scrise sub numele de fișier normal. Incertitudinea asociată cu aceste blocuri
+	recuperate nu este păstrată după terminarea comenzii.
+
+	În consecință, un `fix` ulterior va trata aceste blocuri lizibile drept date
+	de fișier valide și nu va încerca să le recupereze din nou. Acest lucru poate
+	face ca o recuperare ulterioară să raporteze succes, lăsând în același timp date
+	incomplete sau învechite în fișier.
+
+	Opțiunile `-S` și `-B` sunt destinate exclusiv recuperării manuale avansate,
+	de obicei după ce un `fix` normal a eșuat. Dacă un `fix` parțial raportează
+	date nerecuperabile, eliminați sau redenumiți fișierele afectate înainte de a
+	încerca o nouă recuperare, sau verificați manual conținutul acestora.
+
 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 e03a73ef..3cb92d40 100644
--- a/doc/snapraid-ro.txt
+++ b/doc/snapraid-ro.txt
@@ -2010,6 +2010,28 @@ Evitați utilizarea extensiei `.unrecoverable` pentru fișiere obișnuite și
 asigurați-vă că `exclude *.unrecoverable` este inclus în configurație pentru
 a preveni urmărirea acestor fișiere în setul de date de paritate.
 
+16.7 Recuperare cu fix parțial
+------------------------------
+
+Când `fix` este restricționat folosind `-S, --start` sau `-B, --count`,
+SnapRAID operează doar pe blocurile selectate și nu efectuează finalizarea
+la nivel de fișier sau carantina.
+
+Dacă recuperarea produce date de tip „best-effort” despre care nu se poate
+dovedi că reprezintă conținutul curent, astfel de blocuri pot fi totuși
+scrise sub numele de fișier normal. Incertitudinea asociată cu aceste blocuri
+recuperate nu este păstrată după terminarea comenzii.
+
+În consecință, un `fix` ulterior va trata aceste blocuri lizibile drept date
+de fișier valide și nu va încerca să le recupereze din nou. Acest lucru poate
+face ca o recuperare ulterioară să raporteze succes, lăsând în același timp date
+incomplete sau învechite în fișier.
+
+Opțiunile `-S` și `-B` sunt destinate exclusiv recuperării manuale avansate,
+de obicei după ce un `fix` normal a eșuat. Dacă un `fix` parțial raportează
+date nerecuperabile, eliminați sau redenumiți fișierele afectate înainte de a
+încerca o nouă recuperare, sau verificați manual conținutul acestora.
+
 
 17 TRADUCERE (TRANSLATION)
 ==========================
diff --git a/doc/snapraid-ru.1 b/doc/snapraid-ru.1
index a0c60280..90261603 100644
--- a/doc/snapraid-ru.1
+++ b/doc/snapraid-ru.1
@@ -2370,6 +2370,25 @@ SnapRAID удаляет устаревший файл \`.unrecoverable\`. Кар
 Избегайте использования расширения \`.unrecoverable\` для обычных файлов и
 убедитесь, что в вашей конфигурации указано правило \`exclude *.unrecoverable\`,
 чтобы такие файлы не отслеживались в наборе данных четности.
+.SS Восстановление с частичным fix 
+Когда \`fix\` ограничен с помощью \`\-S, \-\-start\` или \`\-B, \-\-count\`,
+SnapRAID работает только с выбранными блоками и не выполняет финализацию
+на уровне файлов или помещение в карантин.
+.PP
+Если в результате восстановления получаются данные наилучшей попытки (best\-effort),
+для которых нельзя доказать, что они соответствуют текущему содержимому, такие
+блоки все равно могут быть записаны под обычным именем файла. Неопределенность,
+связанная с этими восстановленными блоками, не сохраняется после завершения команды.
+.PP
+Как следствие, последующий \`fix\` будет рассматривать эти читаемые блоки как
+корректные данные файла и не попытается восстановить их снова. Это может привести
+к тому, что последующее восстановление сообщит об успехе, оставив в файле
+неполные или устаревшие данные.
+.PP
+Параметры \`\-S\` и \`\-B\` предназначены только для расширенного ручного
+восстановления, обычно после сбоя обычного \`fix\`. Если частичный \`fix\` сообщает
+о невосстановимых данных, удалите или переименуйте затронутые файлы перед
+попыткой повторного восстановления либо проверьте их содержимое вручную.
 .SH Перевод (TRANSLATION) 
 Этот документ является автоматическим переводом английского руководства.
 Обратитесь к английскому руководству за официальной версией.
diff --git a/doc/snapraid-ru.d b/doc/snapraid-ru.d
index ec9a1813..d720634d 100644
--- a/doc/snapraid-ru.d
+++ b/doc/snapraid-ru.d
@@ -1874,6 +1874,26 @@ Name{number}
 	убедитесь, что в вашей конфигурации указано правило `exclude *.unrecoverable`,
 	чтобы такие файлы не отслеживались в наборе данных четности.
 
+  Восстановление с частичным fix
+	Когда `fix` ограничен с помощью `-S, --start` или `-B, --count`,
+	SnapRAID работает только с выбранными блоками и не выполняет финализацию
+	на уровне файлов или помещение в карантин.
+
+	Если в результате восстановления получаются данные наилучшей попытки (best-effort),
+	для которых нельзя доказать, что они соответствуют текущему содержимому, такие
+	блоки все равно могут быть записаны под обычным именем файла. Неопределенность,
+	связанная с этими восстановленными блоками, не сохраняется после завершения команды.
+
+	Как следствие, последующий `fix` будет рассматривать эти читаемые блоки как
+	корректные данные файла и не попытается восстановить их снова. Это может привести
+	к тому, что последующее восстановление сообщит об успехе, оставив в файле
+	неполные или устаревшие данные.
+
+	Параметры `-S` и `-B` предназначены только для расширенного ручного
+	восстановления, обычно после сбоя обычного `fix`. Если частичный `fix` сообщает
+	о невосстановимых данных, удалите или переименуйте затронутые файлы перед
+	попыткой повторного восстановления либо проверьте их содержимое вручную.
+
 Перевод (Translation)
 	Этот документ является автоматическим переводом английского руководства.
 	Обратитесь к английскому руководству за официальной версией.
diff --git a/doc/snapraid-ru.txt b/doc/snapraid-ru.txt
index a9257628..c7d51b6e 100644
--- a/doc/snapraid-ru.txt
+++ b/doc/snapraid-ru.txt
@@ -2017,6 +2017,28 @@ SnapRAID удаляет устаревший файл `.unrecoverable`. Кара
 убедитесь, что в вашей конфигурации указано правило `exclude *.unrecoverable`,
 чтобы такие файлы не отслеживались в наборе данных четности.
 
+16.7 Восстановление с частичным fix
+-----------------------------------
+
+Когда `fix` ограничен с помощью `-S, --start` или `-B, --count`,
+SnapRAID работает только с выбранными блоками и не выполняет финализацию
+на уровне файлов или помещение в карантин.
+
+Если в результате восстановления получаются данные наилучшей попытки (best-effort),
+для которых нельзя доказать, что они соответствуют текущему содержимому, такие
+блоки все равно могут быть записаны под обычным именем файла. Неопределенность,
+связанная с этими восстановленными блоками, не сохраняется после завершения команды.
+
+Как следствие, последующий `fix` будет рассматривать эти читаемые блоки как
+корректные данные файла и не попытается восстановить их снова. Это может привести
+к тому, что последующее восстановление сообщит об успехе, оставив в файле
+неполные или устаревшие данные.
+
+Параметры `-S` и `-B` предназначены только для расширенного ручного
+восстановления, обычно после сбоя обычного `fix`. Если частичный `fix` сообщает
+о невосстановимых данных, удалите или переименуйте затронутые файлы перед
+попыткой повторного восстановления либо проверьте их содержимое вручную.
+
 
 17 Перевод (TRANSLATION)
 ========================
diff --git a/doc/snapraid-sv.1 b/doc/snapraid-sv.1
index 82104d4f..4c8e7f69 100644
--- a/doc/snapraid-sv.1
+++ b/doc/snapraid-sv.1
@@ -2362,6 +2362,25 @@ som håller på att återställas.
 Undvik att använda filändelsen \`.unrecoverable\` för vanliga filer och se till
 att \`exclude *.unrecoverable\` ingår i din konfiguration för att förhindra att
 sådana filer spåras i paritetsdatamängden.
+.SS Återställning med partiell fix 
+När \`fix\` begränsas med \`\-S, \-\-start\` eller \`\-B, \-\-count\`,
+arbetar SnapRAID endast på de markerade blocken och utför varken
+slutförande på filnivå eller karantän.
+.PP
+Om återställningen producerar \[dq]best\-effort\[dq]\-data som inte kan bevisas
+representera det aktuella innehållet, kan sådana block ändå skrivas under det
+normala filnamnet. Osäkerheten förknippad med dessa återställda block bevaras
+inte efter att kommandot har avslutats.
+.PP
+Som en konsekvens kommer en senare \`fix\` att behandla dessa läsbara block som
+giltiga fildata och inte försöka återställa dem igen. Detta kan leda till att
+en efterföljande återställning rapporterar framgång samtidigt som ofullständiga
+eller inaktuella data lämnas kvar i filen.
+.PP
+Alternativen \`\-S\` och \`\-B\` är endast avsedda för avancerad manuell återställning,
+vanligtvis efter att en normal \`fix\` har misslyckats. Om en partiell \`fix\`
+rapporterar oåterkalleliga data, ta bort eller byt namn på de berörda filerna
+innan du försöker med en ny återställning, eller verifiera deras innehåll manuellt.
 .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 7916268f..c0d8442b 100644
--- a/doc/snapraid-sv.d
+++ b/doc/snapraid-sv.d
@@ -1864,6 +1864,26 @@ Kända problem (Known Issues)
 	att `exclude *.unrecoverable` ingår i din konfiguration för att förhindra att
 	sådana filer spåras i paritetsdatamängden.
 
+  Återställning med partiell fix
+	När `fix` begränsas med `-S, --start` eller `-B, --count`,
+	arbetar SnapRAID endast på de markerade blocken och utför varken
+	slutförande på filnivå eller karantän.
+
+	Om återställningen producerar "best-effort"-data som inte kan bevisas
+	representera det aktuella innehållet, kan sådana block ändå skrivas under det
+	normala filnamnet. Osäkerheten förknippad med dessa återställda block bevaras
+	inte efter att kommandot har avslutats.
+
+	Som en konsekvens kommer en senare `fix` att behandla dessa läsbara block som
+	giltiga fildata och inte försöka återställa dem igen. Detta kan leda till att
+	en efterföljande återställning rapporterar framgång samtidigt som ofullständiga
+	eller inaktuella data lämnas kvar i filen.
+
+	Alternativen `-S` och `-B` är endast avsedda för avancerad manuell återställning,
+	vanligtvis efter att en normal `fix` har misslyckats. Om en partiell `fix`
+	rapporterar oåterkalleliga data, ta bort eller byt namn på de berörda filerna
+	innan du försöker med en ny återställning, eller verifiera deras innehåll manuellt.
+
 Ö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 99488352..bd182eb4 100644
--- a/doc/snapraid-sv.txt
+++ b/doc/snapraid-sv.txt
@@ -2007,6 +2007,28 @@ Undvik att använda filändelsen `.unrecoverable` för vanliga filer och se till
 att `exclude *.unrecoverable` ingår i din konfiguration för att förhindra att
 sådana filer spåras i paritetsdatamängden.
 
+16.7 Återställning med partiell fix
+-----------------------------------
+
+När `fix` begränsas med `-S, --start` eller `-B, --count`,
+arbetar SnapRAID endast på de markerade blocken och utför varken
+slutförande på filnivå eller karantän.
+
+Om återställningen producerar "best-effort"-data som inte kan bevisas
+representera det aktuella innehållet, kan sådana block ändå skrivas under det
+normala filnamnet. Osäkerheten förknippad med dessa återställda block bevaras
+inte efter att kommandot har avslutats.
+
+Som en konsekvens kommer en senare `fix` att behandla dessa läsbara block som
+giltiga fildata och inte försöka återställa dem igen. Detta kan leda till att
+en efterföljande återställning rapporterar framgång samtidigt som ofullständiga
+eller inaktuella data lämnas kvar i filen.
+
+Alternativen `-S` och `-B` är endast avsedda för avancerad manuell återställning,
+vanligtvis efter att en normal `fix` har misslyckats. Om en partiell `fix`
+rapporterar oåterkalleliga data, ta bort eller byt namn på de berörda filerna
+innan du försöker med en ny återställning, eller verifiera deras innehåll manuellt.
+
 
 17 ÖVERSäTTNING (TRANSLATION)
 =============================
diff --git a/doc/snapraid-uk.1 b/doc/snapraid-uk.1
index e4b57f8a..4f162bd2 100644
--- a/doc/snapraid-uk.1
+++ b/doc/snapraid-uk.1
@@ -2568,6 +2568,25 @@ SnapRAID використовує стандартне, передбачуван
 Уникайте використання розширення \`.unrecoverable\` для звичайних файлів і
 переконайтеся, що правило \`exclude *.unrecoverable\` включено до вашої
 конфігурації, щоб такі файли не відстежувалися в наборі даних парності.
+.SS Відновлення з частковим fix 
+Коли \`fix\` обмежено за допомогою \`\-S, \-\-start\` або \`\-B, \-\-count\`,
+SnapRAID працює лише з вибраними блоками і не виконує фіналізацію
+на рівні файлів або переміщення в карантин.
+.PP
+Якщо в результаті відновлення отримано дані найкращої спроби (best\-effort),
+щодо яких не можна довести відповідність поточному вмісту, такі блоки все
+одно можуть бути записані під звичайним ім\'ям файлу. Невизначеність, пов\'язана
+з цими відновленими блоками, не зберігається після завершення команди.
+.PP
+Як наслідок, наступний \`fix\` сприйматиме ці доступні для читання блоки як дійсні
+дані файлу і не намагатиметься відновити їх знову. Це може призвести до того,
+що подальше відновлення повідомить про успіх, залишивши у файлі неповні або
+застарілі дані.
+.PP
+Параметри \`\-S\` та \`\-B\` призначені лише для розширеного ручного відновлення,
+зазвичай після збою звичайного \`fix\`. Якщо частковий \`fix\` повідомляє про
+невідновлювані дані, видаліть або перейменуйте уражені файли перед спробою
+повторного відновлення або перевірте їхній вміст вручну.
 .SH Переклад (TRANSLATION) 
 Цей документ є автоматичним перекладом англійського посібника.
 Зверніться до англійського посібника для отримання офіційної версії.
diff --git a/doc/snapraid-uk.d b/doc/snapraid-uk.d
index fb67a0cb..bd66440f 100644
--- a/doc/snapraid-uk.d
+++ b/doc/snapraid-uk.d
@@ -2058,6 +2058,26 @@ Name{number}
 	переконайтеся, що правило `exclude *.unrecoverable` включено до вашої
 	конфігурації, щоб такі файли не відстежувалися в наборі даних парності.
 
+  Відновлення з частковим fix
+	Коли `fix` обмежено за допомогою `-S, --start` або `-B, --count`,
+	SnapRAID працює лише з вибраними блоками і не виконує фіналізацію
+	на рівні файлів або переміщення в карантин.
+
+	Якщо в результаті відновлення отримано дані найкращої спроби (best-effort),
+	щодо яких не можна довести відповідність поточному вмісту, такі блоки все
+	одно можуть бути записані під звичайним ім'ям файлу. Невизначеність, пов'язана
+	з цими відновленими блоками, не зберігається після завершення команди.
+
+	Як наслідок, наступний `fix` сприйматиме ці доступні для читання блоки як дійсні
+	дані файлу і не намагатиметься відновити їх знову. Це може призвести до того,
+	що подальше відновлення повідомить про успіх, залишивши у файлі неповні або
+	застарілі дані.
+
+	Параметри `-S` та `-B` призначені лише для розширеного ручного відновлення,
+	зазвичай після збою звичайного `fix`. Якщо частковий `fix` повідомляє про
+	невідновлювані дані, видаліть або перейменуйте уражені файли перед спробою
+	повторного відновлення або перевірте їхній вміст вручну.
+
 Переклад (Translation)
 	Цей документ є автоматичним перекладом англійського посібника.
 	Зверніться до англійського посібника для отримання офіційної версії.
diff --git a/doc/snapraid-uk.txt b/doc/snapraid-uk.txt
index ebda18c2..5931b412 100644
--- a/doc/snapraid-uk.txt
+++ b/doc/snapraid-uk.txt
@@ -2201,6 +2201,28 @@ SnapRAID використовує стандартне, передбачуван
 переконайтеся, що правило `exclude *.unrecoverable` включено до вашої
 конфігурації, щоб такі файли не відстежувалися в наборі даних парності.
 
+16.7 Відновлення з частковим fix
+--------------------------------
+
+Коли `fix` обмежено за допомогою `-S, --start` або `-B, --count`,
+SnapRAID працює лише з вибраними блоками і не виконує фіналізацію
+на рівні файлів або переміщення в карантин.
+
+Якщо в результаті відновлення отримано дані найкращої спроби (best-effort),
+щодо яких не можна довести відповідність поточному вмісту, такі блоки все
+одно можуть бути записані під звичайним ім'ям файлу. Невизначеність, пов'язана
+з цими відновленими блоками, не зберігається після завершення команди.
+
+Як наслідок, наступний `fix` сприйматиме ці доступні для читання блоки як дійсні
+дані файлу і не намагатиметься відновити їх знову. Це може призвести до того,
+що подальше відновлення повідомить про успіх, залишивши у файлі неповні або
+застарілі дані.
+
+Параметри `-S` та `-B` призначені лише для розширеного ручного відновлення,
+зазвичай після збою звичайного `fix`. Якщо частковий `fix` повідомляє про
+невідновлювані дані, видаліть або перейменуйте уражені файли перед спробою
+повторного відновлення або перевірте їхній вміст вручну.
+
 
 17 Переклад (TRANSLATION)
 =========================
diff --git a/doc/snapraid-zh.1 b/doc/snapraid-zh.1
index 7950977b..01933039 100644
--- a/doc/snapraid-zh.1
+++ b/doc/snapraid-zh.1
@@ -2121,6 +2121,20 @@ Unicode 文件名之间强制实行不区分大小写。因此，Windows 掩盖
 .PP
 请避免对常规文件使用 \`.unrecoverable\` 扩展名，并确保在配置中包含
 \`exclude *.unrecoverable\`，以防止在奇偶校验数据集中跟踪此类文件。
+.SS 部分 fix 恢复 
+当使用 \`\-S, \-\-start\` 或 \`\-B, \-\-count\` 限制 \`fix\` 时，
+SnapRAID 仅对选定的块进行操作，而不执行文件级别的最终化处理或隔离。
+.PP
+如果恢复产生了无法证实代表当前内容的尽力而为（best\-effort）数据，
+此类块仍可能以常规文件名写入。与这些已恢复块相关的不确定性在命令终止后
+不会保留。
+.PP
+因此，后续的 \`fix\` 会将这些可读取的块视为有效的文件数据，并且不会尝试
+再次恢复它们。这可能导致后续恢复报告成功，但在文件中留下不完整或过时的数据。
+.PP
+\`\-S\` 和 \`\-B\` 选项仅适用于高级手动恢复，通常在常规 \`fix\` 失败后使用。
+如果部分 \`fix\` 报告了无法恢复的数据，请在尝试另一次恢复之前删除受影响的
+文件或对其重命名，或者手动验证其内容。
 .SH 翻译 (TRANSLATION) 
 本文档是英文手册的自动翻译。
 请参阅英文手册以获取权威版本。
diff --git a/doc/snapraid-zh.d b/doc/snapraid-zh.d
index 3d2fd899..228fcff4 100644
--- a/doc/snapraid-zh.d
+++ b/doc/snapraid-zh.d
@@ -1623,6 +1623,21 @@ Name{number}
 	请避免对常规文件使用 `.unrecoverable` 扩展名，并确保在配置中包含
 	`exclude *.unrecoverable`，以防止在奇偶校验数据集中跟踪此类文件。
 
+  部分 fix 恢复
+	当使用 `-S, --start` 或 `-B, --count` 限制 `fix` 时，
+	SnapRAID 仅对选定的块进行操作，而不执行文件级别的最终化处理或隔离。
+
+	如果恢复产生了无法证实代表当前内容的尽力而为（best-effort）数据，
+	此类块仍可能以常规文件名写入。与这些已恢复块相关的不确定性在命令终止后
+	不会保留。
+
+	因此，后续的 `fix` 会将这些可读取的块视为有效的文件数据，并且不会尝试
+	再次恢复它们。这可能导致后续恢复报告成功，但在文件中留下不完整或过时的数据。
+
+	`-S` 和 `-B` 选项仅适用于高级手动恢复，通常在常规 `fix` 失败后使用。
+	如果部分 `fix` 报告了无法恢复的数据，请在尝试另一次恢复之前删除受影响的
+	文件或对其重命名，或者手动验证其内容。
+
 翻译 (Translation)
 	本文档是英文手册的自动翻译。
 	请参阅英文手册以获取权威版本。
diff --git a/doc/snapraid-zh.txt b/doc/snapraid-zh.txt
index fd4b11d9..8ec3719e 100644
--- a/doc/snapraid-zh.txt
+++ b/doc/snapraid-zh.txt
@@ -1766,6 +1766,23 @@ Unicode 文件名之间强制实行不区分大小写。因此，Windows 掩盖
 请避免对常规文件使用 `.unrecoverable` 扩展名，并确保在配置中包含
 `exclude *.unrecoverable`，以防止在奇偶校验数据集中跟踪此类文件。
 
+16.7 部分 fix 恢复
+--------------
+
+当使用 `-S, --start` 或 `-B, --count` 限制 `fix` 时，
+SnapRAID 仅对选定的块进行操作，而不执行文件级别的最终化处理或隔离。
+
+如果恢复产生了无法证实代表当前内容的尽力而为（best-effort）数据，
+此类块仍可能以常规文件名写入。与这些已恢复块相关的不确定性在命令终止后
+不会保留。
+
+因此，后续的 `fix` 会将这些可读取的块视为有效的文件数据，并且不会尝试
+再次恢复它们。这可能导致后续恢复报告成功，但在文件中留下不完整或过时的数据。
+
+`-S` 和 `-B` 选项仅适用于高级手动恢复，通常在常规 `fix` 失败后使用。
+如果部分 `fix` 报告了无法恢复的数据，请在尝试另一次恢复之前删除受影响的
+文件或对其重命名，或者手动验证其内容。
+
 
 17 翻译 (TRANSLATION)
 ===================
diff --git a/doc/snapraid.1 b/doc/snapraid.1
index b9074008..f7bfb1c3 100644
--- a/doc/snapraid.1
+++ b/doc/snapraid.1
@@ -2370,6 +2370,25 @@ matches a file being fixed.
 Avoid using the \`.unrecoverable\` extension for regular files, and ensure
 that \`exclude *.unrecoverable\` is included in your configuration to
 prevent such files from being tracked in the parity dataset.
+.SS Partial fix recovery 
+When \`fix\` is restricted using \`\-S, \-\-start\` or \`\-B, \-\-count\`,
+SnapRAID operates only on the selected blocks and does not perform
+file\-level finalization or quarantine.
+.PP
+If recovery produces best\-effort data that cannot be proven to represent
+the current contents, such blocks may still be written under the normal
+filename. The uncertainty associated with these recovered blocks is not
+persisted after the command terminates.
+.PP
+As a consequence, a later \`fix\` will treat these readable blocks as valid
+file data and will not attempt to recover them again. This can cause a
+subsequent recovery to report success while leaving incomplete or stale
+data in the file.
+.PP
+The \`\-S\` and \`\-B\` options are intended only for advanced manual recovery,
+typically after a normal \`fix\` has failed. If a partial \`fix\` reports
+unrecoverable data, remove or rename the affected files before attempting
+another recovery, or verify their contents manually.
 .SH COPYRIGHT 
 This file is Copyright (C) 2026 Andrea Mazzoleni
 .SH SEE ALSO 
diff --git a/doc/snapraid.d b/doc/snapraid.d
index 27a0acf9..8912af71 100644
--- a/doc/snapraid.d
+++ b/doc/snapraid.d
@@ -1872,6 +1872,26 @@ Known Issues
 	that `exclude *.unrecoverable` is included in your configuration to
 	prevent such files from being tracked in the parity dataset.
 
+  Partial fix recovery
+	When `fix` is restricted using `-S, --start` or `-B, --count`,
+	SnapRAID operates only on the selected blocks and does not perform
+	file-level finalization or quarantine.
+
+	If recovery produces best-effort data that cannot be proven to represent
+	the current contents, such blocks may still be written under the normal
+	filename. The uncertainty associated with these recovered blocks is not
+	persisted after the command terminates.
+
+	As a consequence, a later `fix` will treat these readable blocks as valid
+	file data and will not attempt to recover them again. This can cause a
+	subsequent recovery to report success while leaving incomplete or stale
+	data in the file.
+
+	The `-S` and `-B` options are intended only for advanced manual recovery,
+	typically after a normal `fix` has failed. If a partial `fix` reports
+	unrecoverable data, remove or rename the affected files before attempting
+	another recovery, or verify their contents manually.
+
 Copyright
 	This file is Copyright (C) 2026 Andrea Mazzoleni
 
diff --git a/doc/snapraid.txt b/doc/snapraid.txt
index f2112c0e..8acc4653 100644
--- a/doc/snapraid.txt
+++ b/doc/snapraid.txt
@@ -2015,6 +2015,28 @@ Avoid using the `.unrecoverable` extension for regular files, and ensure
 that `exclude *.unrecoverable` is included in your configuration to
 prevent such files from being tracked in the parity dataset.
 
+16.7 Partial fix recovery
+-------------------------
+
+When `fix` is restricted using `-S, --start` or `-B, --count`,
+SnapRAID operates only on the selected blocks and does not perform
+file-level finalization or quarantine.
+
+If recovery produces best-effort data that cannot be proven to represent
+the current contents, such blocks may still be written under the normal
+filename. The uncertainty associated with these recovered blocks is not
+persisted after the command terminates.
+
+As a consequence, a later `fix` will treat these readable blocks as valid
+file data and will not attempt to recover them again. This can cause a
+subsequent recovery to report success while leaving incomplete or stale
+data in the file.
+
+The `-S` and `-B` options are intended only for advanced manual recovery,
+typically after a normal `fix` has failed. If a partial `fix` reports
+unrecoverable data, remove or rename the affected files before attempting
+another recovery, or verify their contents manually.
+
 
 17 COPYRIGHT
 ============