diff options
author | Werner Koch <wk@gnupg.org> | 2011-12-01 22:53:03 +0100 |
---|---|---|
committer | Werner Koch <wk@gnupg.org> | 2011-12-01 22:53:03 +0100 |
commit | 165a57d29d2ac84159aa48b171b6098c629bc798 (patch) | |
tree | ab27496fa66267a528333e2bb8f99077d57b0601 /doc/HACKING | |
parent | 2e037baefdc40da6961721ad56fc7c38d4e492a8 (diff) | |
download | libassuan-165a57d29d2ac84159aa48b171b6098c629bc798.tar.gz |
Generate the ChangeLog from commit logs.
* build-aux/gitlog-to-changelog: New script. Taken from gnulib.
* build-aux/git-log-fix: New file.
* build-aux/git-log-footer: New file.
* doc/HACKING: New file.
* ChangeLog: New file.
* Makefile.am (EXTRA_DIST): Add new files.
(gen-ChangeLog): New.
(dist-hook): Run gen-ChangeLog.
* autogen.sh: Install commit-msg hook for git.
Rename all ChangeLog files to ChangeLog-2011.
Diffstat (limited to 'doc/HACKING')
-rw-r--r-- | doc/HACKING | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/doc/HACKING b/doc/HACKING new file mode 100644 index 0000000..b7d6b10 --- /dev/null +++ b/doc/HACKING @@ -0,0 +1,25 @@ +# HACKING -*- org -*- +#+TITLE: Hacking notes for Libassuan +#+STARTUP: showall + +* No more ChangeLog files + + Do not modify any of the ChangeLog files in Libassuan. Starting + on December 1st, 2011 we put change information only in the GIT + commit log, and generate a top-level ChangeLog file from logs at + "make dist" time. As such, there are strict requirements on the + form of the commit log messages. The old ChangeLog files have all + be renamed to ChangeLog-2011 + + +* Commit log requirements + + Your 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. However, it's fine + -- even recommended -- to write a few lines of prose describing the + change, when the summary and ChangeLog entries don't give enough of + the big picture. Omit the leading TABs that you're used to seeing + in a "real" ChangeLog file, but keep the maximum line length at 72 + or smaller, so that the generated ChangeLog lines, each with its + leading TAB, will not exceed 80 columns. |