summaryrefslogtreecommitdiff
path: root/ChangeLog
diff options
context:
space:
mode:
authorVincent Untz <vuntz@gnome.org>2010-09-20 17:38:57 +0200
committerVincent Untz <vuntz@gnome.org>2010-09-20 17:41:43 +0200
commitd251fa0b4e6aa34dbb99a4ebbe1bb96aa84b0a90 (patch)
treed140f31f69276d49aa7e31b3a5aff78b66965856 /ChangeLog
parentc94139835dad179da5a4967b426a967688ac1092 (diff)
downloadgsettings-desktop-schemas-d251fa0b4e6aa34dbb99a4ebbe1bb96aa84b0a90.tar.gz
misc: Update instructions for commit messages
We're switching to "tag:" instead of "[tag]".
Diffstat (limited to 'ChangeLog')
-rw-r--r--ChangeLog13
1 files changed, 8 insertions, 5 deletions
diff --git a/ChangeLog b/ChangeLog
index f12a383..f329195 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -7,7 +7,7 @@
Below is a copy of this format:
=== begin example commit ===
-[tag] Short explanation of the commit
+tag: Short explanation of the commit
Longer explanation explaining exactly what's changed, whether any
external or private interfaces changed, what bugs were fixed (with bug
@@ -27,13 +27,14 @@ tracker reference if applicable) and so forth. Be concise but not too brief.
- 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
+ "fish: Make it work with newer fortune" in the gnome-panel module clearly
applies to the fish applet.
- 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").
+ sent to a mailing list, the body is copied from there. This main
+ description can be empty if the change is self-explanatory (eg: "Add DOAP
+ file").
- When committing code on behalf of others use the --author option, e.g. git
commit -a --author "Joe Coder <joe@coder.org>".
@@ -41,7 +42,9 @@ tracker reference if applicable) and so forth. Be concise but not too brief.
- 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.
+ launchpad.net, etc. Whenever possible, use the full URL of the bug, though.
- When a commit closes a bug, the commit message should contain a line like:
Closes: http://bugzilla.gnome.org/show_bug.cgi?id=12345
+ or simply:
+ http://bugzilla.gnome.org/show_bug.cgi?id=12345