From: Eli Zaretskii <eliz@gnu.org>
Date: Mon, 16 May 2022 16:03:59 +0000 (+0300)
Subject: gdb: Document the 'metadata' styling in GDB displays.
X-Git-Url: https://git.libre-soc.org/?a=commitdiff_plain;h=8c9b320a8ee438b5db12d5aaa8c0ba08d1b5c29d;p=binutils-gdb.git

gdb: Document the 'metadata' styling in GDB displays.

The 'metadata' styling was never documented in the GDB manual.
This fills that gap.
---

diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo
index 38ad2ac32b0..08d3f703fc9 100644
--- a/gdb/doc/gdb.texinfo
+++ b/gdb/doc/gdb.texinfo
@@ -26425,6 +26425,16 @@ the user attention to some specific parts of their output.  For example,
 the command @command{apropos -v REGEXP} uses the highlight style to
 mark the documentation parts matching @var{regexp}.
 
+@item metadata
+Control the styling of data annotations added by @value{GDBN} to data
+it displays.  By default, this style's intensity is dim.  Metadata
+annotations include the @samp{repeats @var{n} times} annotation for
+suppressed display of repeated array elements (@pxref{Print Strings}),
+@samp{<unavailable>} and @w{@samp{<error @var{descr}>}} annotations
+for errors and @samp{<optimized-out>} annotations for optimized-out
+values in displaying stack frame information in backtraces
+(@pxref{Backtrace}), etc.
+
 @item tui-border
 Control the styling of the TUI border.  Note that, unlike other
 styling options, only the color of the border can be controlled via