[binutils-gdb] gdb: Document the 'metadata' styling in GDB displays.

[binutils-gdb] gdb: Document the 'metadata' styling in GDB displays.

[Eli Zaretskii]

https://sourceware.org/git/gitweb.cgi?p=binutils-gdb.git;h=8c9b320a8ee438b5db12d5aaa8c0ba08d1b5c29d

commit 8c9b320a8ee438b5db12d5aaa8c0ba08d1b5c29d
Author: Eli Zaretskii <eliz@gnu.org>
Date:   Mon May 16 19:03:59 2022 +0300

    gdb: Document the 'metadata' styling in GDB displays.
    
    The 'metadata' styling was never documented in the GDB manual.
    This fills that gap.

Diff:
---
 gdb/doc/gdb.texinfo | 10 ++++++++++
 1 file changed, 10 insertions(+)

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