2004-11-05 Paul Jakma <paul@dishone.st>
* HACKING: Expand on ChangeLogs, eg current practice for certain
directories and certain other meta-data is not to maintain a
ChangeLog. Expand on the commit message, IMHO, commit message
should always be ChangeLog for files where ChangeLog is kept.
Solaris is supported on any platform (with, at moment, an
additional patch).
diff --git a/ChangeLog b/ChangeLog
index cd6b00e..91275f2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2004-11-05 Paul Jakma <paul@dishone.st>
+
+ * HACKING: Expand on ChangeLogs, eg current practice for certain
+ directories and certain other meta-data is not to maintain a
+ ChangeLog. Expand on the commit message, IMHO, commit message
+ should always be ChangeLog for files where ChangeLog is kept.
+ Solaris is supported on any platform (with, at moment, an
+ additional patch).
+
2004-10-23 Paul Jakma <paul@dishone.st>
* configure.ac: bump version to 0.97.2, release imminent.
diff --git a/HACKING b/HACKING
index c60f31c..984152d 100644
--- a/HACKING
+++ b/HACKING
@@ -1,6 +1,6 @@
-*- mode: text; -*-
-$Id: HACKING,v 1.9 2004/11/05 13:17:20 gdt Exp $
+$Id: HACKING,v 1.10 2004/11/05 23:38:20 paul Exp $
GUIDELINES FOR HACKING ON QUAGGA
@@ -42,6 +42,13 @@
structural changes should also be mentioned in the top-level
ChangeLog.
+Certain directories do not contain project code, but contain project
+meta-data, eg packaging information, changes to files in these directory may
+not require the global ChangeLog to be updated (at the discretion of the
+maintainer who usually maintains that meta-data). Also, CVS meta-data such
+as cvsignore files do not require ChangeLog updates, just a sane commit
+message.
+
SHARED LIBRARY VERSIONING
[this section is at the moment just gdt's opinion]
@@ -99,7 +106,10 @@
mailinglist.
* Give an appropriate commit message, eg the ChangeLog entry should suffice,
- if it does not, then the ChangeLog entry itself needs to be corrected.
+ if it does not, then the ChangeLog entry itself needs to be corrected. The
+ commit message text should be identical to that added to the ChangeLog
+ message. (One suggestion: when commiting, use your editor to read in the
+ ChangeLog and delete all previous ChangeLogs.)
* By committing a patch, you are responsible for fixing problems
resulting from it (or backing it out).
@@ -113,7 +123,7 @@
BSD (Free, Net or Open, any platform) # without capabilities
GNU/Linux (any distribution, i386)
- Solaris with 64-bit processor (strict alignment, not ILP32)
+ Solaris (strict alignment, any platform)
[future: NetBSD/sparc64]
The list of daemons that are thought to be stable and that should be