[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 1/7] hacking: miscellaneous minor fixes
From: |
Stefano Lattarini |
Subject: |
[PATCH 1/7] hacking: miscellaneous minor fixes |
Date: |
Mon, 5 Dec 2011 20:21:53 +0100 |
* HACKING (Administrivia): If a commit fixes a bug registered at GNU
debbugs, its bug number be reported in the ChangeLog entry. Re-order
the entries to give more visibility to the advice on how to verify
that a commit really fixes a bug.
(Working with git): Improve advice about which pre-existing branch
a topic branch should be based on.
---
HACKING | 16 +++++++++-------
1 files changed, 9 insertions(+), 7 deletions(-)
diff --git a/HACKING b/HACKING
index 873243c..c01445f 100644
--- a/HACKING
+++ b/HACKING
@@ -10,12 +10,18 @@
================================================================
= Administrivia
+* The correct response to most actual bugs is to write a new test case
+ which demonstrates the bug. Then fix the bug, re-run the test suite,
+ and check everything in.
+
* If you incorporate a change from somebody on the net:
First, if it is a large change, you must make sure they have signed the
appropriate paperwork.
Second, be sure to add their name and email address to THANKS
* If a change fixes a test, mention the test in the ChangeLog entry.
+ If a change fixes a bug registered in the Automake debbugs tracker,
+ mention the bug number in the ChangeLog entry.
* If somebody reports a new bug, mention his name in the ChangeLog entry
and in the test case you write. Put him into THANKS.
@@ -24,10 +30,6 @@
sure to add a test case for it, and to reference such test case from
a proper Texinfo comment.
-* The correct response to most actual bugs is to write a new test case
- which demonstrates the bug. Then fix the bug, re-run the test suite,
- and check everything in.
-
* Some files in the automake package are not owned by automake. These
files should never be edited here. These files are
COPYING (from FSF),
@@ -151,9 +153,9 @@
* There may be a number of longer-lived feature branches for new developments.
They should be based off of a common ancestor of all active branches to
- which the feature should be merged later. The next branch may serve as
- common ground for feature merging and testing, should they not be ready
- for master yet.
+ which the feature should or might be merged later. The next branch may
+ serve as common ground for feature merging and testing, should they not
+ be ready for master yet.
* For merges from branches other than maint, prefer 'git merge --log' over
plain 'git merge', so that a later 'git log' gives an indication of which
--
1.7.2.3
- [PATCH 0/7] Miscellaneous improvements for HACKING and description of release procedure, Stefano Lattarini, 2011/12/05
- [PATCH 1/7] hacking: miscellaneous minor fixes,
Stefano Lattarini <=
- [PATCH 2/7] hacking: we don't use sources.redhat.com anymore, Stefano Lattarini, 2011/12/05
- [PATCH 3/7] hacking: tell about platform-testers mailing list, Stefano Lattarini, 2011/12/05
- [PATCH 4/7] readme: bug reports should be sent to bug-automake, Stefano Lattarini, 2011/12/05
- [PATCH 5/7] readme: the documentation is production quality now, Stefano Lattarini, 2011/12/05
- [PATCH 6/7] hacking: described release procedure applies to beta releases too, Stefano Lattarini, 2011/12/05