The default config now puts the content files in data disks.

HISTORY

@@ -1,6 +1,11 @@
 SnapRAID HISTORY
 ================
 
+1.8 2011/12
+===========
+ * The example configuration files now put the content files in the data
+   disks instead than in the parity disks.
+
 1.7 2011/11
 ===========
 * If a file is modified or removed during a sync, the sync process doesn't

INSTALL

@@ -10,7 +10,7 @@ When you have to check for correctness the application typing:
 
     make check
 
-If if terminates with "Success", you can install the application and
+If it terminates with "Success", you can install the application and
 the documentation running as root:
 
     sudo make install

TODO

@@ -5,6 +5,8 @@ This is the list of TODO items for SnapRAID.
 
 - v1.8
 
+* Check the bug report: https://sourceforge.net/tracker/?func=detail&aid=3437536&group_id=507749&atid=2064492
+
 * In fix an existing symlink with the same name of a file to be recovered may stop
 the process making the create() operation to fail.
 
@@ -17,6 +19,11 @@ with an atomic rename operation.
 
 * Recheck the 2nd issue reported at: https://sourceforge.net/projects/snapraid/forums/forum/1677233/topic/4747897
 
+* If a directory exist with the same name of a parity/content file be more explicative
+on the error message. See: https://sourceforge.net/projects/snapraid/forums/forum/1677233/topic/4861034
+Also adding an estension to these files in the configuration file for Windows may help to understand
+that they are files and not directories.
+
 * Put the content files in the data disks in the default configuration file.
 
 * Easy way to find duplicates using the computed hash.

snapraid.1

@@ -121,16 +121,15 @@ as the redundancy information may grow in size as the biggest data
 disk in the array.
 .PP
 These disks will be dedicated to store the \(a"parity\(a" and \(a"q\(hyparity\(a"
-files. You should not store other data in them, with the only
-possible exception of the \(a"content\(a" files.
+files. You should not store your data in them.
 .PP
-The list of files is stored in the \(a"content\(a" files, usually
+The list of files is saved in the \(a"content\(a" files, usually
 stored in the data, parity or boot disks.
-These files contain the details of your backup with all the
+These files contain the details of your backup, with all the
 checksums to verify its integrity.
-The \(a"content\(a" file is stored in multiple copies, each one in a
-different disk, to ensure that in even in case of multiple disk
-failures at least one copy is available.
+The \(a"content\(a" file is stored in multiple copies, and each one must
+be in a different disk, to ensure that in even in case of multiple
+disk failures at least one copy is available.
 .PP
 For example, suppose that you are interested only at one parity level
 of protection, and that your disks are present in:
@@ -162,11 +161,15 @@ parity /mnt/diskpar/parity
 .PD 0
 .PP
 .PD
-content /mnt/diskpar/content
+content /var/snapraid/content
 .PD 0
 .PP
 .PD
-content /var/snapraid/content
+content /mnt/disk1/content
+.PD 0
+.PP
+.PD
+content /mnt/disk2/content
 .PD 0
 .PP
 .PD
@@ -192,11 +195,15 @@ parity E:\(rspar\(rsparity
 .PD 0
 .PP
 .PD
-content E:\(rspar\(rscontent
+content C:\(rssnapraid\(rscontent
 .PD 0
 .PP
 .PD
-content C:\(rssnapraid\(rscontent
+content F:\(rsarray\(rscontent
+.PD 0
+.PP
+.PD
+content G:\(rsarray\(rscontent
 .PD 0
 .PP
 .PD

snapraid.conf.example

@@ -17,9 +17,9 @@ parity /mnt/diskpar/parity
 # They can be in the disks used for data, parity or boot,
 # but each file must be in a different disk
 # Format: "content FILE_PATH"
-content /mnt/diskpar/content
-#content /mnt/diskqar/content
 content /var/snapraid/content
+content /mnt/disk1/content
+content /mnt/disk2/content
 
 # Defines the data disks to use
 # The order is relevant for parity, do not change it

snapraid.conf.example.windows

@@ -17,9 +17,9 @@ parity E:\par\parity
 # They can be in the disks used for data, parity or boot,
 # but each file must be in a different disk
 # Format: "content FILE_PATH"
-content E:\par\content
-#content F:\qar\content
 content C:\snapraid\content
+content G:\array\content
+content H:\array\content
 
 # Defines the data disks to use
 # The order is relevant for parity, do not change it

snapraid.d

@@ -84,16 +84,15 @@ Getting Started
 	disk in the array.
 
 	These disks will be dedicated to store the "parity" and "q-parity"
-	files. You should not store other data in them, with the only
-	possible exception of the "content" files.
+	files. You should not store your data in them.
 
-	The list of files is stored in the "content" files, usually
+	The list of files is saved in the "content" files, usually
 	stored in the data, parity or boot disks.
-	These files contain the details of your backup with all the
+	These files contain the details of your backup, with all the
 	checksums to verify its integrity.
-	The "content" file is stored in multiple copies, each one in a
-	different disk, to ensure that in even in case of multiple disk
-	failures at least one copy is available.
+	The "content" file is stored in multiple copies, and each one must
+	be in a different disk, to ensure that in even in case of multiple
+	disk failures at least one copy is available.
 
 	For example, suppose that you are interested only at one parity level
 	of protection, and that your disks are present in:
@@ -107,8 +106,9 @@ Getting Started
 	the following options:
 
 		:parity /mnt/diskpar/parity
-		:content /mnt/diskpar/content
 		:content /var/snapraid/content
+		:content /mnt/disk1/content
+		:content /mnt/disk2/content
 		:disk d1 /mnt/disk1/
 		:disk d2 /mnt/disk2/
 		:disk d3 /mnt/disk3/
@@ -117,8 +117,9 @@ Getting Started
 	instead of slashes:
 
 		:parity E:\par\parity
-		:content E:\par\content
 		:content C:\snapraid\content
+		:content F:\array\content
+		:content G:\array\content
 		:disk d1 F:\array\
 		:disk d2 G:\array\
 		:disk d3 H:\array\

snapraid.txt

@@ -97,16 +97,15 @@ as the redundancy information may grow in size as the biggest data
 disk in the array.
 
 These disks will be dedicated to store the "parity" and "q-parity"
-files. You should not store other data in them, with the only
-possible exception of the "content" files.
+files. You should not store your data in them.
 
-The list of files is stored in the "content" files, usually
+The list of files is saved in the "content" files, usually
 stored in the data, parity or boot disks.
-These files contain the details of your backup with all the
+These files contain the details of your backup, with all the
 checksums to verify its integrity.
-The "content" file is stored in multiple copies, each one in a
-different disk, to ensure that in even in case of multiple disk
-failures at least one copy is available.
+The "content" file is stored in multiple copies, and each one must
+be in a different disk, to ensure that in even in case of multiple
+disk failures at least one copy is available.
 
 For example, suppose that you are interested only at one parity level
 of protection, and that your disks are present in:
@@ -120,8 +119,9 @@ you have to create the configuration file /etc/snapraid.conf with
 the following options:
 
     parity /mnt/diskpar/parity
-    content /mnt/diskpar/content
     content /var/snapraid/content
+    content /mnt/disk1/content
+    content /mnt/disk2/content
     disk d1 /mnt/disk1/
     disk d2 /mnt/disk2/
     disk d3 /mnt/disk3/
@@ -130,8 +130,9 @@ If you are in Windows, you should use drive letters and backslashes
 instead of slashes:
 
     parity E:\par\parity
-    content E:\par\content
     content C:\snapraid\content
+    content F:\array\content
+    content G:\array\content
     disk d1 F:\array\
     disk d2 G:\array\
     disk d3 H:\array\