Update help text for commands implemented in Python
authorTom Tromey <tom@tromey.com>
Sun, 7 Oct 2018 04:01:42 +0000 (22:01 -0600)
committerTom Tromey <tom@tromey.com>
Sun, 7 Oct 2018 04:10:21 +0000 (22:10 -0600)
Philippe pointed out that the "enable frame-filter" help text looked
funny.

While fixing this I noticed a few more problems in the help text of
commands written in Python:

* Trailing newlines
* Wrong style for metasyntactic variables
* Indentation of the text
* ... and finally, I thought the function usage lines didn't need
  that extra newline -- someday I'd like to be able to write a
  "usage" command that just greps for the Usage line, so ideally it
  would be tighter than what was done here

This patch fixes all the problems I noticed.

gdb/ChangeLog
2018-10-06  Tom Tromey  <tom@tromey.com>

* python/lib/gdb/function/strfns.py (_MemEq, _StrLen, _StrEq)
(_RegEx): Reformat help text.
* python/lib/gdb/function/caller_is.py (CallerIs, CallerMatches)
(AnyCallerIs, AnyCallerMatches): Reformat help text.
* python/lib/gdb/function/as_string.py (_AsString): Reformat help
text.
* python/lib/gdb/command/xmethods.py (InfoXMethod)
(EnableXMethod, DisableXMethod): Remove help indentation.
Capitalize meta-syntactic variables.
* python/lib/gdb/command/unwinders.py (InfoUnwinder)
(EnableUnwinder, DisableUnwinder): Remove help indentation.
Capitalize meta-syntactic variables.
* python/lib/gdb/command/explore.py (ExploreCommand)
(ExploreValueCommand, ExploreTypeCommand): Reformat help text.
* python/lib/gdb/command/type_printers.py (InfoTypePrinter)
(EnableTypePrinter, DisableTypePrinter): Remove help indentation.
* python/lib/gdb/command/pretty_printers.py (InfoPrettyPrinter):
Remove help indentation.
(EnablePrettyPrinter, DisablePrettyPrinter): Likewise.
* python/lib/gdb/command/frame_filters.py (EnableFrameFilter)
(DisableFrameFilter, SetFrameFilterPriority)
(ShowFrameFilterPriority, InfoFrameFilter): Reword help text.

gdb/ChangeLog
gdb/python/lib/gdb/command/explore.py
gdb/python/lib/gdb/command/frame_filters.py
gdb/python/lib/gdb/command/pretty_printers.py
gdb/python/lib/gdb/command/type_printers.py
gdb/python/lib/gdb/command/unwinders.py
gdb/python/lib/gdb/command/xmethods.py
gdb/python/lib/gdb/function/as_string.py
gdb/python/lib/gdb/function/caller_is.py
gdb/python/lib/gdb/function/strfns.py

index 28e969cacf5864c205d0703ac2e8e21dcb831f93..719647290d298b1d8d103f23f28de3835ee7c297 100644 (file)
@@ -1,3 +1,28 @@
+2018-10-06  Tom Tromey  <tom@tromey.com>
+
+       * python/lib/gdb/function/strfns.py (_MemEq, _StrLen, _StrEq)
+       (_RegEx): Reformat help text.
+       * python/lib/gdb/function/caller_is.py (CallerIs, CallerMatches)
+       (AnyCallerIs, AnyCallerMatches): Reformat help text.
+       * python/lib/gdb/function/as_string.py (_AsString): Reformat help
+       text.
+       * python/lib/gdb/command/xmethods.py (InfoXMethod)
+       (EnableXMethod, DisableXMethod): Remove help indentation.
+       Capitalize meta-syntactic variables.
+       * python/lib/gdb/command/unwinders.py (InfoUnwinder)
+       (EnableUnwinder, DisableUnwinder): Remove help indentation.
+       Capitalize meta-syntactic variables.
+       * python/lib/gdb/command/explore.py (ExploreCommand)
+       (ExploreValueCommand, ExploreTypeCommand): Reformat help text.
+       * python/lib/gdb/command/type_printers.py (InfoTypePrinter)
+       (EnableTypePrinter, DisableTypePrinter): Remove help indentation.
+       * python/lib/gdb/command/pretty_printers.py (InfoPrettyPrinter):
+       Remove help indentation.
+       (EnablePrettyPrinter, DisablePrettyPrinter): Likewise.
+       * python/lib/gdb/command/frame_filters.py (EnableFrameFilter)
+       (DisableFrameFilter, SetFrameFilterPriority)
+       (ShowFrameFilterPriority, InfoFrameFilter): Reword help text.
+
 2018-10-06  Tom Tromey  <tom@tromey.com>
 
        PR tui/28819:
index 2efd14d97b6e4f73484d968ca1348fddd0cafbe9..0bc475c2daa0cce0038f4d7fa826bfbe93aae50e 100644 (file)
@@ -649,14 +649,11 @@ class ExploreUtils(object):
 class ExploreCommand(gdb.Command):
     """Explore a value or a type valid in the current context.
 
-       Usage:
+Usage: explore ARG
 
-         explore ARG
-
-         - ARG is either a valid expression or a type name.
-         - At any stage of exploration, hit the return key (instead of a
-           choice, if any) to return to the enclosing type or value.
-    """
+- ARG is either a valid expression or a type name.
+- At any stage of exploration, hit the return key (instead of a
+choice, if any) to return to the enclosing type or value."""
 
     def __init__(self):
         super(ExploreCommand, self).__init__(name = "explore",
@@ -689,14 +686,11 @@ class ExploreCommand(gdb.Command):
 class ExploreValueCommand(gdb.Command):
     """Explore value of an expression valid in the current context.
 
-       Usage:
-
-         explore value ARG
+Usage: explore value ARG
 
-         - ARG is a valid expression.
-         - At any stage of exploration, hit the return key (instead of a
-           choice, if any) to return to the enclosing value.
-    """
+- ARG is a valid expression.
+- At any stage of exploration, hit the return key (instead of a
+choice, if any) to return to the enclosing value."""
  
     def __init__(self):
         super(ExploreValueCommand, self).__init__(
@@ -718,17 +712,13 @@ class ExploreValueCommand(gdb.Command):
 
 
 class ExploreTypeCommand(gdb.Command):            
-    """Explore a type or the type of an expression valid in the current
-       context.
-
-       Usage:
+    """Explore a type or the type of an expression.
 
-         explore type ARG
+Usage: explore type ARG
 
-         - ARG is a valid expression or a type name.
-         - At any stage of exploration, hit the return key (instead of a
-           choice, if any) to return to the enclosing type.
-    """
+- ARG is a valid expression or a type name.
+- At any stage of exploration, hit the return key (instead of a
+choice, if any) to return to the enclosing type."""
 
     def __init__(self):
         super(ExploreTypeCommand, self).__init__(
index 16a40ed98edabf156e468b8194f184456b81914c..217fce56ef0db0b08ea5a00fd3137e5de7d7d2a3 100644 (file)
@@ -42,8 +42,7 @@ class ShowFilterPrefixCmd(gdb.Command):
 class InfoFrameFilter(gdb.Command):
     """List all registered Python frame-filters.
 
-    Usage: info frame-filters
-    """
+Usage: info frame-filters"""
 
     def __init__(self):
         super(InfoFrameFilter, self).__init__("info frame-filter",
@@ -112,11 +111,13 @@ def _enable_parse_arg(cmd_name, arg):
 
     argv = gdb.string_to_argv(arg);
     argc = len(argv)
-    if argv[0] == "all" and argc > 1:
-        raise gdb.GdbError(cmd_name + ": with 'all' " \
-                          "you may not specify a filter.")
-    else:
-        if argv[0] != "all" and argc != 2:
+    if argc == 0:
+        raise gdb.GdbError(cmd_name + " requires an argument")
+    if argv[0] == "all":
+        if argc > 1:
+            raise gdb.GdbError(cmd_name + ": with 'all' " \
+                               "you may not specify a filter.")
+    elif argc != 2:
             raise gdb.GdbError(cmd_name + " takes exactly two arguments.")
 
     return argv
@@ -209,19 +210,17 @@ def _complete_frame_filter_name(word, printer_dict):
 class EnableFrameFilter(gdb.Command):
     """GDB command to enable the specified frame-filter.
 
-    Usage: enable frame-filter enable DICTIONARY [NAME]
+Usage: enable frame-filter DICTIONARY [NAME]
 
-    DICTIONARY is the name of the frame filter dictionary on which to
-    operate.  If dictionary is set to "all", perform operations on all
-    dictionaries.  Named dictionaries are: "global" for the global
-    frame filter dictionary, "progspace" for the program space's frame
-    filter dictionary.  If either all, or the two named dictionaries
-    are not specified, the dictionary name is assumed to be the name
-    of the object-file name.
+DICTIONARY is the name of the frame filter dictionary on which to
+operate.  If dictionary is set to "all", perform operations on all
+dictionaries.  Named dictionaries are: "global" for the global
+frame filter dictionary, "progspace" for the program space's frame
+filter dictionary.  If either all, or the two named dictionaries
+are not specified, the dictionary name is assumed to be the name
+of an "objfile" -- a shared library or an executable.
 
-    NAME matches the name of the frame-filter to operate on.  If
-    DICTIONARY is "all", NAME is ignored.
-    """
+NAME matches the name of the frame-filter to operate on."""
     def __init__(self):
         super(EnableFrameFilter, self).__init__("enable frame-filter",
                                                  gdb.COMMAND_DATA)
@@ -242,19 +241,17 @@ class EnableFrameFilter(gdb.Command):
 class DisableFrameFilter(gdb.Command):
     """GDB command to disable the specified frame-filter.
 
-    Usage: disable frame-filter disable DICTIONARY [NAME]
+Usage: disable frame-filter DICTIONARY [NAME]
 
-    DICTIONARY is the name of the frame filter dictionary on which to
-    operate.  If dictionary is set to "all", perform operations on all
-    dictionaries.  Named dictionaries are: "global" for the global
-    frame filter dictionary, "progspace" for the program space's frame
-    filter dictionary.  If either all, or the two named dictionaries
-    are not specified, the dictionary name is assumed to be the name
-    of the object-file name.
+DICTIONARY is the name of the frame filter dictionary on which to
+operate.  If dictionary is set to "all", perform operations on all
+dictionaries.  Named dictionaries are: "global" for the global
+frame filter dictionary, "progspace" for the program space's frame
+filter dictionary.  If either all, or the two named dictionaries
+are not specified, the dictionary name is assumed to be the name
+of an "objfile" -- a shared library or an executable.
 
-    NAME matches the name of the frame-filter to operate on.  If
-    DICTIONARY is "all", NAME is ignored.
-    """
+NAME matches the name of the frame-filter to operate on."""
     def __init__(self):
         super(DisableFrameFilter, self).__init__("disable frame-filter",
                                                   gdb.COMMAND_DATA)
@@ -275,19 +272,19 @@ class DisableFrameFilter(gdb.Command):
 class SetFrameFilterPriority(gdb.Command):
     """GDB command to set the priority of the specified frame-filter.
 
-    Usage: set frame-filter priority DICTIONARY NAME PRIORITY
+Usage: set frame-filter priority DICTIONARY NAME PRIORITY
 
-    DICTIONARY is the name of the frame filter dictionary on which to
-    operate.  Named dictionaries are: "global" for the global frame
-    filter dictionary, "progspace" for the program space's framefilter
-    dictionary.  If either of these two are not specified, the
-    dictionary name is assumed to be the name of the object-file name.
+DICTIONARY is the name of the frame filter dictionary on which to
+operate.  Named dictionaries are: "global" for the global frame
+filter dictionary, "progspace" for the program space's framefilter
+dictionary.  If either of these two are not specified, the
+dictionary name is assumed to be the name of an "objfile" -- a
+shared library or an executable.
 
-    NAME matches the name of the frame filter to operate on.
+NAME matches the name of the frame filter to operate on.
 
-    PRIORITY is the an integer to assign the new priority to the frame
-    filter.
-    """
+PRIORITY is the an integer to assign the new priority to the frame
+filter."""
 
     def __init__(self):
         super(SetFrameFilterPriority, self).__init__("set frame-filter " \
@@ -361,16 +358,16 @@ class SetFrameFilterPriority(gdb.Command):
 class ShowFrameFilterPriority(gdb.Command):
     """GDB command to show the priority of the specified frame-filter.
 
-    Usage: show frame-filter priority DICTIONARY NAME
+Usage: show frame-filter priority DICTIONARY NAME
 
-    DICTIONARY is the name of the frame filter dictionary on which to
-    operate.  Named dictionaries are: "global" for the global frame
-    filter dictionary, "progspace" for the program space's framefilter
-    dictionary.  If either of these two are not specified, the
-    dictionary name is assumed to be the name of the object-file name.
+DICTIONARY is the name of the frame filter dictionary on which to
+operate.  Named dictionaries are: "global" for the global frame
+filter dictionary, "progspace" for the program space's framefilter
+dictionary.  If either of these two are not specified, the
+dictionary name is assumed to be the name of an "objfile" -- a
+shared library or an executable.
 
-    NAME matches the name of the frame-filter to operate on.
-    """
+NAME matches the name of the frame-filter to operate on."""
 
     def __init__(self):
         super(ShowFrameFilterPriority, self).__init__("show frame-filter " \
index a6ee9559a6a6aa2adb0cad2b2e3380cf7d5b2e74..429505f93ecef7db568f4fd8347ffe03f80c7a0b 100644 (file)
@@ -84,16 +84,15 @@ def printer_enabled_p(printer):
 class InfoPrettyPrinter(gdb.Command):
     """GDB command to list all registered pretty-printers.
 
-    Usage: info pretty-printer [object-regexp [name-regexp]]
+Usage: info pretty-printer [OBJECT-REGEXP [NAME-REGEXP]]
 
-    OBJECT-REGEXP is a regular expression matching the objects to list.
-    Objects are "global", the program space's file, and the objfiles within
-    that program space.
+OBJECT-REGEXP is a regular expression matching the objects to list.
+Objects are "global", the program space's file, and the objfiles within
+that program space.
 
-    NAME-REGEXP matches the name of the pretty-printer.
-    Individual printers in a collection are named as
-    printer-name;subprinter-name.
-    """
+NAME-REGEXP matches the name of the pretty-printer.
+Individual printers in a collection are named as
+printer-name;subprinter-name."""
 
     def __init__ (self):
         super(InfoPrettyPrinter, self).__init__("info pretty-printer",
@@ -316,16 +315,15 @@ def do_enable_pretty_printer (arg, flag):
 class EnablePrettyPrinter (gdb.Command):
     """GDB command to enable the specified pretty-printer.
 
-    Usage: enable pretty-printer [object-regexp [name-regexp]]
+Usage: enable pretty-printer [OBJECT-REGEXP [NAME-REGEXP]]
 
-    OBJECT-REGEXP is a regular expression matching the objects to examine.
-    Objects are "global", the program space's file, and the objfiles within
-    that program space.
+OBJECT-REGEXP is a regular expression matching the objects to examine.
+Objects are "global", the program space's file, and the objfiles within
+that program space.
 
-    NAME-REGEXP matches the name of the pretty-printer.
-    Individual printers in a collection are named as
-    printer-name;subprinter-name.
-    """
+NAME-REGEXP matches the name of the pretty-printer.
+Individual printers in a collection are named as
+printer-name;subprinter-name."""
 
     def __init__(self):
         super(EnablePrettyPrinter, self).__init__("enable pretty-printer",
@@ -339,16 +337,15 @@ class EnablePrettyPrinter (gdb.Command):
 class DisablePrettyPrinter (gdb.Command):
     """GDB command to disable the specified pretty-printer.
 
-    Usage: disable pretty-printer [object-regexp [name-regexp]]
+Usage: disable pretty-printer [OBJECT-REGEXP [NAME-REGEXP]]
 
-    OBJECT-REGEXP is a regular expression matching the objects to examine.
-    Objects are "global", the program space's file, and the objfiles within
-    that program space.
+OBJECT-REGEXP is a regular expression matching the objects to examine.
+Objects are "global", the program space's file, and the objfiles within
+that program space.
 
-    NAME-REGEXP matches the name of the pretty-printer.
-    Individual printers in a collection are named as
-    printer-name;subprinter-name.
-    """
+NAME-REGEXP matches the name of the pretty-printer.
+Individual printers in a collection are named as
+printer-name;subprinter-name."""
 
     def __init__(self):
         super(DisablePrettyPrinter, self).__init__("disable pretty-printer",
index 3baf19104ef54c0690b9be9db9d35011a7e72fde..d089c0b4dc57f98b64fc7350267710269e7cc997 100644 (file)
@@ -22,8 +22,7 @@ import gdb
 class InfoTypePrinter(gdb.Command):
     """GDB command to list all registered type-printers.
 
-    Usage: info type-printers
-    """
+Usage: info type-printers"""
 
     def __init__ (self):
         super(InfoTypePrinter, self).__init__("info type-printers",
@@ -101,10 +100,9 @@ class _EnableOrDisableCommand(gdb.Command):
 class EnableTypePrinter(_EnableOrDisableCommand):
     """GDB command to enable the specified type printer.
 
-    Usage: enable type-printer NAME
+Usage: enable type-printer NAME
 
-    NAME is the name of the type-printer.
-    """
+NAME is the name of the type-printer."""
 
     def __init__(self):
         super(EnableTypePrinter, self).__init__(True, "enable type-printer")
@@ -112,10 +110,9 @@ class EnableTypePrinter(_EnableOrDisableCommand):
 class DisableTypePrinter(_EnableOrDisableCommand):
     """GDB command to disable the specified type-printer.
 
-    Usage: disable type-printer NAME
+Usage: disable type-printer NAME
 
-    NAME is the name of the type-printer.
-    """
+NAME is the name of the type-printer."""
 
     def __init__(self):
         super(DisableTypePrinter, self).__init__(False, "disable type-printer")
index f970e726ec6aa6414f190f502655336df73b6458..a6309922b5e3af7532256c1b875eeb7a12e41b57 100644 (file)
@@ -56,18 +56,17 @@ def parse_unwinder_command_args(arg):
 class InfoUnwinder(gdb.Command):
     """GDB command to list unwinders.
 
-    Usage: info unwinder [locus-regexp [name-regexp]]
+Usage: info unwinder [LOCUS-REGEXP [NAME-REGEXP]]
 
-    LOCUS-REGEXP is a regular expression matching the location of the
-    unwinder.  If it is omitted, all registered unwinders from all
-    loci are listed.  A locus can be 'global', 'progspace' to list
-    the unwinders from the current progspace, or a regular expression
-    matching filenames of objfiles.
+LOCUS-REGEXP is a regular expression matching the location of the
+unwinder.  If it is omitted, all registered unwinders from all
+loci are listed.  A locus can be 'global', 'progspace' to list
+the unwinders from the current progspace, or a regular expression
+matching filenames of objfiles.
 
-    NAME-REGEXP is a regular expression to filter unwinder names.  If
-    this omitted for a specified locus, then all registered unwinders
-    in the locus are listed.
-    """
+NAME-REGEXP is a regular expression to filter unwinder names.  If
+this omitted for a specified locus, then all registered unwinders
+in the locus are listed."""
 
     def __init__(self):
         super(InfoUnwinder, self).__init__("info unwinder",
@@ -145,17 +144,15 @@ def do_enable_unwinder(arg, flag):
 class EnableUnwinder(gdb.Command):
     """GDB command to enable unwinders.
 
-    Usage: enable unwinder [locus-regexp [name-regexp]]
-
-    LOCUS-REGEXP is a regular expression specifying the unwinders to
-    enable.  It can 'global', 'progspace', or the name of an objfile
-    within that progspace.
+Usage: enable unwinder [LOCUS-REGEXP [NAME-REGEXP]]
 
-    NAME_REGEXP is a regular expression to filter unwinder names.  If
-    this omitted for a specified locus, then all registered unwinders
-    in the locus are affected.
+LOCUS-REGEXP is a regular expression specifying the unwinders to
+enable.  It can 'global', 'progspace', or the name of an objfile
+within that progspace.
 
-    """
+NAME_REGEXP is a regular expression to filter unwinder names.  If
+this omitted for a specified locus, then all registered unwinders
+in the locus are affected."""
 
     def __init__(self):
         super(EnableUnwinder, self).__init__("enable unwinder",
@@ -169,17 +166,15 @@ class EnableUnwinder(gdb.Command):
 class DisableUnwinder(gdb.Command):
     """GDB command to disable the specified unwinder.
 
-    Usage: disable unwinder [locus-regexp [name-regexp]]
+Usage: disable unwinder [LOCUS-REGEXP [NAME-REGEXP]]
 
-    LOCUS-REGEXP is a regular expression specifying the unwinders to
-    disable.  It can 'global', 'progspace', or the name of an objfile
-    within that progspace.
+LOCUS-REGEXP is a regular expression specifying the unwinders to
+disable.  It can 'global', 'progspace', or the name of an objfile
+within that progspace.
 
-    NAME_REGEXP is a regular expression to filter unwinder names.  If
-    this omitted for a specified locus, then all registered unwinders
-    in the locus are affected.
-
-    """
+NAME_REGEXP is a regular expression to filter unwinder names.  If
+this omitted for a specified locus, then all registered unwinders
+in the locus are affected."""
 
     def __init__(self):
         super(DisableUnwinder, self).__init__("disable unwinder",
index 68315a7ef05ce6fc18618eb1ffdc244c4b8efed0..2baf9ba22fa8b1217b0400f0d1cfcf43768a3055 100644 (file)
@@ -177,21 +177,20 @@ def set_xm_status(arg, status):
 class InfoXMethod(gdb.Command):
     """GDB command to list registered xmethod matchers.
 
-    Usage: info xmethod [locus-regexp [name-regexp]]
-
-    LOCUS-REGEXP is a regular expression matching the location of the
-    xmethod matchers.  If it is omitted, all registered xmethod matchers
-    from all loci are listed.  A locus could be 'global', a regular expression
-    matching the current program space's filename, or a regular expression
-    matching filenames of objfiles.  Locus could be 'progspace' to specify that
-    only xmethods from the current progspace should be listed.
-
-    NAME-REGEXP is a regular expression matching the names of xmethod
-    matchers.  If this omitted for a specified locus, then all registered
-    xmethods in the locus are listed.  To list only a certain xmethods
-    managed by a single matcher, the name regexp can be specified as
-    matcher-name-regexp;xmethod-name-regexp.
-    """
+Usage: info xmethod [LOCUS-REGEXP [NAME-REGEXP]]
+
+LOCUS-REGEXP is a regular expression matching the location of the
+xmethod matchers.  If it is omitted, all registered xmethod matchers
+from all loci are listed.  A locus could be 'global', a regular expression
+matching the current program space's filename, or a regular expression
+matching filenames of objfiles.  Locus could be 'progspace' to specify that
+only xmethods from the current progspace should be listed.
+
+NAME-REGEXP is a regular expression matching the names of xmethod
+matchers.  If this omitted for a specified locus, then all registered
+xmethods in the locus are listed.  To list only a certain xmethods
+managed by a single matcher, the name regexp can be specified as
+matcher-name-regexp;xmethod-name-regexp."""
 
     def __init__(self):
         super(InfoXMethod, self).__init__("info xmethod",
@@ -213,21 +212,20 @@ class InfoXMethod(gdb.Command):
 class EnableXMethod(gdb.Command):
     """GDB command to enable a specified (group of) xmethod(s).
 
-    Usage: enable xmethod [locus-regexp [name-regexp]]
+Usage: enable xmethod [LOCUS-REGEXP [NAME-REGEXP]]
 
-    LOCUS-REGEXP is a regular expression matching the location of the
-    xmethod matchers.  If it is omitted, all registered xmethods matchers
-    from all loci are enabled.  A locus could be 'global', a regular expression
-    matching the current program space's filename, or a regular expression
-    matching filenames of objfiles.  Locus could be 'progspace' to specify that
-    only xmethods from the current progspace should be enabled.
+LOCUS-REGEXP is a regular expression matching the location of the
+xmethod matchers.  If it is omitted, all registered xmethods matchers
+from all loci are enabled.  A locus could be 'global', a regular expression
+matching the current program space's filename, or a regular expression
+matching filenames of objfiles.  Locus could be 'progspace' to specify that
+only xmethods from the current progspace should be enabled.
 
-    NAME-REGEXP is a regular expression matching the names of xmethods
-    within a given locus.  If this omitted for a specified locus, then all
-    registered xmethod matchers in the locus are enabled.  To enable only
-    a certain xmethods managed by a single matcher, the name regexp can be
-    specified as matcher-name-regexp;xmethod-name-regexp.
-    """
+NAME-REGEXP is a regular expression matching the names of xmethods
+within a given locus.  If this omitted for a specified locus, then all
+registered xmethod matchers in the locus are enabled.  To enable only
+a certain xmethods managed by a single matcher, the name regexp can be
+specified as matcher-name-regexp;xmethod-name-regexp."""
 
     def __init__(self):
         super(EnableXMethod, self).__init__("enable xmethod",
@@ -240,21 +238,20 @@ class EnableXMethod(gdb.Command):
 class DisableXMethod(gdb.Command):
     """GDB command to disable a specified (group of) xmethod(s).
 
-    Usage: disable xmethod [locus-regexp [name-regexp]]
+Usage: disable xmethod [LOCUS-REGEXP [NAME-REGEXP]]
 
-    LOCUS-REGEXP is a regular expression matching the location of the
-    xmethod matchers.  If it is omitted, all registered xmethod matchers
-    from all loci are disabled.  A locus could be 'global', a regular
-    expression matching the current program space's filename, or a regular
-    expression filenames of objfiles. Locus could be 'progspace' to specify
-    that only xmethods from the current progspace should be disabled.
+LOCUS-REGEXP is a regular expression matching the location of the
+xmethod matchers.  If it is omitted, all registered xmethod matchers
+from all loci are disabled.  A locus could be 'global', a regular
+expression matching the current program space's filename, or a regular
+expression filenames of objfiles. Locus could be 'progspace' to specify
+that only xmethods from the current progspace should be disabled.
 
-    NAME-REGEXP is a regular expression matching the names of xmethods
-    within a given locus.  If this omitted for a specified locus, then all
-    registered xmethod matchers in the locus are disabled.  To disable
-    only a certain xmethods managed by a single matcher, the name regexp
-    can be specified as matcher-name-regexp;xmethod-name-regexp.
-    """
+NAME-REGEXP is a regular expression matching the names of xmethods
+within a given locus.  If this omitted for a specified locus, then all
+registered xmethod matchers in the locus are disabled.  To disable
+only a certain xmethods managed by a single matcher, the name regexp
+can be specified as matcher-name-regexp;xmethod-name-regexp."""
 
     def __init__(self):
         super(DisableXMethod, self).__init__("disable xmethod",
index faa65e3a0fe9f7bcb7e8a21bf6a558898d746a5b..2bc8f174bf65b34301e2cfaf882aa86f4afb5bf9 100644 (file)
@@ -19,16 +19,14 @@ import gdb
 class _AsString(gdb.Function):
     """Return the string representation of a value.
 
-Usage:
-  $_as_string(value)
+Usage: $_as_string (VALUE)
 
 Arguments:
 
-  value: A gdb.Value.
+  VALUE: any value
 
 Returns:
-  The string representation of the value.
-"""
+  The string representation of the value."""
 
     def __init__(self):
         super(_AsString, self).__init__("_as_string")
index 49aa41c7096380ab744116fb218365ed1488473e..081dcbe6e2563bbdbde0f5592feb30a619c73184 100644 (file)
@@ -20,21 +20,19 @@ import re
 class CallerIs(gdb.Function):
     """Check the calling function's name.
 
-Usage:
-  $_caller_is(name [, number_of_frames])
+Usage: $_caller_is (NAME [, NUMBER-OF-FRAMES])
 
 Arguments:
 
-  name: The name of the function to search for.
+  NAME: The name of the function to search for.
 
-  number_of_frames: How many stack frames to traverse back from the currently
+  NUMBER-OF-FRAMES: How many stack frames to traverse back from the currently
     selected frame to compare with.  If the value is greater than the depth of
     the stack from that point then the result is False.
     The default is 1.
 
 Returns:
-  True if the function's name at the specified frame is equal to name.
-"""
+  True if the function's name at the specified frame is equal to NAME."""
 
     def __init__(self):
         super(CallerIs, self).__init__("_caller_is")
@@ -53,21 +51,19 @@ Returns:
 class CallerMatches(gdb.Function):
     """Compare the calling function's name with a regexp.
 
-Usage:
-  $_caller_matches(regex [, number_of_frames])
+Usage: $_caller_matches (REGEX [, NUMBER-OF-FRAMES])
 
 Arguments:
 
-  regex: The regular expression to compare the function's name with.
+  REGEX: The regular expression to compare the function's name with.
 
-  number_of_frames: How many stack frames to traverse back from the currently
+  NUMBER-OF-FRAMES: How many stack frames to traverse back from the currently
     selected frame to compare with.  If the value is greater than the depth of
     the stack from that point then the result is False.
     The default is 1.
 
 Returns:
-  True if the function's name at the specified frame matches regex.
-"""
+  True if the function's name at the specified frame matches REGEX."""
 
     def __init__(self):
         super(CallerMatches, self).__init__("_caller_matches")
@@ -86,21 +82,19 @@ Returns:
 class AnyCallerIs(gdb.Function):
     """Check all calling function's names.
 
-Usage:
-  $_any_caller_is(name [, number_of_frames])
+Usage: $_any_caller_is (NAME [, NUMBER-OF-FRAMES])
 
 Arguments:
 
-  name: The name of the function to search for.
+  NAME: The name of the function to search for.
 
-  number_of_frames: How many stack frames to traverse back from the currently
+  NUMBER-OF-FRAMES: How many stack frames to traverse back from the currently
     selected frame to compare with.  If the value is greater than the depth of
     the stack from that point then the result is False.
     The default is 1.
 
 Returns:
-  True if any function's name is equal to name.
-"""
+  True if any function's name is equal to NAME."""
 
     def __init__(self):
         super(AnyCallerIs, self).__init__("_any_caller_is")
@@ -121,21 +115,19 @@ Returns:
 class AnyCallerMatches(gdb.Function):
     """Compare all calling function's names with a regexp.
 
-Usage:
-  $_any_caller_matches(regex [, number_of_frames])
+Usage: $_any_caller_matches (REGEX [, NUMBER-OF-FRAMES])
 
 Arguments:
 
-  regex: The regular expression to compare the function's name with.
+  REGEX: The regular expression to compare the function's name with.
 
-  number_of_frames: How many stack frames to traverse back from the currently
+  NUMBER-OF-FRAMES: How many stack frames to traverse back from the currently
     selected frame to compare with.  If the value is greater than the depth of
     the stack from that point then the result is False.
     The default is 1.
 
 Returns:
-  True if any function's name matches regex.
-"""
+  True if any function's name matches REGEX."""
 
     def __init__(self):
         super(AnyCallerMatches, self).__init__("_any_caller_matches")
index 47620f3893b360b055764f8b1d2039bba375e48e..70772c9804f8cd737377bd00eaf880b6b14e0c7f 100644 (file)
@@ -23,12 +23,10 @@ import re
 class _MemEq(gdb.Function):
   """$_memeq - compare bytes of memory
 
-Usage:
-  $_memeq(a, b, len)
+Usage: $_memeq (A, B, LEN)
 
 Returns:
-  True if len bytes at a and b compare equally.
-"""
+  True if LEN bytes at A and B compare equally."""
   def __init__(self):
     super(_MemEq, self).__init__("_memeq")
 
@@ -48,12 +46,10 @@ Returns:
 class _StrLen(gdb.Function):
   """$_strlen - compute string length
 
-Usage:
-  $_strlen(a)
+Usage: $_strlen (A)
 
 Returns:
-  Length of string a, assumed to be a string in the current language.
-"""
+  Length of string A, assumed to be a string in the current language."""
   def __init__(self):
     super(_StrLen, self).__init__("_strlen")
 
@@ -65,16 +61,14 @@ Returns:
 class _StrEq(gdb.Function):
   """$_streq - check string equality
 
-Usage:
-  $_streq(a, b)
+Usage: $_streq (A, B)
 
 Returns:
-  True if a and b are identical strings in the current language.
+  True if A and B are identical strings in the current language.
 
 Example (amd64-linux):
   catch syscall open
-  cond $bpnum $_streq((char*) $rdi, "foo")
-"""
+  cond $bpnum $_streq((char*) $rdi, "foo")"""
   def __init__(self):
     super(_StrEq, self).__init__("_streq")
 
@@ -85,13 +79,11 @@ Example (amd64-linux):
 class _RegEx(gdb.Function):
   """$_regex - check if a string matches a regular expression
 
-Usage:
-  $_regex(string, regex)
+Usage: $_regex (STRING, REGEX)
 
 Returns:
-  True if string str (in the current language) matches the
-  regular expression regex.
-"""
+  True if string STRING (in the current language) matches the
+  regular expression REGEX."""
   def __init__(self):
     super(_RegEx, self).__init__("_regex")