Hrrrm, maybe the following change (or something like it) would be good 
for Documentation/Configure.help
===== Configure.help 1.46 vs edited =====
--- 1.46/Documentation/Configure.help   Sat Aug  4 11:40:39 2001
+++ edited/Configure.help       Tue Aug  7 13:27:41 2001
@@ -11706,7 +11706,12 @@
 CONFIG_REISERFS_FS
 
   Stores not just filenames but the files themselves in a balanced
-  tree.  Uses journaling.
+  tree.  Currently uses metatdata-only journaling.
+
+  (NOTE: metadata-only journalling only ensures the filesystem is
+  consistent after a crash, NOT the data! You need data AND metadata
+  journaling to guarantee open files do not get corrupted on a crash.
+  full data journalling is also slower.)
 
   Balanced trees are more efficient than traditional
   filesystem architectural foundations.
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/