Em 17-05-2011 06:36, Antonio Ospite escreveu: > On Tue, 17 May 2011 10:54:17 +0200 > Jean-Francois Moine <moinejf@xxxxxxx> 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 majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html