From: Eli Zaretskii <eliz@gnu.org>
To: "Metzger\, Markus T" <markus.t.metzger@intel.com>
Cc: gdb-patches@sourceware.org
Subject: Re: [PATCH 2/2] btrace: set/show record btrace cpu
Date: Mon, 26 Feb 2018 19:13:00 -0000 [thread overview]
Message-ID: <83lgff1s4n.fsf@gnu.org> (raw)
In-Reply-To: <A78C989F6D9628469189715575E55B236964BF9A@IRSMSX104.ger.corp.intel.com> (markus.t.metzger@intel.com)
> From: "Metzger, Markus T" <markus.t.metzger@intel.com>
> CC: "gdb-patches@sourceware.org" <gdb-patches@sourceware.org>
> Date: Mon, 26 Feb 2018 15:45:36 +0000
> > > +@item set record btrace cpu @var{identifier} Set the processor to be
> > > +used for enabling trace decode errata workarounds.
> >
> > I think we need to say something about just what those "errata workarounds"
> > are, and what are they used for.
>
> I rephrased this to "... for enabling workarounds for processor errata when
> decoding the trace".
It's better, but still not clear enough. What kind of "errata" are we
talking about? The kind described in
https://community.amd.com/thread/186609, for example? And what do the
workarounds do?
If you can explain that to me or give an example, I will try to
propose some text to describe that in the manual.
> > > + add_prefix_cmd ("cpu", class_support, cmd_set_record_btrace_cpu,
> > > + _("\
> > > +Set the cpu to be used for trace decode.\n\n\ The format is
> > > +\"<vendor>: <identifier>\" or \"none\" or \"auto\" (default).
> > ^^
> > So should there be a blank after the colon, or shouldn't there be?
> > The example in the manual says no blank.
>
> White space is ignored. Do we write this explicitly?
Not necessarily. But I'd prefer us to consistently use one of the
forms.
The rest of the patch LGTM, thanks.
next prev parent reply other threads:[~2018-02-26 19:13 UTC|newest]
Thread overview: 19+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-02-23 9:52 [PATCH 1/2] btrace: fix output of "set record btrace" Markus Metzger
2018-02-23 9:52 ` [PATCH 2/2] btrace: set/show record btrace cpu Markus Metzger
2018-02-23 13:52 ` Eli Zaretskii
2018-02-26 15:45 ` Metzger, Markus T
2018-02-26 19:13 ` Eli Zaretskii [this message]
2018-02-27 11:41 ` Metzger, Markus T
2018-02-27 18:23 ` Eli Zaretskii
2018-02-28 7:38 ` Metzger, Markus T
2018-02-28 15:37 ` Eli Zaretskii
2018-03-01 7:05 ` Metzger, Markus T
2018-03-01 14:48 ` Eli Zaretskii
2018-03-01 16:24 ` Metzger, Markus T
2018-03-01 19:08 ` Eli Zaretskii
2018-03-02 7:09 ` Metzger, Markus T
2018-03-02 14:50 ` Maciej W. Rozycki
2018-03-02 15:39 ` Eli Zaretskii
2018-03-02 19:04 ` Maciej W. Rozycki
2018-03-02 19:49 ` Maciej W. Rozycki
2018-03-05 10:58 ` Metzger, Markus T
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=83lgff1s4n.fsf@gnu.org \
--to=eliz@gnu.org \
--cc=gdb-patches@sourceware.org \
--cc=markus.t.metzger@intel.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;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).