aboutsummaryrefslogtreecommitdiffstats
path: root/ChangeLog.README
diff options
context:
space:
mode:
authorChristian Persch <chpe@src.gnome.org>2007-09-19 20:11:50 +0800
committerChristian Persch <chpe@src.gnome.org>2007-09-19 20:11:50 +0800
commitb92fbf15e1841ea4d4e7cc70818d0a60a86f67f3 (patch)
tree3dd5b80608de2ccc5b44d197f081f041e5c4e77a /ChangeLog.README
parent3cc1c9a50b252cb64773e6dadf059a9687a5216c (diff)
downloadgsoc2013-epiphany-b92fbf15e1841ea4d4e7cc70818d0a60a86f67f3.tar.gz
gsoc2013-epiphany-b92fbf15e1841ea4d4e7cc70818d0a60a86f67f3.tar.zst
gsoc2013-epiphany-b92fbf15e1841ea4d4e7cc70818d0a60a86f67f3.zip
Add ChangeLog.README to explain the ChangeLog policy
svn path=/trunk/; revision=7476
Diffstat (limited to 'ChangeLog.README')
-rw-r--r--ChangeLog.README28
1 files changed, 28 insertions, 0 deletions
diff --git a/ChangeLog.README b/ChangeLog.README
new file mode 100644
index 000000000..351490a6b
--- /dev/null
+++ b/ChangeLog.README
@@ -0,0 +1,28 @@
+Epiphany doesn't use ChangeLog anymore. Instead, we use SVN checkin comments
+to autogenerate a ChangeLog file at "make dist" time.
+
+When committing a patch to svn, you must use a checkin comment that fully
+describes the changes made. If the checkin is related to a bug, reference
+the bug number. Example:
+
+ When removing a toolbar, make its items available again in the toolbar
+ editor. (Bug #131182)
+
+Checkin comments MUST use the UTF-8 encoding.
+
+If you forget to check in some changes that belonged in the same commit (e.g.
+you accidentally omitted a file), you must copy the checkin comment from the
+previous, incomplete checkin, and additionally reference that commit's svn
+revision number.
+
+DO NOT use meaningless checkin comments such as "forgotten file" !
+
+If you make a major mistake in the checkin comment (e.g it is empty, or
+you've forgotten to cite the bug numbers), you must create a new checkin
+that touches all files the original checkin changed (just using whitespace
+changes preferably, or fix a random typo), and in the new checkin comment
+you must note that this new checkin fixes the original checkin, referencing
+it by its SVN revision number.
+
+Do NOT commit to this module without permission from a maintainer.
+See the MAINTAINERS file for who they are.