Announce

   1 #!/bin/sh
   2 # Announcement message skelton
   3 #
   4 tmpbase=/var/tmp/git-announce.$$
   5 trap 'rm -f $tmpbase.*' 0
   6 branch=${1?branch}
   7 previous=${2?previous}
   8 commit=${3-"$1"}
   9
  10 relname=$(git describe "$commit") &&
  11 vername=$(expr "$relname" : 'v\(.*\)') || exit $?
  12
  13 git rev-parse --verify "$previous" >/dev/null || exit $?
  14
  15 case "$branch" in
  16 maint)
  17         kind="The latest maintenance release" ;;
  18 mainto/* | maint-[0-9]*)
  19         kind="A maintenance release" ;;
  20 master)
  21         kind="The latest feature release" ;;
  22 esac
  23
  24 case "$vername" in
  25 *-rc[0-9]*)
  26         rpmroot=testing
  27         case "$vername" in
  28         *-rc0)
  29                 kind="An early preview release"
  30                 ;;
  31         *)
  32                 kind="A release candidate"
  33                 ;;
  34         esac
  35         for_testing=" for testing"
  36         ;;
  37 *)
  38         for_testing=
  39         rpmroot='RPMS/$arch'
  40         ;;
  41 esac
  42
  43 vername=$(echo "$vername" | tr "-" ".")
  44
  45 git log --use-mailmap --format='%aN,' "$previous" | sort -u >"$tmpbase.prev"
  46 git log --use-mailmap --format='%aN,' "$previous..$commit" | sort -u >"$tmpbase.this"
  47 comm -12 "$tmpbase.prev" "$tmpbase.this" >"$tmpbase.old"
  48 comm -13 "$tmpbase.prev" "$tmpbase.this" >"$tmpbase.new"
  49
  50 all=$(wc -l <"$tmpbase.this")
  51 new=$(wc -l <"$tmpbase.new")
  52 cnt=$(git rev-list --no-merges "$previous..$commit" | wc -l)
  53
  54 cat <<EOF
  55 To: git@vger.kernel.org
  56 Cc: Linux Kernel <linux-kernel@vger.kernel.org>
  57 Bcc: lwn@lwn.net
  58 Subject: [ANNOUNCE] Git $relname
  59
  60 EOF
  61
  62 (
  63         echo "$kind Git $relname is now available$for_testing at the usual places."
  64         if test "$branch" = master
  65         then
  66                 cat <<-EOF
  67                 It is comprised of $cnt non-merge commits since $previous,
  68                 contributed by $all people, $new of which are new faces.
  69                 EOF
  70         fi
  71 ) | fmt -68
  72
  73 cat <<EOF
  74
  75 The tarballs are found at:
  76
  77     https://www.kernel.org/pub/software/scm/git/${for_testing:+testing/}
  78
  79 EOF
  80
  81 (
  82         cat <<-EOF
  83         The following public repositories all have a copy of
  84         the '$relname' tag and
  85         EOF
  86         case "$branch" in
  87         maint-* | mainto/*)
  88                 echo "some of them have"
  89                 ;;
  90         esac
  91         echo "the '$branch' branch that the tag points at:"
  92 ) | fmt -68
  93
  94 cat <<\EOF
  95
  96   url = https://kernel.googlesource.com/pub/scm/git/git
  97   url = git://repo.or.cz/alt-git.git
  98   url = https://code.google.com/p/git-core/
  99   url = git://git.sourceforge.jp/gitroot/git-core/git.git
 100   url = git://git-core.git.sourceforge.net/gitroot/git-core/git-core
 101   url = https://github.com/gitster/git
 102 EOF
 103
 104 fmt_people () {
 105         # Yes, I don't perform well without 2 or more people.
 106         # Sue me. The heading says "are as follows" anyway ;-).
 107         sed -e '${
 108                 s/^/and /
 109                 s/,$/./
 110         }' "$1" |
 111         fmt -66 |
 112         sed -e 's/^/  /'
 113
 114 }
 115
 116 if test "$branch" = master
 117 then
 118         cat <<-EOF
 119
 120         New contributors whose contributions weren't in $previous are as follows.
 121         Welcome to the Git development community!
 122
 123         $(fmt_people "$tmpbase.new")
 124
 125         Returning contributors who helped this release are as follows.
 126         Thanks for your continued support.
 127
 128         $(fmt_people "$tmpbase.old")
 129         EOF
 130 fi
 131
 132 cat <<EOF
 133
 134 ----------------------------------------------------------------
 135
 136 EOF
 137
 138 case "$(git ls-tree ${branch} RelNotes)" in
 139 120000' '*)
 140         RelNotes=$(git cat-file blob "${branch}:RelNotes")
 141         ;;
 142 *)
 143         RelNotes=RelNotes
 144         ;;
 145 esac &&
 146 git cat-file blob "${branch}:$RelNotes" |
 147 case "$relname" in
 148 *-*)
 149         sed -e 's/^Git .* Release Notes$/& (draft)/' \
 150             -e 's/^=============/&========/'
 151         ;;
 152 *)
 153         cat
 154         ;;
 155 esac
 156
 157 cat <<EOF
 158
 159 ----------------------------------------------------------------
 160
 161 Changes since $previous are as follows:
 162
 163 EOF
 164
 165 git log --no-merges "$previous".."$branch" |
 166 git shortlog