Mirror of the gdb-patches mailing list
 help / color / mirror / Atom feed
From: "Maciej W. Rozycki" <macro@imgtec.com>
To: Yao Qi <qiyaoltc@gmail.com>
Cc: <gdb-patches@sourceware.org>
Subject: Re: [PATCH] Move initialize_tdesc_mips* calls from mips-linux-nat.c to mips-linux-tdep.c
Date: Tue, 16 May 2017 14:01:00 -0000	[thread overview]
Message-ID: <alpine.DEB.2.00.1705161443550.2590@tp.orcam.me.uk> (raw)
In-Reply-To: <86a86k7kmg.fsf@gmail.com>

On Wed, 10 May 2017, Yao Qi wrote:

> >  Why?  These descriptions are only used in the native case, otherwise 
> > gdbserver supplies its own.  The current arrangement has worked for some 
> > 12 years now.
> 
> Because I want these target descriptions be available in -tdep.c files
> so that I can test them without running the test on a mips-linux
> machine.
> 
> Long story is I changed the output of "maint print c-tdesc", and I add a
> test to make sure these generated C files (by this command) is still
> equivalent to the xml files.  If it is not clear to you, I can include
> this patch in my whole patch series.

 Fair enough, although can you please add such details to the patch 
description (as it appears in the actual commit), so that also someone 
looking at it in several years' time have a chance to understand the 
change without the need to wade through mailing list archives?

 It is often the case that a change has to be understood long since it has 
been made and a clear description of the *intent* rather than just a terse 
ChangeLog entry or code modifications themselves is then invaluable, when 
the person who made it is no longer available to answer questions or may 
not remember anymore what exactly the change was about.

 If as you say this is a part of a set of changes, then I think it will be 
enough if you include such a description in the first change and then only 
refer to it by commit ID and heading from any subsequent changes, in 
addition to any change-specific details possibly required.

  Maciej


  reply	other threads:[~2017-05-16 14:01 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2017-05-09 10:07 Yao Qi
2017-05-10 11:52 ` Maciej W. Rozycki
2017-05-10 16:16   ` Yao Qi
2017-05-16 14:01     ` Maciej W. Rozycki [this message]
2017-05-10 16:19   ` John Baldwin
2017-05-16 13:44     ` Maciej W. Rozycki

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=alpine.DEB.2.00.1705161443550.2590@tp.orcam.me.uk \
    --to=macro@imgtec.com \
    --cc=gdb-patches@sourceware.org \
    --cc=qiyaoltc@gmail.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