Em 17-05-2011 06:36, Antonio Ospite escreveu:
> On Tue, 17 May 2011 10:54:17 +0200
> Jean-Francois Moine <moin...@free.fr> wrote:
> 
>> The following changes since commit
>> f9b51477fe540fb4c65a05027fdd6f2ecce4db3b:
>>
>>   [media] DVB: return meaningful error codes in dvb_frontend (2011-05-09 
>> 05:47:20 +0200)
>>
>> are available in the git repository at:
>>   git://linuxtv.org/jfrancois/gspca.git for_v2.6.40
>>
> [...]
> 
> Hi Jean-Francois, sometimes it is useful to add also a "why" section to
> commit messages so others can follow your thoughts, and even learn from
> them.
> 
> I have this very simple scheme: a summary of the "what" goes into the
> short commit message and the "why" and "how" go into the long commit
> message when they are not immediately trivial from the code; for
> instance the "why" of the USB trace changes in this series wasn't
> trivial to me.

Yeah, providing a good documentation is important to allow the others to know 
what's
happening at the driver.

Jean-Francois,

Could you please add more comments to your patch series? I'll discard this pull
request from my queue. So, feel free to re-base your tree if you need.

Thanks,
Mauro
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to