binutils-gdb/gdb/doc
Andrew Burgess 9d2d8a16e1 gdb: add new version style
This commit adds a new 'version' style, which replaces the hard coded
styling currently used for GDB's version string.  GDB's version number
is displayed:

  1. In the output of 'show version', and

  2. When GDB starts up (without the --quiet option).

This new style can only ever affect the first of these two cases as
the second case is printed before GDB has processed any initialization
files, or processed any GDB commands passed on the command line.

However, because the first case exists I think this commit makes
sense, it means the style is no longer hard coded into GDB, and we can
add some tests that the style can be enabled/disabled correctly.

This commit is an alternative to a patch Tom posted here:

  https://sourceware.org/pipermail/gdb-patches/2020-June/169820.html

I've used the style name 'version' instead of 'startup' to reflect
what the style is actually used for.  If other parts of the startup
text end up being highlighted I imagine they would get their own
styles based on what is being highlighted.  I feel this is more inline
with the other style names that are already in use within GDB.

I also decoupled adding this style from the idea of startup options,
and the possibility of auto-saving startup options.  Those ideas can
be explored in later patches.

This commit should probably be considered only a partial solution to
issue PR cli/25956.  The colours of the style are no longer hard
coded, however, it is still impossible to change the styling of the
version string displayed during startup, so in one sense, the styling
of that string is still "hard coded".  A later patch will hopefully
extend GDB to allow it to adjust the version styling before the
initial version string is printed.

gdb/ChangeLog:

	PR cli/25956
	* cli/cli-style.c: Add 'cli/cli-setshow.h' include.
	(version_style): Define.
	(cli_style_option::cli_style_option): Add intensity parameter, and
	use as appropriate.
	(_initialize_cli_style): Register version style set/show commands.
	* cli/cli-style.h (cli_style_option): Add intensity parameter.
	(version_style): Declare.
	* top.c (print_gdb_version): Use version_stype, and styled_string
	to print the GDB version string.

gdb/doc/ChangeLog:

	PR cli/25956
	* gdb.texinfo (Output Styling): Document version style.

gdb/testsuite/ChangeLog:

	PR cli/25956
	* gdb.base/style.exp (run_style_tests): Add version string test.
	(test_startup_version_string): Use version style name.
	* lib/gdb-utils.exp (style): Handle version style name.
2021-01-22 19:09:31 +00:00
..
.gitignore
a4rc.sed
agentexpr.texi Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
all-cfg.texi Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
annotate.texinfo Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
ChangeLog gdb: add new version style 2021-01-22 19:09:31 +00:00
doxy-index.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
Doxyfile-base.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
Doxyfile-gdb-api.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
Doxyfile-gdb-xref.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
Doxyfile-gdbserver.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
fdl.texi
filter-for-doxygen
filter-params.pl
gdb.texinfo gdb: add new version style 2021-01-22 19:09:31 +00:00
gpl.texi
guile.texi Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
lpsrc.sed
Makefile.in Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
psrc.sed
python.texi Add Python support for hardware breakpoints 2021-01-21 18:55:45 +01:00
refcard.tex Manual updates of copyright year range not covered by gdb/copyright.py 2021-01-01 12:13:21 +04:00
stabs.texinfo Update copyright year range in all GDB files 2021-01-01 12:12:21 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt