cleaning up a bunch of the command line documentation

pyglance/glance/config_organizer.py

@@ -433,19 +433,19 @@ def set_up_command_line_options (parser) :
     
     # message related options
     parser.add_option('-q', '--quiet', dest="quiet",
-                    action="store_true", default=False, help="only error output")
+                    action="store_true", default=False, help="only log error output")
     parser.add_option('-v', '--verbose', dest="verbose",
-                    action="store_true", default=False, help="enable more informational output")   
+                    action="store_true", default=False, help="enable logging of more detailed informational output")
     parser.add_option('-w', '--debug', dest="debug",
-                    action="store_true", default=False, help="enable debug output")
+                    action="store_true", default=False, help="enable logging of debug output (warning: this will generate far more messages)")
     parser.add_option('-n', '--version', dest='version',
-                      action="store_true", default=False, help="view the glance version")
+                      action="store_true", default=False, help="print the Glance version")
     
     # data options for setting variable defaults
     parser.add_option('-e', '--epsilon', dest=EPSILON_KEY, type='float', default=0.0,
                     help="set default epsilon value for comparison threshold")   
     parser.add_option('-m', '--missing', dest=OPTIONS_FILL_VALUE_KEY, type='float', default=None,
-                    help="set default missing-value")
+                    help="set default missing-data value")
     
     # longitude and latitude related options
     parser.add_option('-o', '--longitude', dest=OPTIONS_LON_VAR_NAME_KEY, type='string',
@@ -459,26 +459,26 @@ def set_up_command_line_options (parser) :
     
     # output generation related options
     parser.add_option('-p', '--outputpath', dest=OPTIONS_OUTPUT_PATH_KEY, type='string', default='./',
-                    help="set path to output directory")
+                    help="set path to the output directory")
     parser.add_option('-i', '--imagesonly', dest=OPTIONS_NO_REPORT_KEY, 
                       action="store_true", default=False,
-                      help="generate only image files (no html report)")
+                      help="generate only the images (no html report)")
     parser.add_option('-r', '--reportonly', dest=OPTIONS_NO_IMAGES_KEY, 
                       action="store_true", default=False,
-                      help="generate only html report files (no images)")
+                      help="generate only the html report (no images)")
     parser.add_option('-c', '--configfile', dest=OPTIONS_CONFIG_FILE_KEY, type='string', default=None,
-                      help="set optional configuration file")
+                      help="set a configuration file to load (optional)")
     
     # should pass/fail be tested?
     parser.add_option('-x', '--doPassFail', dest=DO_TEST_PASSFAIL_KEY,
-                      action="store_true", default=False, help="should the comparison test for pass/fail (currently only affects stats)")
+                      action="store_true", default=False, help="test for pass/fail while comparing data (only affects analysis where data is compared)")
     
     # whether or not to do multiprocessing
     parser.add_option('-f', '--fork', dest=DO_MAKE_FORKS_KEY,
                       action="store_true", default=False, help="start multiple processes to create images in parallel")
 
     parser.add_option('--parsable', dest=PARSABLE_OUTPUT_KEY,
-                      action="store_true", default=False, help="format output to be programmatically parsed. 'info' only")
+                      action="store_true", default=False, help="format output to be programmatically parsed. (only affects 'info')")
 
 def convert_options_to_dict (options) :
     """