Re: Moving GLib and GTK+ to git
- From: Stefan Kost <ensonic hora-obscura de>
- To: Edward Hervey <bilboed gmail com>
- Cc: Kristian Høg, sberg <krh redhat com>, gtk-devel-list gnome org, GNOME i18n list <gnome-i18n gnome org>
- Subject: Re: Moving GLib and GTK+ to git
- Date: Mon, 06 Apr 2009 17:22:43 +0300
Edward Hervey schrieb:
> On Tue, 2009-03-31 at 21:29 +0200, Martin Nordholts wrote:
>
>> Matthias Clasen wrote:
>>
>>> - First line (the brief description) must only be one sentence and
>>> must not start with a capital letter. Don't use a trailing period
>>> either. Don't exceed 76 characters.
>>>
>> Hi,
>>
>> Is there any particular reason for not starting with a capital letter,
>> e.g. are there any tools that depend on it? In general I think a
>> sentence look nicer if it starts with a capital letter, including those
>> that does not end with a period. From a quick look at the most recent
>> commit messages for the Linux kernel and git itself, it does not seem as
>> if they have a rule such as the one above, which makes me even more
>> curious why we should have it.
>>
>
> FWIW, In GStreamer git repositories we use that same rule for the
> one-liner with a subtle variation:
> * We do allow capital letters (seriously, who cares? It looks nice)
> * Considering you want to have as much info as possible in that
> one-liner, we try to prefix it with a word giving a clue as to where the
> work was done (without looking at the modified files). Doesn't apply if
> it's a change accross the whole module.
> Ex :
> "rtspsrc: allow http:// on the proxy setting", or
> "Mark unused arguments using G_GNUC_UNUSED glib macro."
>
> Edward
>
And we have a script to generate the ChangeLog for releases in gst too,
right?
Stefan
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]