| Dmitry V. Levin | 08f922a | 2009-07-09 00:47:41 +0000 | [diff] [blame] | 1 | Requirements |
| 2 | ============ |
| Dmitry V. Levin | 82f4cc6 | 2009-07-07 22:33:41 +0000 | [diff] [blame] | 3 | If you use the GIT version of strace there will be some files missing |
| Roland McGrath | 6d2b349 | 2002-12-30 00:51:30 +0000 | [diff] [blame] | 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. |
| Dmitry V. Levin | 08f922a | 2009-07-09 00:47:41 +0000 | [diff] [blame] | 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. |
| Dmitry V. Levin | 5700f68 | 2012-05-03 01:44:49 +0000 | [diff] [blame] | 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. |