[lmi-commits] [6041] Improve '--help' output

[Greg Chicares]

Revision: 6041
          http://svn.sv.gnu.org/viewvc/?view=rev&root=lmi&revision=6041
Author:   chicares
Date:     2014-12-04 02:40:18 +0000 (Thu, 04 Dec 2014)
Log Message:
-----------
Improve '--help' output

Modified Paths:
--------------
    lmi/trunk/ChangeLog
    lmi/trunk/main_wx_test.cpp

Modified: lmi/trunk/ChangeLog
===================================================================
--- lmi/trunk/ChangeLog 2014-12-02 12:00:14 UTC (rev 6040)
+++ lmi/trunk/ChangeLog 2014-12-04 02:40:18 UTC (rev 6041)
@@ -34690,3 +34690,9 @@
   wx_test_validate_output.cpp
 Document each automated GUI test (VZ).
 
+20141204T0240Z <address@hidden> [516]
+
+  main_wx_test.cpp
+Improve '--help' output. See:
+  http://lists.nongnu.org/archive/html/lmi/2014-11/msg00050.html
+

Modified: lmi/trunk/main_wx_test.cpp
===================================================================
--- lmi/trunk/main_wx_test.cpp  2014-12-02 12:00:14 UTC (rev 6040)
+++ lmi/trunk/main_wx_test.cpp  2014-12-04 02:40:18 UTC (rev 6041)
@@ -159,7 +159,7 @@
     //
     // Return false if the program execution shouldn't continue, currently this
     // is only the case if the "list" option was specified requesting just to
-    // list the available tests.
+    // list the available tests or if the standard "help" option was given.
     bool process_command_line(int& argc, char* argv[]);
 
     // Run all the tests that were configured to be executed (all by default).
@@ -325,6 +325,28 @@
             last_test_option = arg;
             remove_arg(n, argc, argv);
             }
+        else if
+            (
+               0 == std::strcmp(arg, "-h")
+            || 0 == std::strcmp(arg, "--help")
+            )
+            {
+            warning()
+                << "Run automated GUI tests.\n"
+                   "\n"
+                   "Usage: "
+                << argv[0]
+                << "\n"
+                   "  -h,\t--help  \tdisplay this help and exit\n"
+                   "  -l,\t--list  \tlist all available tests and exit\n"
+                   "  -t <name> or \trun only the specified test (may occur\n"
+                   "  --test <name>\tmultiple times); default: run all tests\n"
+                   "\n"
+                   "Additionally, all command line options supported by the\n"
+                   "main lmi executable are also supported."
+                << std::flush;
+            return false;
+            }
         else
             {
             n++;