Re: [PATCH] gdb: add support for %V to printf command

[Eli Zaretskii <eliz@gnu.org>]

> Cc: Andrew Burgess <aburgess@redhat.com>
> Date: Thu, 30 Mar 2023 13:22:10 +0100
> From: Andrew Burgess via Gdb-patches <gdb-patches@sourceware.org>
> 
> --- a/gdb/NEWS
> +++ b/gdb/NEWS
> @@ -63,6 +63,15 @@
>      break foo thread 1 task 1
>      watch var thread 2 task 3
>  
> +* The printf command now accepts a '%V' output format which will
> +  format an expression just as the 'print' command would.  Print
> +  options can be placed withing '[...]' after the '%V' to modify how
> +  the value is printed.  E.g:
> +    printf "%V", some_array
> +    printf "%V[-array-indexes on]", some_array
> +  Will print the array without, or with array indexes included, just
     ^^^^
That "Will" should not be capitalized.

> --- a/gdb/doc/gdb.texinfo
> +++ b/gdb/doc/gdb.texinfo
> @@ -13131,6 +13131,10 @@
>  
>  @findex $_as_string@r{, convenience function}
>  @item $_as_string(@var{value})
> +This convenience function is considered deprecated, and could be
> +removed from future versions of @value{GDBN}.  Use the @kbd{%V} format
> +specifier instead (@pxref{%V Format Specifier}).       ^^^^^^^^

Please use @samp, not @kbd there, as we are not describing commands
typed by the user.

> +@anchor{%V Format Specifier}
> +Additionally, @code{printf} supports a special @kbd{%V} output format.
                                                  ^^^^^^^^
Likewise.

> +Additionally, it is possible to include print options with the
> +@kbd{%V} format by placing them in @kbd{[...]} immediately after the
> +@kbd{%V}, like this:               ^^^^^^^^^^^
   ^^^^^^^^
@samp again there.

Thanks.

Reviewed-By: Eli Zaretskii <eliz@gnu.org>