Elliott Hughes | 5dec78d | 2014-02-26 15:56:23 -0800 | [diff] [blame] | 1 | Requirements |
| 2 | ============ |
| 3 | If you use the GIT version of strace there will be some files missing |
| 4 | that you need to build strace. These files are generated by tools from |
| 5 | the GNU Autoconf and Automake packages. You need recent versions, which |
| 6 | provide the `autoreconf -i' command that will do everything you need. |
| 7 | |
| 8 | |
| 9 | No more ChangeLog file |
| 10 | ====================== |
| 11 | Do not create or modify the ChangeLog files. Starting at 2009-07-09, the |
| 12 | policy changed. Before, we would insert the exact same text (or worse, |
| 13 | sometimes slightly differing) into both the ChangeLog file and the commit |
| 14 | log. Now we put that information only in the commit log, and generate |
| 15 | the top-level ChangeLog file from logs at "make dist" time. As such, |
| 16 | there are strict requirements on the form of the commit log messages. |
| 17 | |
| 18 | |
| 19 | Commit log requirements |
| 20 | ======================= |
| 21 | Each commit log should always start with a one-line summary, the second |
| 22 | line should be blank, and the remaining lines are usually ChangeLog-style |
| 23 | entries for all affected files, except the leading TABs which should |
| 24 | be omitted. |
| 25 | |
| 26 | |
| 27 | Documentation |
| 28 | ============= |
| 29 | All noteworthy changes should be mentioned in NEWS. All changes in strace |
| 30 | command interface should be reflected in the man page. New options should |
| 31 | be documented both in -h output and in the man page. |