Rename "verbs" to "commands" in help messages

README.md

@@ -87,8 +87,7 @@ To get help, use:
 
     requake -h
 
-The different running modes are specified as "verbs" (positional arguments).
-Currently supported verbs are:
+Different commands are available:
 
     sample_config       write sample config file to current directory and exit
     update_config       update an existing config file to the latest version
@@ -105,18 +104,17 @@ Currently supported verbs are:
     plot_cumulative     cumulative plot for one or more families
     map_families        plot families on a map
     flag_family         flag a family of repeating earthquakes as valid or not
-                        valid. Note that all families are valid by default
-                        when first created
+                        valid.
     build_templates     build waveform templates for one or more event
                         families
     scan_templates      scan a continuous waveform stream using one or more
                         templates
 
-Certain running modes (e.g., `plot_pair`) require further arguments (use, e.g.,
+Certain commands (e.g., `plot_pair`) require further arguments (use, e.g.,
 `requake plot_pair -h` to get help).
 
-Requake supports command line tab completion for arguments, thanks to
-[argcomplete](https://kislyuk.github.io/argcomplete/).
+Requake supports command line tab completion for commands and arguments, thanks
+to [argcomplete](https://kislyuk.github.io/argcomplete/).
 To enable command line tab completion, add the following line to your `.bashrc`
 or `.zshrc`:
 

docs/running.rst

@@ -13,8 +13,7 @@ To get help, use:
    requake -h
 
 
-The different running modes are specified as "verbs" (positional arguments).
-Currently supported verbs are:
+Different commands are available:
 
 .. code-block:: text
 
@@ -33,19 +32,18 @@ Currently supported verbs are:
    plot_cumulative     cumulative plot for one or more families
    map_families        plot families on a map
    flag_family         flag a family of repeating earthquakes as valid or not
-                       valid. Note that all families are valid by default
-                       when first created
+                       valid.
    build_templates     build waveform templates for one or more event
                        families
    scan_templates      scan a continuous waveform stream using one or more
                        templates
 
 
-Certain running modes (e.g., ``plot_pair``\ ) require further arguments
+Certain commands (e.g., ``plot_pair``\ ) require further arguments
 (use, e.g., ``requake plot_pair -h`` to get help).
 
-Requake supports command line tab completion for arguments, thanks to
-`argcomplete <https://kislyuk.github.io/argcomplete/>`_.
+Requake supports command line tab completion for commands and arguments, thanks
+to `argcomplete <https://kislyuk.github.io/argcomplete/>`_.
 To enable command line tab completion, add the following line to your
 ``.bashrc`` or ``.zshrc``:
 

requake/config/parse_arguments.py

@@ -46,7 +46,7 @@ def parse_arguments(progname='requake'):
     parser = argparse.ArgumentParser(
         description=f'{progname}: Repeating earthquakes search and analysis.'
     )
-    subparser = parser.add_subparsers(dest='action')
+    subparser = parser.add_subparsers(dest='action', title='commands')
     parser.add_argument(
         '-c',
         '--configfile',
@@ -289,8 +289,7 @@ def parse_arguments(progname='requake'):
     # --- flag_family
     flagfamily = subparser.add_parser(
         'flag_family',
-        help='flag a family of repeating earthquakes as valid or not valid. '
-             'Note that all families are valid by default when first created'
+        help='flag a family of repeating earthquakes as valid or not valid'
     )
     flagfamily.add_argument('family_number')
     flagfamily.add_argument(