improved reference

Author: raydac

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/ActionPreprocessorExtensionHandler.java

@@ -11,7 +11,7 @@ public class ActionPreprocessorExtensionHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "class to be used for action directives, the class must be in the classpath and contain default constructor.";
+    return "class for action directives (must be in classpath with default constructor)";
   }
 
   @Override

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/AllowMergeBlockLineHandler.java

@@ -36,7 +36,7 @@ public class AllowMergeBlockLineHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "interpret lines marked by //$\"\"\" and //$$\"\"\" as single text block";
+    return "treat //$\"\"\" and //$$\"\"\" prefixed lines as single text block";
   }
 
   @Override

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/AllowWhitespaceDirectiveHandler.java

@@ -34,7 +34,7 @@ public class AllowWhitespaceDirectiveHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "turn on mode to allow whitespace between the // and the #";
+    return "enable whitespace-tolerant mode between // and #";
   }
 
   @Override
@@ -50,7 +50,6 @@ public boolean processCommandLineKey(final String key, final PreprocessorContext
   }
 
   @Override
-
   public String getKeyName() {
     return ARG_NAME;
   }

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/CareForLastEolHandler.java

@@ -29,7 +29,7 @@ public class CareForLastEolHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "carefully reproduce last line aEOL in result";
+    return "preserve last line EOL in output";
   }
 
   @Override

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/DestinationDirectoryHandler.java

@@ -37,7 +37,7 @@ public class DestinationDirectoryHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "define the destination folder (by default " +
+    return "set destination folder (default " +
         PreprocessorContext.DEFAULT_DEST_DIRECTORY + ')';
   }
 

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/DontOverwriteSameContentHandler.java

@@ -40,7 +40,7 @@ public String getKeyName() {
 
   @Override
   public String getDescription() {
-    return "don't overwrite target file with same content";
+    return "skip writing target file if content unchanged";
   }
 
   @Override

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/ExcludeFoldersHandler.java

@@ -37,7 +37,7 @@ public class ExcludeFoldersHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "folders to be excluded from preprocessing, ANT matcher format allowed. Use system path separator as delimiter.";
+    return "folders to exclude (ANT pattern, delimited by system path separator)";
   }
 
   @Override

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/ExcludedFileExtensionsHandler.java

@@ -39,7 +39,7 @@ public class ExcludedFileExtensionsHandler implements CommandLineHandler {
   @Override
   public String getDescription() {
     return
-        "comma separated file extensions (case insensitive) to be excluded from preprocess and copy (by default " +
+        "comma-separated file extensions to exclude (default: " +
             String.join(",", PreprocessorContext.DEFAULT_EXCLUDED_EXTENSIONS) + ')';
   }
 
@@ -51,7 +51,7 @@ public boolean processCommandLineKey(final String key, final PreprocessorContext
       final String extensions = PreprocessorUtils.extractTrimmedTail(ARG_NAME, key);
       if (!extensions.isEmpty()) {
         context.setExcludeExtensions(
-            Arrays.stream(extensions.split("\\,")).map(String::trim).collect(Collectors.toList()));
+            Arrays.stream(extensions.split(",")).map(String::trim).collect(Collectors.toList()));
         result = true;
       }
     }

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/FileExtensionsHandler.java

@@ -38,7 +38,7 @@ public class FileExtensionsHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "comma separated list of allowed extensions (case insensitive) (by default " +
+    return "comma-separated allowed extensions (default: " +
         String.join(",", PreprocessorContext.DEFAULT_PROCESSING_EXTENSIONS) + ')';
   }
 

jcp/src/main/java/com/igormaznitsa/jcp/cmdline/GlobalVariableDefiningFileHandler.java

@@ -38,7 +38,7 @@ public class GlobalVariableDefiningFileHandler implements CommandLineHandler {
 
   @Override
   public String getDescription() {
-    return "load global variable list from file defined by either path or expression (last one needs @@)";
+    return "load global variables from file (path or @@expression)";
   }
 
   @Override