]> git.ipfire.org Git - thirdparty/binutils-gdb.git/commitdiff
gdb/doc: fix help text for 'set style disassembler enabled'
authorAndrew Burgess <aburgess@redhat.com>
Mon, 17 Feb 2025 10:51:10 +0000 (10:51 +0000)
committerAndrew Burgess <aburgess@redhat.com>
Mon, 24 Feb 2025 16:44:46 +0000 (16:44 +0000)
The help text for 'set/show style disassembler enable' was output of
date.  It talks about GDB requiring the Python Pygments library, but
for many common architectures this is no longer the case, libopcode is
used for styling.

The Python Pygments library is still used as a fallback for those
architectures that libopcode doesn't currently style.

I've updated the help text to try and explain all this.  The manual
was already updated.

Approved-By: Eli Zaretskii <eliz@gnu.org>
gdb/cli/cli-style.c

index 41510828ae3ee169cb3c6d1fd4cd549a6afab165..2e6a43f890b186e7734d3e10f1bd6267b04bd3e5 100644 (file)
@@ -371,9 +371,17 @@ Configure various disassembler style-related variables."),
   add_setshow_boolean_cmd ("enabled", no_class, &disassembler_styling, _("\
 Set whether disassembler output styling is enabled."), _("\
 Show whether disassembler output styling is enabled."), _("\
-If enabled, disassembler output is styled.  Disassembler highlighting\n\
-requires the Python Pygments library, if this library is not available\n\
-then disassembler highlighting will not be possible."
+If enabled, disassembler output is styled.\n\
+\n\
+Disassembler styling requires a library that is able to style the current\n\
+instruction architecture.  By default, GDB will use its builtin library\n\
+for disassembler styling, but this cannot style every architecture.\n\
+\n\
+For architectures that cannot be styled by the builtin disassembler library\n\
+GDB will use the Python Pygments library, if this library is available.\n\
+\n\
+If neither option is able to style the current architecture, then\n\
+disassembler output will be unstyled, even when this option is enabled."
                           ), set_style_enabled, show_style_disassembler,
                           &style_disasm_set_list, &style_disasm_show_list);