parser: support --h and --help in wxGUI command line (trac https://trac.osgeo.org/grass/ticket/2152)

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@58783 15284696-431f-4ddb-bdfa-cd5b030d7da7

gui/wxpython/core/utils.py

@@ -496,12 +496,12 @@ def CmdTupleToList(cmd):
     if 'flags' in cmd[1]:
         for flag in cmd[1]['flags']:
             cmdList.append('-' + flag)
-    for flag in ('verbose', 'quiet', 'overwrite'):
+    for flag in ('help', 'verbose', 'quiet', 'overwrite'):
         if flag in cmd[1] and cmd[1][flag] is True:
             cmdList.append('--' + flag)
     
     for k, v in cmd[1].iteritems():
-        if k in ('flags', 'verbose', 'quiet', 'overwrite'):
+        if k in ('flags', 'help', 'verbose', 'quiet', 'overwrite'):
             continue
         cmdList.append('%s=%s' % (k, v))
             
@@ -519,7 +519,7 @@ def CmdToTuple(cmd):
             dcmd[str(key)] = str(value).replace('"', '')
         elif item[:2] == '--': # long flags
             flag = item[2:]
-            if flag in ('verbose', 'quiet', 'overwrite'):
+            if flag in ('help', 'verbose', 'quiet', 'overwrite'):
                 dcmd[str(flag)] = True
         elif len(item) == 2 and item[0] == '-': # -> flags
             if 'flags' not in dcmd:

lib/gis/parser.c

@@ -468,7 +468,7 @@ int G_parser(int argc, char **argv)
 	while (--argc) {
 	    ptr = *(++argv);
 
-	    if (strcmp(ptr, "help") == 0 ||
+	    if (strcmp(ptr, "help") == 0 || strcmp(ptr, "--h") == 0 ||
 		strcmp(ptr, "-help") == 0 || strcmp(ptr, "--help") == 0) {
 		G_usage();
 		exit(EXIT_SUCCESS);

lib/gis/parser_help.c

@@ -155,6 +155,9 @@ static void usage(FILE *fp, int markers)
 	len = show(fp, item, len);
     }
 
+    strcpy(item, " [--help]");
+    len = show(fp, item, len);
+
     strcpy(item, " [--verbose]");
     len = show(fp, item, len);
 
@@ -193,6 +196,7 @@ static void usage(FILE *fp, int markers)
 	fprintf(fp, " --o   %s\n",
 		_("Allow output files to overwrite existing files"));
 
+    fprintf(fp, " --h   %s\n", _("Print usage summary"));
     fprintf(fp, " --v   %s\n", _("Verbose module output"));
     fprintf(fp, " --q   %s\n", _("Quiet module output"));
 

lib/gis/parser_html.c

@@ -128,6 +128,7 @@ void G__usage_html(void)
     if (new_prompt)
 	fprintf(stdout, " [--<b>overwrite</b>] ");
 
+    fprintf(stdout, " [--<b>help</b>] ");
     fprintf(stdout, " [--<b>verbose</b>] ");
     fprintf(stdout, " [--<b>quiet</b>] ");
 
@@ -165,6 +166,9 @@ void G__usage_html(void)
 		    _("Allow output files to overwrite existing files"));
 	}
 
+	fprintf(stdout, "<dt><b>--help</b></dt>\n");
+	fprintf(stdout, "<dd>%s</dd>\n", _("Print usage summary"));
+
 	fprintf(stdout, "<dt><b>--verbose</b></dt>\n");
 	fprintf(stdout, "<dd>%s</dd>\n", _("Verbose module output"));
 

lib/gis/parser_interface.c

@@ -331,6 +331,13 @@ void G__usage_xml(void)
 	fprintf(stdout, "\t</flag>\n");
     }
 
+    /* help */
+    fprintf(stdout, "\t<flag name=\"%s\">\n", "help");
+    fprintf(stdout, "\t\t<description>\n\t\t\t");
+    print_escaped_for_xml(stdout, _("Print usage summary"));
+    fprintf(stdout, "\n\t\t</description>\n");
+    fprintf(stdout, "\t</flag>\n");
+
     /* verbose */
     fprintf(stdout, "\t<flag name=\"%s\">\n", "verbose");
     fprintf(stdout, "\t\t<description>\n\t\t\t");