FYI,
>From 744b6c6ea8c72b372750ed31f3afed8420b236eb Mon Sep 17 00:00:00 2001
From: Jim Meyering <meyer...@redhat.com>
Date: Mon, 2 Jan 2012 15:53:06 +0100
Subject: [PATCH] gitlog-to-changelog: describe input syntax in --help output
* build-aux/gitlog-to-changelog (usage) [SPECIAL SYNTAX]: New section.
---
ChangeLog | 3 +++
build-aux/gitlog-to-changelog | 17 ++++++++++++++++-
2 files changed, 19 insertions(+), 1 deletions(-)
diff --git a/ChangeLog b/ChangeLog
index efa62c0..04a3bfa 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,8 @@
2012-01-02 Jim Meyering <meyer...@redhat.com>
+ gitlog-to-changelog: describe input syntax in --help output
+ * build-aux/gitlog-to-changelog (usage) [SPECIAL SYNTAX]: New section.
+
gitlog-to-changelog: fix typo in --help: show backslash before email @
* build-aux/gitlog-to-changelog (usage): An "@" was backslash-escaped
in sources, but not in actual output.
diff --git a/build-aux/gitlog-to-changelog b/build-aux/gitlog-to-changelog
index 8825685..9d5327a 100755
--- a/build-aux/gitlog-to-changelog
+++ b/build-aux/gitlog-to-changelog
@@ -3,7 +3,7 @@ eval '(exit $?0)' && eval 'exec perl -wS "$0" ${1+"$@"}'
if 0;
# Convert git log output to ChangeLog format.
-my $VERSION = '2012-01-02 09:55'; # UTC
+my $VERSION = '2012-01-02 14:48'; # UTC
# The definition above must lie within the first 8 lines in order
# for the Emacs time-stamp write hook (at end) to update it.
# If you change this file with Emacs, please let the write hook
@@ -78,6 +78,21 @@ EXAMPLE:
$ME --since=2008-01-01 > ChangeLog
$ME -- -n 5 foo > last-5-commits-to-branch-foo
+SPECIAL SYNTAX:
+
+The following types of strings are interpreted specially when they appear
+at the beginning of a log message line. They are not copied to the output.
+
+ Copyright-paperwork-exempt: Yes
+ Append the "(tiny change)" notation to the usual "date name email"
+ ChangeLog header to mark a change that does not require a copyright
+ assignment.
+ Co-authored-by: Joe User <user\@example.com>
+ List the specified name and email address on a second
+ ChangeLog header, denoting a co-author.
+ Signed-off-by: Joe User <user\@example.com>
+ These lines are simply elided.
+
In a FILE specified via --amend, comment lines (starting with "#") are ignored.
FILE must consist of <SHA,CODE+> pairs where SHA is a 40-byte SHA1 (alone on
a line) referring to a commit in the current project, and CODE refers to one
--
1.7.8.1.391.g2c2ad
