DOC: Better source code documentation.

src/main/java/caosdb/server/jobs/core/CheckFileStorageConsistency.java

@@ -50,7 +50,12 @@ import org.jdom2.output.XMLOutputter;
     loadOnDefault = false,
     transaction = Retrieve.class,
     description =
-        "Invokes a consistency test of the file storage. The value is a string with a timeout (prefixed -t), a filesystem location which children are checked recursively, or a test case (prefixed -c)which can be run if the server is in debug mode.")
+        "Invokes a consistency test of the file storage. The value can have any of:\n"
+            + "  - a string with a timeout in ms (prefixed -t): `-t 120000`\n"
+            + "  - a test case which can be run if the server is in debug mode (prefixed\n"
+            + "    -c)\n"
+            + "  - a filesystem location whose children are checked recursively,\n"
+            + "    relative to the caosroot dilesystem location.\n")
 public class CheckFileStorageConsistency extends FlagJob {
 
   public static final Pattern parseArgs =

src/main/java/caosdb/server/utils/FileStorageConsistencyCheck.java

@@ -82,6 +82,7 @@ public class FileStorageConsistencyCheck extends Thread
         }
 
         final String path = iterator.next();
+        // FIXME this prevents all files with ".thumbnail" from being checked.
         if (path.contains(".thumbnail")) {
           continue;
         }