From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <eliz@sourceware.org>
Received: by sourceware.org (Postfix, from userid 1086)
 id 5A45B3948833; Mon, 16 May 2022 16:05:54 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 5A45B3948833
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
From: Eli Zaretskii <eliz@sourceware.org>
To: gdb-cvs@sourceware.org
Subject: [binutils-gdb] gdb: Document the 'metadata' styling in GDB displays.
X-Act-Checkin: binutils-gdb
X-Git-Author: Eli Zaretskii <eliz@gnu.org>
X-Git-Refname: refs/heads/master
X-Git-Oldrev: 1779689128d45ca6fd1d1484f2fd907ac791873e
X-Git-Newrev: 8c9b320a8ee438b5db12d5aaa8c0ba08d1b5c29d
Message-Id: <20220516160554.5A45B3948833@sourceware.org>
Date: Mon, 16 May 2022 16:05:54 +0000 (GMT)
X-BeenThere: gdb-cvs@sourceware.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gdb-cvs mailing list <gdb-cvs.sourceware.org>
List-Unsubscribe: <https://sourceware.org/mailman/options/gdb-cvs>,
 <mailto:gdb-cvs-request@sourceware.org?subject=unsubscribe>
List-Archive: <https://sourceware.org/pipermail/gdb-cvs/>
List-Help: <mailto:gdb-cvs-request@sourceware.org?subject=help>
List-Subscribe: <https://sourceware.org/mailman/listinfo/gdb-cvs>,
 <mailto:gdb-cvs-request@sourceware.org?subject=subscribe>
X-List-Received-Date: Mon, 16 May 2022 16:05:54 -0000

https://sourceware.org/git/gitweb.cgi?p=3Dbinutils-gdb.git;h=3D8c9b320a8ee4=
38b5db12d5aaa8c0ba08d1b5c29d

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.
   =20
    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}.
=20
+@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