Re: [PATCH] x86-64: fix HYPERVISOR_update_descriptor()

From: Jan Beulich
Date: Thu Mar 12 2009 - 07:51:44 EST


>>> Ingo Molnar <mingo@xxxxxxx> 12.03.09 12:35 >>>
>* Jan Beulich <jbeulich@xxxxxxxxxx> wrote:
>> I'm confused: What point is there to add a textual description
>> that matches the subject? [...]
>
>For example, under what circumstances did you trigger the bug,
>how widely does it affect people, how did you test it. You are
>sending patches very close to the 2.6.29 release, and your
>commit log is non-existent.
>
>Yes, i can figure out what the patch does, but that is not the
>point.
>
>The point is for you to be forthcoming with such information and
>trying to be helpful to the maintenance process, by properly
>describing changes, by describing how you found the bug, how you
>tested the fix, how significant you find the fix, etc.
>
>I.e. try to emit the information you have about this _already_,
>and generously so, instead of hiding it and forcing others to
>recover it.

Hmm, I'm really just following what I see from many others. And I have
to admit that there are [tiny] patches that really don't need much
explanation (and I often find quite the inverse - huge patches that have
[almost] no description).

>>It might be a small work for me to recover it and
>>put it into the changelog, but many of your past patches showed
>>such a pattern and such overhead mounts up quickly.

I'm sorry for that - I simply wasn't aware I'm causing you to do extra
work. I usually try to be as verbose with patches as seems necessary
to me - after all I have no other way to judge ho much is too little or
too much.

>> [...] And where is the need for an impact line documented
>> (clearly neither SubmitChecklist no SubmittingPatches have any
>> occurrence of the word impact), i.e. what are the valid values
>> to chose from?
>
>See:
>
> http://lkml.org/lkml/2008/10/28/67

Thanks. Would certainly be helpful to put into Documentation/ if this is
meant to be more than just a personal requirement of yours.

Jan

--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/