tests: check decoding of prctl PR_GET_TID_ADDRESS operation

[strace] / README-hacking

diff --git a/README-hacking b/README-hacking
index af2a1f6b8f99b2e92c5255e19f8902c859dcefdf..16d12c0316a55f6ef1943632fa5dc9d1b274b272 100644 (file)
--- a/README-hacking
+++ b/README-hacking
@@ -1,5 +1,32 @@
-
+Requirements
+============
 If you use the GIT version of strace there will be some files missing
 that you need to build strace.  These files are generated by tools from
-the GNU Autoconf and Automake packages.  You need recent versions, which
-provide the `autoreconf -i' command that will do everything you need.
+the GNU Autoconf and Automake packages.
+
+Note: rather than run `autoreconf' directly, use the `./bootstrap' script.
+
+
+No more ChangeLog file
+======================
+Do not create or modify the ChangeLog files.  Starting at 2009-07-09, the
+policy changed.  Before, we would insert the exact same text (or worse,
+sometimes slightly differing) into both the ChangeLog file and the commit
+log.  Now we put that information only in the commit log, and generate
+the top-level ChangeLog file from logs at "make dist" time.  As such,
+there are strict requirements on the form of the commit log messages.
+
+
+Commit log requirements
+=======================
+Each commit log should always start with a one-line summary, the second
+line should be blank, and the remaining lines are usually ChangeLog-style
+entries for all affected files, except the leading TABs which should
+be omitted.
+
+
+Documentation
+=============
+All noteworthy changes should be mentioned in NEWS.  All changes in strace
+command interface should be reflected in the man page.  New options should
+be documented both in -h output and in the man page.