From b92fbf15e1841ea4d4e7cc70818d0a60a86f67f3 Mon Sep 17 00:00:00 2001 From: Christian Persch Date: Wed, 19 Sep 2007 12:11:50 +0000 Subject: Add ChangeLog.README to explain the ChangeLog policy svn path=/trunk/; revision=7476 --- ChangeLog.README | 28 ++++++++++++++++++++++++++++ HACKING | 26 +++----------------------- 2 files changed, 31 insertions(+), 23 deletions(-) create mode 100644 ChangeLog.README 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. diff --git a/HACKING b/HACKING index 2e20ccba6..ca09af15a 100644 --- a/HACKING +++ b/HACKING @@ -13,27 +13,7 @@ need to stick to in order to get your patch accepted: * bla_bla_cb: This is an example comment block */ -SVN Checkin rules: -****************** - -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. 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 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 is ok), and in the new checkin comment 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. +See ChangeLog.README for SVN checkin rules. +Do NOT commit to this module without permission from a maintainer. +See the MAINTAINERS file for who they are. -- cgit