Improve the description of the --verbose and --debug options

Author: eregon

src/shared/java/org/truffleruby/shared/options/OptionsCatalog.java

@@ -39,13 +39,13 @@ public class OptionsCatalog {
     public static final BooleanOptionDescription DEBUG = new BooleanOptionDescription(
             OptionCategory.USER,
             "ruby.debug",
-            "Debug (configured by the -d Ruby option)",
+            "Sets $DEBUG to this value (configured by the -d Ruby option)",
             new String[]{"-d"},
             false);
     public static final VerbosityOptionDescription VERBOSITY = new VerbosityOptionDescription(
             OptionCategory.USER,
             "ruby.verbose",
-            "Verbosity (configured by the -v, -w, -W Ruby options)",
+            "Sets $VERBOSE to this value (configured by the -v, -w, -W Ruby options)",
             new String[]{"-v", "-w", "-W"},
             Verbosity.FALSE);
     public static final StringOptionDescription SOURCE_ENCODING = new StringOptionDescription(

tool/options.yml

@@ -3,8 +3,8 @@ USER:
   LOAD_PATHS: [[load-paths, -I], string-array, [], Load paths]
   REQUIRED_LIBRARIES: [[required-libraries, -r], string-array, [], Required libraries]
   WORKING_DIRECTORY: [[working-directory, -C], string, '', Interpreter will switch to this directory]
-  DEBUG: [[debug, -d], boolean, false, Debug]
-  VERBOSITY: [[verbose, -v, -w, -W], enum/verbosity, false, Verbosity]
+  DEBUG: [[debug, -d], boolean, false, 'Sets $DEBUG to this value']
+  VERBOSITY: [[verbose, -v, -w, -W], enum/verbosity, false, 'Sets $VERBOSE to this value']
 
   SOURCE_ENCODING: [[source-encoding, -K], string, '', Source encoding]
   INTERNAL_ENCODING: [[internal-encoding, -E, -U], string, '', Internal encoding]