Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: Eli Zaretskii via Gdb-patches <gdb-patches@sourceware.org>
To: Lancelot SIX <lsix@lancelotsix.com>
Cc: tom@tromey.com, gdb-patches@sourceware.org
Subject: Re: [PATCH] Fix ptype/o bug with "<no data fields>"
Date: Fri, 23 Apr 2021 14:03:06 +0300	[thread overview]
Message-ID: <83czulntzp.fsf@gnu.org> (raw)
In-Reply-To: <20210423104153.77hotw6yvek2lt4p@Plymouth> (message from Lancelot SIX on Fri, 23 Apr 2021 11:41:53 +0100)

> Date: Fri, 23 Apr 2021 11:41:53 +0100
> From: Lancelot SIX <lsix@lancelotsix.com>
> Cc: Tom Tromey <tom@tromey.com>, gdb-patches@sourceware.org
> 
> The patch that needs to be reviewed for the documentation part it this
> one: https://sourceware.org/pipermail/gdb-patches/2021-April/177843.html

Thanks, see below:

> +When @value{GDBN} prints sizes and offsets of struct members, decimal or
> +hexadecimal notations can be used.  Selecting one or the other can be
> +done either by passing the appropriate flag to @code{ptype}, or by using
> +@command{set print type hex}.

This uses the passive tense too much, and thus is awkward to read.
Suggest to rephrase:

  When @value{GDBN} prints sizes and offsets of struct members, it can
  use either the decimal or hexadecimal notation.  You can select one or
  the other either by passing the appropriate flag to @code{ptype}, or
  by using the @command{set print type hex} command.

> +@item show print type hex
> +This command show the current setting used to configure whether decimal or
> +hexadecimal notation should be used when printing sized and offsets of
> +struct members.

"shows", singular.  But I'd also suggest slight rewording to make the
text simpler:

  This command shows whether the sizes and offsets of struct members
  are printed in decimal or hexadecimal notation.

> +			   _("Show printing of struct members sizes and offsets \
> +			     using hex notation."), nullptr,

I think

 Show whether sizes and offsets of struct members are printed
 using hex notation.

is better.

Thanks.

      reply	other threads:[~2021-04-23 11:03 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-22  1:49 Tom Tromey
2021-04-22  9:31 ` Andrew Burgess
2021-04-22 13:17   ` Tom Tromey
2021-04-22 21:45     ` Lancelot SIX via Gdb-patches
2021-04-23  1:39       ` Tom Tromey
2021-04-23  6:12         ` Eli Zaretskii via Gdb-patches
2021-04-23 10:41           ` Lancelot SIX via Gdb-patches
2021-04-23 11:03             ` Eli Zaretskii via Gdb-patches [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=83czulntzp.fsf@gnu.org \
    --to=gdb-patches@sourceware.org \
    --cc=eliz@gnu.org \
    --cc=lsix@lancelotsix.com \
    --cc=tom@tromey.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox