2009-12-14 10:59:03 +00:00
|
|
|
=== ChangeLog discontinued ===
|
2009-03-24 19:24:21 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
With the move to git, this module is switching from a ChangeLog file to
|
|
|
|
relying on commit messages to provide change history. Please write commit
|
|
|
|
messages in the format described at http://live.gnome.org/Git/CommitMessages
|
2009-03-24 19:24:21 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
Below is a copy of this format:
|
2009-03-18 15:10:21 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
=== begin example commit ===
|
|
|
|
[tag] Short explanation of the commit
|
2009-03-18 15:10:21 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
Longer explanation explaining exactly what's changed, whether any
|
|
|
|
external or private interfaces changed, what bugs were fixed (with bug
|
|
|
|
tracker reference if applicable) and so forth. Be concise but not too brief.
|
|
|
|
=== end example commit ===
|
2009-02-02 12:30:54 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- The commit message is mainly for the other people, so they should be able
|
|
|
|
to understand it now and six months later.
|
2009-02-02 12:30:54 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- Always add a brief description of the commit to the _first_ line of the
|
|
|
|
commit and terminate by two newlines (it will work without the second
|
|
|
|
newline, but that is not nice for the interfaces).
|
2009-02-02 03:32:45 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- First line (the brief description) must only be one sentence and should
|
|
|
|
start with a capital letter unless it starts with a lowercase symbol or
|
|
|
|
identifier. Don't use a trailing period either. Don't exceed 72 characters.
|
2009-02-02 03:32:45 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- You can prefix the first line with one tag, to make it easier to know to
|
|
|
|
which part of the module the commit applies. For example, a commit with
|
|
|
|
"[fish] Make it work with newer fortune" in the gnome-panel module clearly
|
|
|
|
applies to the fish applet.
|
2008-12-22 20:02:29 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- The main description (the body) is normal prose and should use normal
|
|
|
|
punctuation and capital letters where appropriate. Normally, for patches
|
|
|
|
sent to a mailing list it's copied from there. This main description can be
|
|
|
|
empty if the change is self-explanatory (eg: "Add DOAP file").
|
2008-12-22 20:02:29 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- When committing code on behalf of others use the --author option, e.g. git
|
|
|
|
commit -a --author "Joe Coder <joe@coder.org>".
|
2008-12-18 10:49:13 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- When referring to a bug, you can use this form: bgo#12345. Use bgo for
|
|
|
|
bugzilla.gnome.org, but you can also reference bugs in other bug trackers:
|
|
|
|
rh means bugzilla.redhat.com, bnc means bugzilla.novell.com, lp means
|
|
|
|
launchpad.net, etc.
|
2001-07-12 18:43:21 +00:00
|
|
|
|
2009-12-14 10:59:03 +00:00
|
|
|
- When a commit closes a bug, the commit message should contain a line like:
|
|
|
|
Closes: http://bugzilla.gnome.org/show_bug.cgi?id=12345
|