From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 5953 invoked by alias); 1 Sep 2011 20:53:21 -0000 Received: (qmail 5944 invoked by uid 22791); 1 Sep 2011 20:53:18 -0000 X-SWARE-Spam-Status: No, hits=-2.0 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,TW_BJ X-Spam-Check-By: sourceware.org Received: from ausxipps301.us.dell.com (HELO ausxipps301.us.dell.com) (143.166.148.223) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Thu, 01 Sep 2011 20:53:01 +0000 X-Loopcount0: from 10.170.28.39 From: To: Date: Thu, 01 Sep 2011 21:23:00 -0000 Subject: Doc: make python function/method descriptions look as in Python Message-ID: <09787EF419216C41A903FD14EE5506DD015343BFAE@AUSX7MCPC103.AMER.DELL.COM> Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-IsSubscribed: yes Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org X-SW-Source: 2011-09/txt/msg00016.txt.bz2 I sent this to the wrong list. Also, I have a copyright assignment in place but no commit privs. paul -----Original Message----- From: Koning, Paul Sent: Wednesday, August 31, 2011 4:47 PM To: gdb@sourceware.org Subject: Doc: make python function/method descriptions look as in Python I found the descriptions of the Python methods/functions hard to read becau= se they are not shown in Python syntax. The attached patch fixes that. P= arentheses now appear wherever they would in the Python code. Also, multip= le optional arguments are shown as [arg1 [, arg2]] since by Python rule you= can omit only consecutive arguments from the right end. (Having them indi= vidually bracketed makes it appear that they can be individually omitted.) paul 2011-08-31 Paul Koning * gdb.texinfo: Make style of Python function and method descriptions match the syntax of Python. Index: gdb.texinfo =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /cvs/src/src/gdb/doc/gdb.texinfo,v retrieving revision 1.857 diff -u -r1.857 gdb.texinfo --- gdb.texinfo 25 Aug 2011 17:59:49 -0000 1.857 +++ gdb.texinfo 31 Aug 2011 20:40:16 -0000 @@ -21005,7 +21005,7 @@ @end defvar @findex gdb.execute -@defun execute command [from_tty] [to_string] +@defun execute (command @r{[}, from_tty @r{[}, to_string@r{]}@r{]}) Evaluate @var{command}, a string, as a @value{GDBN} CLI command. If a GDB exception happens while @var{command} runs, it is translated as = described in @ref{Exception Handling,,Exception Handling}. @@ -21024,13 +21024,13 @@ @end defun @findex gdb.breakpoints -@defun breakpoints +@defun breakpoints () Return a sequence holding all of @value{GDBN}'s breakpoints. @xref{Breakpoints In Python}, for more information. @end defun @findex gdb.parameter -@defun parameter parameter +@defun parameter (parameter) Return the value of a @value{GDBN} parameter. @var{parameter} is a strin= g naming the parameter to look up; @var{parameter} may contain spaces if t= he parameter has a multi-part name. For example, @@ -21043,7 +21043,7 @@ = @end defun @findex gdb.history -@defun history number +@defun history (number) Return a value from @value{GDBN}'s value history (@pxref{Value History}).= @var{number} indicates which history element to return. If @var{number} is negative, then @value{GDBN} will take its absolute valu= e @@ -21058,7 +21058,7 @@ @end defun @findex gdb.parse_and_eval -@defun parse_and_eval expression +@defun parse_and_eval (expression) Parse @var{expression} as an expression in the current language, evaluate= it, and return the result as a @code{gdb.Value}. @var{expression} must be a string. @@ -21070,7 +21070,7 @@ convenience variable (@pxref{Convenience Vars}) as a @code{gdb.Value}. @end defun -@findex gdb.post_event +@findex gdb.post_event () @defun post_event event Put @var{event}, a callable object taking no arguments, into @value{GDBN}= 's internal event queue. This callable will be invoked at @@ -21110,7 +211= 10,7 @@ @end defun @findex gdb.write -@defun write string @r{[}stream{]} +@defun write (string @r{[}, stream{]}) Print a string to @value{GDBN}'s paginated output stream. The optional @= var{stream} determines the stream to print to. The default stream is @val= ue{GDBN}'s standard output stream. Possible stream @@ -21139,7 +21139,7 @@= @end defun @findex gdb.flush -@defun flush +@defun flush () Flush the buffer of a @value{GDBN} paginated stream so that the contents = are displayed immediately. @value{GDBN} will flush the contents of a stre= am automatically when it encounters a newline in the @@ -21170,14 +21170,14= @@ @end defun @findex gdb.target_charset -@defun target_charset +@defun target_charset () Return the name of the current target character set (@pxref{Character Set= s}). This differs from @code{gdb.parameter('target-charset')} in that @sa= mp{auto} is never returned. @end defun @findex gdb.target_wide_charset -@defun target_wide_charset +@defun target_wide_charset () Return the name of the current target wide character set (@pxref{Characte= r Sets}). This differs from @code{gdb.parameter('target-wide-charset')} i= n that @samp{auto} is @@ -21185,7 +21185,7 @@ @end defun @findex gdb.solib_name -@defun solib_name address +@defun solib_name (address) Return the name of the shared library holding the given @var{address} as = a string, or @code{None}. @end defun @@ -21204,7 +21204,7 @@ @code{break} or @code{edit} commands do (@pxref{Specify Location}). @end defun -@defop Operation {@value{GDBN}} prompt_hook current_prompt +@defop Operation {@value{GDBN}} prompt_hook (current_prompt) @anchor{prompt_hook} If @var{prompt_hook} is callable, @value{GDBN} will call the method @@ -21= 383,7 +21383,7 @@ The following methods are provided: @table @code -@defmethod Value __init__ @var{val} +@defmethod Value __init__ (@var{val}) Many Python values can be converted directly to a @code{gdb.Value} via th= is object initializer. Specifically: @@ -21418,14 +21418,14 @@ @end table @end defmethod -@defmethod Value cast type +@defmethod Value cast (type) Return a new instance of @code{gdb.Value} that is the result of casting t= his instance to the type described by @var{type}, which must be a @code{gd= b.Type} object. If the cast cannot be performed for some reason, this met= hod throws an exception. @end defmethod -@defmethod Value dereference +@defmethod Value dereference () For pointer data types, this method returns a new @code{gdb.Value} object = whose contents is the object pointed to by the pointer. For example, if = @code{foo} is a C pointer to an @code{int}, declared in your C program as @= @ -21446,17 +21446,17 @@ value pointed to by @code{foo}. @end defmethod -@defmethod Value dynamic_cast type +@defmethod Value dynamic_cast (type) Like @code{Value.cast}, but works as if the C@t{++} @code{dynamic_cast} o= perator were used. Consult a C@t{++} reference for details. @end defmethod -@defmethod Value reinterpret_cast type +@defmethod Value reinterpret_cast (type) Like @code{Value.cast}, but works as if the C@t{++} @code{reinterpret_cast= } operator were used. Consult a C@t{++} reference for details. @end defmethod -@defmethod Value string @r{[}encoding@r{]} @r{[}errors@r{]} @r{[}length@r{= ]} +@defmethod Value string (@r{[}encoding@r{[}, errors@r{[}, +length@r{]}@r{]}@r{]}) If this @code{gdb.Value} represents a string, then this method converts t= he contents to a Python string. Otherwise, this method will throw an exce= ption. @@ -21488,7 +21488,7 @@ fetched and converted to the given length. @end defmethod -@defmethod Value lazy_string @r{[}encoding@r{]} @r{[}length@r{]} +@defmethod Value lazy_string (@r{[}encoding@r{[}, length@r{]}@r{]}) If this @code{gdb.Value} represents a string, then this method converts t= he contents to a @code{gdb.LazyString} (@pxref{Lazy Strings In Python}). = Otherwise, this method will throw an exception. @@ -21526,7 +21526,7 @@ module: @findex gdb.lookup_type -@defun lookup_type name [block] +@defun lookup_type (name @r{[}, block@r{]}) This function looks up a type by name. @var{name} is the name of the typ= e to look up. It must be a string. @@ -21562,7 +21562,7 @@ The following methods are provided: @table @code -@defmethod Type fields +@defmethod Type fields () For structure and union types, this method returns the fields. Range typ= es have two fields, the minimum and maximum values. Enum types have one f= ield per enum constant. Function and method types have one @@ -21603,7 +21= 603,7 @@ @end table @end defmethod -@defmethod Type array @var{n1} @r{[}@var{n2}@r{]} +@defmethod Type array (@var{n1} @r{[}, @var{n2}@r{]}) Return a new @code{gdb.Type} object which represents an array of this typ= e. If one argument is given, it is the inclusive upper bound of the array= ; in this case the lower bound is zero. If two arguments are @@ -21612,45 = +21612,45 @@ must not be negative, but the bounds can be. @end defmethod -@defmethod Type const +@defmethod Type const () Return a new @code{gdb.Type} object which represents a @code{const}-quali= fied variant of this type. @end defmethod -@defmethod Type volatile +@defmethod Type volatile () Return a new @code{gdb.Type} object which represents a @code{volatile}-qu= alified variant of this type. @end defmethod -@defmethod Type unqualified +@defmethod Type unqualified () Return a new @code{gdb.Type} object which represents an unqualified varia= nt of this type. That is, the result is neither @code{const} nor @code{vo= latile}. @end defmethod -@defmethod Type range +@defmethod Type range () Return a Python @code{Tuple} object that contains two elements: the low b= ound of the argument type and the high bound of that type. If the type do= es not have a range, @value{GDBN} will raise a @code{gdb.error} exception = (@pxref{Exception Handling}). @end defmethod -@defmethod Type reference +@defmethod Type reference () Return a new @code{gdb.Type} object which represents a reference to this = type. @end defmethod -@defmethod Type pointer +@defmethod Type pointer () Return a new @code{gdb.Type} object which represents a pointer to this ty= pe. @end defmethod -@defmethod Type strip_typedefs +@defmethod Type strip_typedefs () Return a new @code{gdb.Type} that represents the real type, after removin= g all layers of typedefs. @end defmethod -@defmethod Type target +@defmethod Type target () Return a new @code{gdb.Type} object which represents the target type of t= his type. @@ -21665,7 +21665,7 @@ exception. @end defmethod -@defmethod Type template_argument n [block] +@defmethod Type template_argument (n @r{[}, block@r{]}) If this @code{gdb.Type} is an instantiation of a template, this will retu= rn a new @code{gdb.Type} which represents the type of the @var{n}th templa= te argument. @@ -21908,7 +21908,7 @@ default pretty-printer for a @code{gdb.Value}: @findex gdb.default_visualizer -@defun default_visualizer value +@defun default_visualizer (value) This function takes a @code{gdb.Value} object as an argument. If a prett= y-printer for this value exists, then it is returned. If no such printer = exists, then this returns @code{None}. @@ -22142,7 +22142,7 @@ The following inferior-related functions are available in the @code{gdb} module: -@defun inferiors +@defun inferiors () Return a tuple containing all inferior objects. @end defun @@ -22167,7 +22167,7 @@ A @code{gdb.Inferior} object has the following methods: @table @code -@defmethod Inferior is_valid +@defmethod Inferior is_valid () Returns @code{True} if the @code{gdb.Inferior} object is valid, @code{Fal= se} if not. A @code{gdb.Inferior} object will become invalid if the infer= ior no longer exists within @value{GDBN}. All other @@ -22175,14 +22175,14= @@ at the time the method is called. @end defmethod -@defmethod Inferior threads +@defmethod Inferior threads () This method returns a tuple holding all the threads which are valid when = it is called. If there are no valid threads, the method will return an em= pty tuple. @end defmethod @findex gdb.read_memory -@defmethod Inferior read_memory address length +@defmethod Inferior read_memory (address, length) Read @var{length} bytes of memory from the inferior, starting at @var{add= ress}. Returns a buffer object, which behaves much like an array or a str= ing. It can be modified and given to the @code{gdb.write_memory} @@ -22190= ,7 +22190,7 @@ @end defmethod @findex gdb.write_memory -@defmethod Inferior write_memory address buffer @r{[}length@r{]} +@defmethod Inferior write_memory (address, buffer @r{[}, length@r{]}) Write the contents of @var{buffer} to the inferior, starting at @var{addr= ess}. The @var{buffer} parameter must be a Python object which supports t= he buffer protocol, i.e., a string, an array or the @@ -22199,7 +22199,7 @@= @end defmethod @findex gdb.search_memory -@defmethod Inferior search_memory address length pattern +@defmethod Inferior search_memory (address, length, pattern) Search a region of the inferior memory starting at @var{address} with the= given @var{length} using the search pattern supplied in @var{pattern}. T= he @var{pattern} parameter must be a Python object @@ -22228,12 +22228,12 @= @ provides methods to register and unregister event handlers: @table @code -@defmethod EventRegistry connect object +@defmethod EventRegistry connect (object) Add the given callable @var{object} to the registry. This object will be = called when an event corresponding to this registry occurs. @end defmethod -@defmethod EventRegistry disconnect object +@defmethod EventRegistry disconnect (object) Remove the given @var{object} from the registry. Once removed, the object= will no longer receive notifications of events. @end defmethod @@ -22341,7 +22341,7 @@ module: @findex gdb.selected_thread -@defun selected_thread +@defun selected_thread () This function returns the thread object for the selected thread. If there= is no selected thread, this will return @code{None}. @end defun @@ -22376,7 +22376,7 @@ A @code{gdb.InferiorThread} object has the following methods: @table @code -@defmethod InferiorThread is_valid +@defmethod InferiorThread is_valid () Returns @code{True} if the @code{gdb.InferiorThread} object is valid, @co= de{False} if not. A @code{gdb.InferiorThread} object will become invalid = if the thread exits, or the inferior that the thread belongs @@ -22384,20 += 22384,20 @@ exception if it is invalid at the time the method is called. @end defmethod -@defmethod InferiorThread switch +@defmethod InferiorThread switch () This changes @value{GDBN}'s currently selected thread to the one represent= ed by this object. @end defmethod -@defmethod InferiorThread is_stopped +@defmethod InferiorThread is_stopped () Return a Boolean indicating whether the thread is stopped. @end defmethod -@defmethod InferiorThread is_running +@defmethod InferiorThread is_running () Return a Boolean indicating whether the thread is running. @end defmethod -@defmethod InferiorThread is_exited +@defmethod InferiorThread is_exited () Return a Boolean indicating whether the thread is exited. @end defmethod @end table @@ -22411,7 +22411,7 @@ command is implemented using an instance of the @code{gdb.Command} class,= most commonly using a subclass. -@defmethod Command __init__ name @var{command_class} @r{[}@var{completer_c= lass}@r{]} @r{[}@var{prefix}@r{]} +@defmethod Command __init__ (name, @var{command_class} @r{[}@, +var{completer_class}@r{[}, var{prefix}@r{]}@r{]}) The object initializer for @code{Command} registers the new command with = @value{GDBN}. This initializer is normally invoked from the subclass' own= @code{__init__} method. @@ -22445,14 +22445,14 @@ @end defmethod @cindex don't repeat Python command -@defmethod Command dont_repeat +@defmethod Command dont_repeat () By default, a @value{GDBN} command is repeated when the user enters a bla= nk line at the command prompt. A command can suppress this behavior by in= voking the @code{dont_repeat} method. This is similar to the user command= @code{dont-repeat}, see @ref{Define, dont-repeat}. @end defmethod -@defmethod Command invoke argument from_tty +@defmethod Command invoke (argument, from_tty) This method is called by @value{GDBN} when this command is invoked. @var{argument} is a string. It is the argument to the command, after @@ -= 22481,7 +22481,7 @@ @end defmethod @cindex completion of Python commands -@defmethod Command complete text word +@defmethod Command complete (text, word) This method is called by @value{GDBN} when the user attempts completion o= n this command. All forms of completion are handled by this method, that = is, the @key{TAB} and @key{M-?} key bindings @@ -22688,7 +22688,7 @@ behav= ior in @value{GDBN}. Similarly, you can define parameters that can be use= d to influence behavior in custom Python scripts and commands. -@defmethod Parameter __init__ name @var{command-class} @var{parameter-clas= s} @r{[}@var{enum-sequence}@r{]} +@defmethod Parameter __init__ (name, @var{command-class}, +@var{parameter-class} @r{[}, @var{enum-sequence}@r{]}) The object initializer for @code{Parameter} registers the new parameter w= ith @value{GDBN}. This initializer is normally invoked from the subclass'= own @code{__init__} method. @@ -22748,14 +22748,14 @@ There are two methods that should be implemented in any @code{Parameter} = class. These are: -@defop Operation {parameter} get_set_string self +@defop Operation {parameter} get_set_string (self) @value{GDBN} will call this method when a @var{parameter}'s value has bee= n changed via the @code{set} API (for example, @kbd{set foo off}). The @code{value} attribute has already been populated with the new value = and may be used in output. This method must return a string. @end defop -@defop Operation {parameter} get_show_string self svalue +@defop Operation {parameter} get_show_string (self, svalue) @value{GDBN} will call this method when a @var{parameter}'s @code{show} A= PI has been invoked (for example, @kbd{show foo}). The argument @code{sva= lue} receives the string representation of the @@ -22842,7 +22842,7 @@ in = Python. A convenience function is an instance of a subclass of the class = @code{gdb.Function}. -@defmethod Function __init__ name +@defmethod Function __init__ (name) The initializer for @code{Function} registers the new function with @valu= e{GDBN}. The argument @var{name} is the name of the function, a string. = The function will be visible to the user as a convenience @@ -22853,7 +2285= 3,7 @@ string for the new class. @end defmethod -@defmethod Function invoke @var{*args} +@defmethod Function invoke (@var{*args}) When a convenience function is evaluated, its arguments are converted to = instances of @code{gdb.Value}, and then the function's @code{invoke} metho= d is called. Note that @value{GDBN} does not @@ -22906,13 +22906,13 @@ @c= ode{gdb} module: @findex gdb.current_progspace -@defun current_progspace +@defun current_progspace () This function returns the program space of the currently selected inferior. @xref{Inferiors and Programs}. @end defun @findex gdb.progspaces -@defun progspaces +@defun progspaces () Return a sequence of all the progspaces currently known to @value{GDBN}. @end defun @@ -22948,7 +22948,7 @@ @code{gdb} module: @findex gdb.current_objfile -@defun current_objfile +@defun current_objfile () When auto-loading a Python script (@pxref{Auto-loading}), @value{GDBN} se= ts the ``current objfile'' to the corresponding objfile. This function re= turns the current objfile. If there is no current objfile, @@ -22956,7 +22= 956,7 @@ @end defun @findex gdb.objfiles -@defun objfiles +@defun objfiles () Return a sequence of all the objfiles current known to @value{GDBN}. @xref{Objfiles In Python}. @end defun @@ -22979,7 +22979,7 @@ A @code{gdb.Objfile} object has the following methods: -@defmethod Objfile is_valid +@defmethod Objfile is_valid () Returns @code{True} if the @code{gdb.Objfile} object is valid, @code{Fals= e} if not. A @code{gdb.Objfile} object can become invalid if the object f= ile it refers to is not loaded in @value{GDBN} any @@ -23009,16 +23009,16 @= @ The following frame-related functions are available in the @code{gdb} mo= dule: @findex gdb.selected_frame -@defun selected_frame +@defun selected_frame () Return the selected frame object. (@pxref{Selection,,Selecting a Frame}). @end defun @findex gdb.newest_frame -@defun newest_frame +@defun newest_frame () Return the newest frame object for the selected thread. @end defun -@defun frame_stop_reason_string reason +@defun frame_stop_reason_string (reason) Return a string explaining the reason why @value{GDBN} stopped unwinding = frames, as expressed by the given @var{reason} code (an integer, see the @= code{unwind_stop_reason} method further down in this section). @@ -23027,19 +23027,19 @@ A @code{gdb.Frame} object has the following methods: @table @code -@defmethod Frame is_valid +@defmethod Frame is_valid () Returns true if the @code{gdb.Frame} object is valid, false if not. A frame object can become invalid if the frame it refers to doesn't exist= anymore in the inferior. All @code{gdb.Frame} methods will throw an exce= ption if it is invalid at the time the method is called. @end defmethod -@defmethod Frame name +@defmethod Frame name () Returns the function name of the frame, or @code{None} if it can't be obt= ained. @end defmethod -@defmethod Frame type +@defmethod Frame type () Returns the type of the frame. The value can be one of: @table @code @item gdb.NORMAL_FRAME @@ -23066,40 +23066,40 @@ @end table @end defmethod -@defmethod Frame unwind_stop_reason +@defmethod Frame unwind_stop_reason () Return an integer representing the reason why it's not possible to find m= ore frames toward the outermost frame. Use @code{gdb.frame_stop_reason_st= ring} to convert the value returned by this function to a string. @end defmethod -@defmethod Frame pc +@defmethod Frame pc () Returns the frame's resume address. @end defmethod -@defmethod Frame block +@defmethod Frame block () Return the frame's code block. @xref{Blocks In Python}. @end defmethod -@defmethod Frame function +@defmethod Frame function () Return the symbol for the function corresponding to this frame. @xref{Symbols In Python}. @end defmethod -@defmethod Frame older +@defmethod Frame older () Return the frame that called this frame. @end defmethod -@defmethod Frame newer +@defmethod Frame newer () Return the frame called by this frame. @end defmethod -@defmethod Frame find_sal +@defmethod Frame find_sal () Return the frame's symtab and line object. @xref{Symbol Tables In Python}. @end defmethod -@defmethod Frame read_var variable @r{[}block@r{]} +@defmethod Frame read_var (variable @r{[}, block@r{]}) Return the value of @var{variable} in this frame. If the optional argume= nt @var{block} is provided, search for the variable from that block; other= wise start at the frame's current block (which is @@ -23108,7 +23108,7 @@ = @code{gdb.Block} object. @end defmethod -@defmethod Frame select +@defmethod Frame select () Set this frame to be the selected frame. @xref{Stack, ,Examining the Sta= ck}. @end defmethod @@ -23132,7 +23132,7 @@ module: @findex gdb.block_for_pc -@defun block_for_pc pc +@defun block_for_pc (pc) Return the @code{gdb.Block} containing the given @var{pc} value. If the = block cannot be found for the @var{pc} value specified, the function will = return @code{None}. @@ -23141,7 +23141,7 @@ A @code{gdb.Block} object has the following methods: @table @code -@defmethod Block is_valid +@defmethod Block is_valid () Returns @code{True} if the @code{gdb.Block} object is valid, @code{False}= if not. A block object can become invalid if the block it refers to does= n't exist anymore in the inferior. All other @@ -23190,7 +23190,7 @@ module: @findex gdb.lookup_symbol -@defun lookup_symbol name @r{[}block@r{]} @r{[}domain@r{]} +@defun lookup_symbol (name @r{[}, block @r{[}, domain@r{]}@r{]}) This function searches for a symbol by name. The search scope can be res= tricted to the parameters defined in the optional domain and block argumen= ts. @@ -23214,7 +23214,7 @@ @end defun @findex gdb.lookup_global_symbol -@defun lookup_global_symbol name @r{[}domain@r{]} +@defun lookup_global_symbol (name @r{[}, domain@r{]}) This function searches for a global symbol by name. The search scope can be restricted to by the domain argument. @@ -23283,7 +23283,7 @@ A @code{gdb.Symbol} object has the following methods: @table @code -@defmethod Symbol is_valid +@defmethod Symbol is_valid () Returns @code{True} if the @code{gdb.Symbol} object is valid, @code{False= } if not. A @code{gdb.Symbol} object can become invalid if the symbol it = refers to does not exist in @value{GDBN} any longer. @@ -23439,7 +23439,7 @@ A @code{gdb.Symtab_and_line} object has the following methods: @table @code -@defmethod Symtab_and_line is_valid +@defmethod Symtab_and_line is_valid () Returns @code{True} if the @code{gdb.Symtab_and_line} object is valid, @c= ode{False} if not. A @code{gdb.Symtab_and_line} object can become invalid= if the Symbol table and line object it refers to does not @@ -23465,7 +234= 65,7 @@ A @code{gdb.Symtab} object has the following methods: @table @code -@defmethod Symtab is_valid +@defmethod Symtab is_valid () Returns @code{True} if the @code{gdb.Symtab} object is valid, @code{False= } if not. A @code{gdb.Symtab} object can become invalid if the symbol tab= le it refers to does not exist in @value{GDBN} any @@ -23473,7 +23473,7 @@ = if it is invalid at the time the method is called. @end defmethod -@defmethod Symtab fullname +@defmethod Symtab fullname () Return the symbol table's source absolute file name. @end defmethod @end table @@ -23487,7 +23487,7 @@ Python code can manipulate breakpoints via the @code{gdb.Breakpoint} clas= s. -@defmethod Breakpoint __init__ spec @r{[}type@r{]} @r{[}wp_class@r{]} @r{[= }internal@r{]} +@defmethod Breakpoint __init__ (spec @r{[}, type @r{[}, wp_class +@r{[},internal@r{]}@r{]}@r{]}) Create a new breakpoint. @var{spec} is a string naming the location of t= he breakpoint, or an expression that defines a watchpoint. The contents c= an be any location recognized by the @@ -23553,7 +23553,7 @@ Read/Write wa= tchpoint. @end table -@defmethod Breakpoint is_valid +@defmethod Breakpoint is_valid () Return @code{True} if this @code{Breakpoint} object is valid, @code{False= } otherwise. A @code{Breakpoint} object can become invalid if the user de= letes the breakpoint. In this case, the object still @@ -23700,7 +23700,7 = @@ A @code{gdb.LazyString} object has the following functions: -@defmethod LazyString value +@defmethod LazyString value () Convert the @code{gdb.LazyString} to a @code{gdb.Value}. This value will= point to the string in memory, but will lose all the delayed retrieval, e= ncoding and handling that @value{GDBN} applies to a