X-Git-Url: http://git.efficios.com/?a=blobdiff_plain;f=gdb%2Fdoc%2Fguile.texi;h=c0bff7972f7d3810bb6f9bd55ac8050ac80ce477;hb=7ef412cf72a197d68e532604cc1fa21351adc858;hp=04572fd9467fa3ad372deb8874ac0c36dd94b531;hpb=f2983cc34ec64b01fabd0b5ca5af50ee690e1661;p=deliverable%2Fbinutils-gdb.git diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi index 04572fd946..c0bff7972f 100644 --- a/gdb/doc/guile.texi +++ b/gdb/doc/guile.texi @@ -1,4 +1,4 @@ -@c Copyright (C) 2008-2015 Free Software Foundation, Inc. +@c Copyright (C) 2008--2020 Free Software Foundation, Inc. @c Permission is granted to copy, distribute and/or modify this document @c under the terms of the GNU Free Documentation License, Version 1.3 or @c any later version published by the Free Software Foundation; with the @@ -729,7 +729,7 @@ The result @code{bar} will be a @code{} object holding the value pointed to by @code{foo}. A similar function @code{value-referenced-value} exists which also -returns @code{} objects corresonding to the values pointed to +returns @code{} objects corresponding to the values pointed to by pointer values (and additionally, values referenced by reference values). However, the behavior of @code{value-dereference} differs from @code{value-referenced-value} by the fact that the @@ -1258,7 +1258,7 @@ A string of bits. It is deprecated. An unknown or erroneous type. @item TYPE_CODE_METHOD -A method type, as found in C@t{++} or Java. +A method type, as found in C@t{++}. @item TYPE_CODE_METHODPTR A pointer-to-member-function. @@ -1322,7 +1322,7 @@ Return the enum value represented by @code{} @var{field}. @deffn {Scheme Procedure} field-bitpos field Return the bit position of @code{} @var{field}. This attribute is not available for @code{static} fields (as in -C@t{++} or Java). +C@t{++}). @end deffn @deffn {Scheme Procedure} field-bitsize field @@ -1469,6 +1469,9 @@ object which is convertible to a @value{GDBN} value. If @var{children} is @code{#f}, @value{GDBN} will act as though the value has no children. + +Children may be hidden from display based on the value of @samp{set +print max-depth} (@pxref{Print Settings}). @end table @end deffn @@ -2152,7 +2155,7 @@ A program space, or @dfn{progspace}, represents a symbolic view of an address space. It consists of all of the objfiles of the program. @xref{Objfiles In Guile}. -@xref{Inferiors and Programs, program spaces}, for more details +@xref{Inferiors Connections and Programs, program spaces}, for more details about program spaces. Each progspace is represented by an instance of the @code{} @@ -2175,7 +2178,7 @@ if the program it refers to is not loaded in @value{GDBN} any longer. @deffn {Scheme Procedure} current-progspace This function returns the program space of the currently selected inferior. There is always a current progspace, this never returns @code{#f}. -@xref{Inferiors and Programs}. +@xref{Inferiors Connections and Programs}. @end deffn @deffn {Scheme Procedure} progspaces @@ -2769,7 +2772,7 @@ This domain contains names of labels (for gotos). This domain holds a subset of the @code{SYMBOLS_VAR_DOMAIN}; it contains everything minus functions and types. -@item SYMBOL_FUNCTION_DOMAIN +@item SYMBOL_FUNCTIONS_DOMAIN This domain contains all functions. @item SYMBOL_TYPES_DOMAIN @@ -3127,13 +3130,14 @@ At present, @var{count} must be zero. @end deffn @deffn {Scheme Procedure} breakpoint-thread breakpoint -Return the thread-id for thread-specific breakpoint @var{breakpoint}. -Return #f if @var{breakpoint} is not thread-specific. +Return the global-thread-id for thread-specific breakpoint +@var{breakpoint}. Return #f if @var{breakpoint} is not +thread-specific. @end deffn -@deffn {Scheme Procedure} set-breakpoint-thread! breakpoint thread-id|#f -Set the thread-id for @var{breakpoint} to @var{thread-id}. -If set to @code{#f}, the breakpoint is no longer thread-specific. +@deffn {Scheme Procedure} set-breakpoint-thread! breakpoint global-thread-id|#f +Set the thread-id for @var{breakpoint} to @var{global-thread-id} If +set to @code{#f}, the breakpoint is no longer thread-specific. @end deffn @deffn {Scheme Procedure} breakpoint-task breakpoint @@ -3247,7 +3251,7 @@ most appropriate encoding when the string is printed. @deffn {Scheme Procedure} lazy-string-type lazy-string Return the type that is represented by @var{lazy-string}'s type. -For a lazy string this will always be a pointer type. To +For a lazy string this is a pointer or array type. To resolve this to the lazy string's character type, use @code{type-target-type}. @xref{Types In Guile}. @end deffn @@ -3525,11 +3529,13 @@ returns a port object. One can then read/write memory using that object. @deffn {Scheme Procedure} open-memory @r{[}#:mode mode{]} @r{[}#:start address{]} @r{[}#:size size{]} Return a port object that can be used for reading and writing memory. The port will be open according to @var{mode}, which is the standard -mode argument to Guile port open routines, except that it is -restricted to one of @samp{"r"}, @samp{"w"}, or @samp{"r+"}. For -compatibility @samp{"b"} (binary) may also be present, but we ignore -it: memory ports are binary only. The default is @samp{"r"}, -read-only. +mode argument to Guile port open routines, except that the @samp{"a"} +and @samp{"l"} modes are not supported. +@xref{File Ports,,, guile, GNU Guile Reference Manual}. +The @samp{"b"} (binary) character may be present, but is ignored: +memory ports are binary only. If @samp{"0"} is appended then +the port is marked as unbuffered. +The default is @samp{"r"}, read-only and buffered. The chunk of memory that can be accessed can be bounded. If both @var{start} and @var{size} are unspecified, all of memory can be