git-format-patch.shon commit git-whatchanged: Add usage string (1403959)
   1#!/bin/sh
   2#
   3# Copyright (c) 2005 Junio C Hamano
   4#
   5
   6USAGE='[-n | -k] [-o <dir> | --stdout] [--signoff] [--check] [--mbox] [--diff-options] <upstream> [<our-head>]'
   7LONG_USAGE='Prepare each commit with its patch since our-head forked from upstream,
   8one file per patch, for e-mail submission.  Each output file is
   9numbered sequentially from 1, and uses the first line of the commit
  10message (massaged for pathname safety) as the filename.
  11
  12When -o is specified, output files are created in that directory; otherwise in
  13the current working directory.
  14
  15When -n is specified, instead of "[PATCH] Subject", the first line is formatted
  16as "[PATCH N/M] Subject", unless you have only one patch.
  17
  18When --mbox is specified, the output is formatted to resemble
  19UNIX mailbox format, and can be concatenated together for processing
  20with applymbox.'
  21. git-sh-setup
  22
  23# Force diff to run in C locale.
  24LANG=C LC_ALL=C
  25export LANG LC_ALL
  26
  27diff_opts=
  28LF='
  29'
  30
  31outdir=./
  32while case "$#" in 0) break;; esac
  33do
  34    case "$1" in
  35    -a|--a|--au|--aut|--auth|--autho|--author)
  36    author=t ;;
  37    -c|--c|--ch|--che|--chec|--check)
  38    check=t ;;
  39    -d|--d|--da|--dat|--date)
  40    date=t ;;
  41    -m|--m|--mb|--mbo|--mbox)
  42    date=t author=t mbox=t ;;
  43    -k|--k|--ke|--kee|--keep|--keep-|--keep-s|--keep-su|--keep-sub|\
  44    --keep-subj|--keep-subje|--keep-subjec|--keep-subject)
  45    keep_subject=t ;;
  46    -n|--n|--nu|--num|--numb|--numbe|--number|--numbere|--numbered)
  47    numbered=t ;;
  48    -s|--s|--si|--sig|--sign|--signo|--signof|--signoff)
  49    signoff=t ;;
  50    --st|--std|--stdo|--stdou|--stdout)
  51    stdout=t mbox=t date=t author=t ;;
  52    -o=*|--o=*|--ou=*|--out=*|--outp=*|--outpu=*|--output=*|--output-=*|\
  53    --output-d=*|--output-di=*|--output-dir=*|--output-dire=*|\
  54    --output-direc=*|--output-direct=*|--output-directo=*|\
  55    --output-director=*|--output-directory=*)
  56    outdir=`expr "$1" : '-[^=]*=\(.*\)'` ;;
  57    -o|--o|--ou|--out|--outp|--outpu|--output|--output-|--output-d|\
  58    --output-di|--output-dir|--output-dire|--output-direc|--output-direct|\
  59    --output-directo|--output-director|--output-directory)
  60    case "$#" in 1) usage ;; esac; shift
  61    outdir="$1" ;;
  62    -h|--h|--he|--hel|--help)
  63        usage
  64        ;;
  65    -*' '* | -*"$LF"* | -*'     '*)
  66        # Ignore diff option that has whitespace for now.
  67        ;;
  68    -*) diff_opts="$diff_opts$1 " ;;
  69    *) break ;;
  70    esac
  71    shift
  72done
  73
  74case "$keep_subject$numbered" in
  75tt)
  76        die '--keep-subject and --numbered are incompatible.' ;;
  77esac
  78
  79tmp=.tmp-series$$
  80trap 'rm -f $tmp-*' 0 1 2 3 15
  81
  82series=$tmp-series
  83commsg=$tmp-commsg
  84filelist=$tmp-files
  85
  86# Backward compatible argument parsing hack.
  87#
  88# Historically, we supported:
  89# 1. "rev1"             is equivalent to "rev1..HEAD"
  90# 2. "rev1..rev2"
  91# 3. "rev1" "rev2       is equivalent to "rev1..rev2"
  92#
  93# We want to take a sequence of "rev1..rev2" in general.
  94# Also, "rev1.." should mean "rev1..HEAD"; git-diff users are
  95# familiar with that syntax.
  96
  97case "$#,$1$2" in
  981,?*..?*)
  99        # single "rev1..rev2"
 100        ;;
 1011,?*..)
 102        # single "rev1.." should mean "rev1..HEAD"
 103        set x "$1"HEAD
 104        shift
 105        ;;
 1061,*)
 107        # single rev1
 108        set x "$1..HEAD"
 109        shift
 110        ;;
 1112,?*..?*)
 112        # not traditional "rev1" "rev2"
 113        ;;
 1142,*)
 115        set x "$1..$2"
 116        shift
 117        ;;
 118esac
 119
 120# Now we have what we want in $@
 121for revpair
 122do
 123        case "$revpair" in
 124        ?*..?*)
 125                rev1=`expr "$revpair" : '\(.*\)\.\.'`
 126                rev2=`expr "$revpair" : '.*\.\.\(.*\)'`
 127                ;;
 128        *)
 129                rev1="$revpair^"
 130                rev2="$revpair"
 131                ;;
 132        esac
 133        git-rev-parse --verify "$rev1^0" >/dev/null 2>&1 ||
 134                die "Not a valid rev $rev1 ($revpair)"
 135        git-rev-parse --verify "$rev2^0" >/dev/null 2>&1 ||
 136                die "Not a valid rev $rev2 ($revpair)"
 137        git-cherry -v "$rev1" "$rev2" |
 138        while read sign rev comment
 139        do
 140                case "$sign" in
 141                '-')
 142                        echo >&2 "Merged already: $comment"
 143                        ;;
 144                *)
 145                        echo $rev
 146                        ;;
 147                esac
 148        done
 149done >$series
 150
 151me=`git-var GIT_AUTHOR_IDENT | sed -e 's/>.*/>/'`
 152
 153case "$outdir" in
 154*/) ;;
 155*) outdir="$outdir/" ;;
 156esac
 157test -d "$outdir" || mkdir -p "$outdir" || exit
 158
 159titleScript='
 160        /./d
 161        /^$/n
 162        s/^\[PATCH[^]]*\] *//
 163        s/[^-a-z.A-Z_0-9]/-/g
 164        s/\.\.\.*/\./g
 165        s/\.*$//
 166        s/--*/-/g
 167        s/^-//
 168        s/-$//
 169        s/$/./
 170        p
 171        q
 172'
 173
 174whosepatchScript='
 175/^author /{
 176        s/author \(.*>\) \(.*\)$/au='\''\1'\'' ad='\''\2'\''/p
 177        q
 178}'
 179
 180process_one () {
 181        mailScript='
 182        /./d
 183        /^$/n'
 184        case "$keep_subject" in
 185        t)  ;;
 186        *)
 187            mailScript="$mailScript"'
 188            s|^\[PATCH[^]]*\] *||
 189            s|^|[PATCH'"$num"'] |'
 190            ;;
 191        esac
 192        mailScript="$mailScript"'
 193        s|^|Subject: |'
 194        case "$mbox" in
 195        t)
 196            echo 'From nobody Mon Sep 17 00:00:00 2001' ;# UNIX "From" line
 197            ;;
 198        esac
 199
 200        eval "$(sed -ne "$whosepatchScript" $commsg)"
 201        test "$author,$au" = ",$me" || {
 202                mailScript="$mailScript"'
 203        a\
 204From: '"$au"
 205        }
 206        test "$date,$au" = ",$me" || {
 207                mailScript="$mailScript"'
 208        a\
 209Date: '"$ad"
 210        }
 211
 212        mailScript="$mailScript"'
 213        : body
 214        p
 215        n
 216        b body'
 217
 218        (cat $commsg ; echo; echo) |
 219        sed -ne "$mailScript" |
 220        git-stripspace
 221
 222        test "$signoff" = "t" && {
 223                offsigner=`git-var GIT_COMMITTER_IDENT | sed -e 's/>.*/>/'`
 224                line="Signed-off-by: $offsigner"
 225                grep -q "^$line\$" $commsg || {
 226                        echo
 227                        echo "$line"
 228                        echo
 229                }
 230        }
 231        echo
 232        echo '---'
 233        echo
 234        git-diff-tree -p $diff_opts "$commit" | git-apply --stat --summary
 235        echo
 236        git-diff-tree -p $diff_opts "$commit"
 237        echo "-- "
 238        echo "@@GIT_VERSION@@"
 239
 240        case "$mbox" in
 241        t)
 242                echo
 243                ;;
 244        esac
 245}
 246
 247total=`wc -l <$series | tr -dc "[0-9]"`
 248case "$total,$numbered" in
 2491,*)
 250        numfmt='' ;;
 251*,t)
 252        numfmt=`echo "$total" | wc -c`
 253        numfmt=$(($numfmt-1))
 254        numfmt=" %0${numfmt}d/$total"
 255esac
 256
 257i=1
 258while read commit
 259do
 260    git-cat-file commit "$commit" | git-stripspace >$commsg
 261    title=`sed -ne "$titleScript" <$commsg`
 262    case "$numbered" in
 263    '') num= ;;
 264    *)
 265        num=`printf "$numfmt" $i` ;;
 266    esac
 267
 268    file=`printf '%04d-%stxt' $i "$title"`
 269    if test '' = "$stdout"
 270    then
 271            echo "$file"
 272            process_one >"$outdir$file"
 273            if test t = "$check"
 274            then
 275                # This is slightly modified from Andrew Morton's Perfect Patch.
 276                # Lines you introduce should not have trailing whitespace.
 277                # Also check for an indentation that has SP before a TAB.
 278                grep -n '^+\([  ]*      .*\|.*[         ]\)$' "$outdir$file"
 279                :
 280            fi
 281    else
 282            echo >&2 "$file"
 283            process_one
 284    fi
 285    i=`expr "$i" + 1`
 286done <$series