diff options
author | Enze Li <enze.li@hotmail.com> | 2022-06-12 13:24:02 +0800 |
---|---|---|
committer | Enze Li <enze.li@hotmail.com> | 2022-06-18 11:23:12 +0800 |
commit | 153b3c1117d02c2893c5be1b3af53ec7f161a211 (patch) | |
tree | 08203934d98987df4fe21f670afa5a512245a878 | |
parent | 21a527dfc85d62c9e90c65ac4076f517a6b76a48 (diff) | |
download | gdb-153b3c1117d02c2893c5be1b3af53ec7f161a211.zip gdb-153b3c1117d02c2893c5be1b3af53ec7f161a211.tar.gz gdb-153b3c1117d02c2893c5be1b3af53ec7f161a211.tar.bz2 |
gdb/doc: Documentation for the new print command
Document the new command "print nibbles" and add a NEWS entry.
-rw-r--r-- | gdb/NEWS | 5 | ||||
-rw-r--r-- | gdb/doc/gdb.texinfo | 35 |
2 files changed, 36 insertions, 4 deletions
@@ -36,6 +36,11 @@ maintenance show ignore-prologue-end-flag used to force GDB to use prologue analyzers if the line-table is constructed from erroneous debug information. +set print nibbles [on|off] +show print nibbles + This controls whether the 'print/t' command will display binary values + in groups of four bits, known as "nibbles". The default is 'off'. + * Changed commands maintenance info line-table diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 2178b47..b3e995f 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -2142,10 +2142,10 @@ on @code{-} after the command name. For example: @smallexample (@value{GDBP}) print -@key{TAB}@key{TAB} --address -max-depth -pretty -symbol --array -memory-tag-violations -raw-values -union --array-indexes -null-stop -repeats -vtbl --elements -object -static-members +-address -max-depth -object -static-members +-array -memory-tag-violations -pretty -symbol +-array-indexes -nibbles -raw-values -union +-elements -null-stop -repeats -vtbl @end smallexample Completion will in some cases guide you with a suggestion of what kind @@ -10154,6 +10154,10 @@ Set limit on string chars or array elements to print. The value Set the threshold after which nested structures are replaced with ellipsis. Related setting: @ref{set print max-depth}. +@item -nibbles [@code{on}|@code{off}] +Set whether to print binary values in groups of four bits, known +as ``nibbles''. @xref{set print nibbles}. + @item -memory-tag-violations [@code{on}|@code{off}] Set printing of additional information about memory tag violations. @xref{set print memory-tag-violations}. @@ -11518,6 +11522,29 @@ Stop printing element indexes when displaying arrays. Show whether the index of each element is printed when displaying arrays. +@anchor{set print nibbles} +@item set print nibbles +@itemx set print nibbles on +@cindex print binary values in groups of four bits +Print binary values in groups of four bits, known as @dfn{nibbles}, +when using the print command of @value{GDBN} with the option @samp{/t}. +For example, this is what it looks like with @code{set print nibbles on}: + +@smallexample +@group +(@value{GDBP}) print val_flags +$1 = 1230 +(@value{GDBP}) print/t val_flags +$2 = 0100 1100 1110 +@end group +@end smallexample + +@item set print nibbles off +Don't printing binary values in groups. This is the default. + +@item show print nibbles +Show whether to print binary values in groups of four bits. + @anchor{set print elements} @item set print elements @var{number-of-elements} @itemx set print elements unlimited |