:: bzip3 / build-aux / git-version-gen 7.5 KB raw

1
#!/usr/bin/env sh
2
3
# Print a version string.
4
scriptversion=2012-03-18.17; # UTC
5
6
# Copyright (C) 2007-2012 Free Software Foundation, Inc.
7
#
8
# This program is free software: you can redistribute it and/or modify
9
# it under the terms of the GNU General Public License as published by
10
# the Free Software Foundation; either version 3 of the License, or
11
# (at your option) any later version.
12
#
13
# This program is distributed in the hope that it will be useful,
14
# but WITHOUT ANY WARRANTY; without even the implied warranty of
15
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16
# GNU General Public License for more details.
17
#
18
# You should have received a copy of the GNU General Public License
19
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
20
21
# This script is derived from GIT-VERSION-GEN from GIT: http://git.or.cz/.
22
# It may be run two ways:
23
# - from a git repository in which the "git describe" command below
24
#   produces useful output (thus requiring at least one signed tag)
25
# - from a non-git-repo directory containing a .tarball-version file, which
26
#   presumes this script is invoked like "./git-version-gen .tarball-version".
27
28
# In order to use intra-version strings in your project, you will need two
29
# separate generated version string files:
30
#
31
# .tarball-version - present only in a distribution tarball, and not in
32
#   a checked-out repository.  Created with contents that were learned at
33
#   the last time autoconf was run, and used by git-version-gen.  Must not
34
#   be present in either $(srcdir) or $(builddir) for git-version-gen to
35
#   give accurate answers during normal development with a checked out tree,
36
#   but must be present in a tarball when there is no version control system.
37
#   Therefore, it cannot be used in any dependencies.  GNUmakefile has
38
#   hooks to force a reconfigure at distribution time to get the value
39
#   correct, without penalizing normal development with extra reconfigures.
40
#
41
# .version - present in a checked-out repository and in a distribution
42
#   tarball.  Usable in dependencies, particularly for files that don't
43
#   want to depend on config.h but do want to track version changes.
44
#   Delete this file prior to any autoconf run where you want to rebuild
45
#   files to pick up a version string change; and leave it stale to
46
#   minimize rebuild time after unrelated changes to configure sources.
47
#
48
# As with any generated file in a VC'd directory, you should add
49
# /.version to .gitignore, so that you don't accidentally commit it.
50
# .tarball-version is never generated in a VC'd directory, so needn't
51
# be listed there.
52
#
53
# Use the following line in your configure.ac, so that $(VERSION) will
54
# automatically be up-to-date each time configure is run (and note that
55
# since configure.ac no longer includes a version string, Makefile rules
56
# should not depend on configure.ac for version updates).
57
#
58
# AC_INIT([GNU project],
59
#         m4_esyscmd([build-aux/git-version-gen .tarball-version]),
60
#         [bug-project@example])
61
#
62
# Then use the following lines in your Makefile.am, so that .version
63
# will be present for dependencies, and so that .version and
64
# .tarball-version will exist in distribution tarballs.
65
#
66
# EXTRA_DIST = $(top_srcdir)/.version
67
# BUILT_SOURCES = $(top_srcdir)/.version
68
# $(top_srcdir)/.version:
69
#	echo $(VERSION) > $@-t && mv $@-t $@
70
# dist-hook:
71
#	echo $(VERSION) > $(distdir)/.tarball-version
72
73
74
me=$0
75
76
version="git-version-gen $scriptversion
77
78
Copyright 2011 Free Software Foundation, Inc.
79
There is NO warranty.  You may redistribute this software
80
under the terms of the GNU General Public License.
81
For more information about these matters, see the files named COPYING."
82
83
usage="\
84
Usage: $me [OPTION]... \$srcdir/.tarball-version [TAG-NORMALIZATION-SED-SCRIPT]
85
Print a version string.
86
87
Options:
88
89
   --prefix           prefix of git tags
90
91
   --help             display this help and exit
92
   --version          output version information and exit
93
94
Running without arguments will suffice in most cases."
95
96
prefix=
97
98
while test $# -gt 0; do
99
  case $1 in
100
    --help) echo "$usage"; exit 0;;
101
    --version) echo "$version"; exit 0;;
102
    --prefix) shift; prefix="$1";;
103
    -*)
104
      echo "$0: Unknown option '$1'." >&2
105
      echo "$0: Try '--help' for more information." >&2
106
      exit 1;;
107
    *)
108
      if test -z "$tarball_version_file"; then
109
        tarball_version_file="$1"
110
      elif test -z "$tag_sed_script"; then
111
        tag_sed_script="$1"
112
      else
113
        echo "$0: extra non-option argument '$1'." >&2
114
        exit 1
115
      fi;;
116
  esac
117
  shift
118
done
119
120
if test -z "$tarball_version_file"; then
121
    echo "$usage"
122
    exit 1
123
fi
124
125
tag_sed_script="${tag_sed_script:-s/x/x/}"
126
127
nl='
128
'
129
130
# Avoid meddling by environment variable of the same name.
131
v=
132
v_from_git=
133
134
# First see if there is a tarball-only version file.
135
# then try "git describe", then default.
136
if test -f $tarball_version_file
137
then
138
    v=`cat $tarball_version_file` || v=
139
    case $v in
140
        *$nl*) v= ;; # reject multi-line output
141
        [0-9]*) ;;
142
        *) v= ;;
143
    esac
144
    test -z "$v" \
145
        && echo "$0: WARNING: $tarball_version_file is missing or damaged" 1>&2
146
fi
147
148
if test -n "$v"
149
then
150
    : # use $v
151
# Otherwise, if there is at least one git commit involving the working
152
# directory, and "git describe" output looks sensible, use that to
153
# derive a version string.
154
elif test "`git log -1 --pretty=format:x . 2>/dev/null`" = x \
155
    && v=`git describe --tags --abbrev=7 --match="$prefix*" HEAD 2>/dev/null \
156
          || git describe --tags --abbrev=7 HEAD 2>/dev/null \
157
          || git log -1 --pretty=format:'v0-HEAD-%h' 2>/dev/null` \
158
    && v=`printf '%s\n' "$v" | sed "$tag_sed_script"` \
159
    && case $v in
160
         $prefix[0-9]*) ;;
161
         *) (exit 1) ;;
162
       esac
163
then
164
    # Is this a new git that lists number of commits since the last
165
    # tag or the previous older version that did not?
166
    #   Newer: v6.10-77-g0f8faeb
167
    #   Older: v6.10-g0f8faeb
168
    case $v in
169
        *-*-*) : git describe is okay three part flavor ;;
170
        *-*)
171
            : git describe is older two part flavor
172
            # Recreate the number of commits and rewrite such that the
173
            # result is the same as if we were using the newer version
174
            # of git describe.
175
            vtag=`echo "$v" | sed 's/-.*//'`
176
            commit_list=`git rev-list "$vtag"..HEAD 2>/dev/null` \
177
                || { commit_list=failed;
178
                     echo "$0: WARNING: git rev-list failed" 1>&2; }
179
            numcommits=`echo "$commit_list" | wc -l`
180
            v=`echo "$v" | sed "s/\(.*\)-\(.*\)/\1-$numcommits-\2/"`;
181
            test "$commit_list" = failed && v=UNKNOWN
182
            ;;
183
    esac
184
185
    v=`echo "$v" | sed 's/-/.r/'`;
186
    v_from_git=1
187
else
188
    v=UNKNOWN
189
fi
190
191
v=`echo "$v" |sed "s/^$prefix//"`
192
193
# Test whether to append the "-dirty" suffix only if the version
194
# string we're using came from git.  I.e., skip the test if it's "UNKNOWN"
195
# or if it came from .tarball-version.
196
if test -n "$v_from_git"; then
197
  # Don't declare a version "dirty" merely because a time stamp has changed.
198
  git update-index --refresh > /dev/null 2>&1
199
200
  dirty=`exec 2>/dev/null;git diff-index --name-only HEAD` || dirty=
201
  case "$dirty" in
202
      '') ;;
203
      *) # Append the suffix only if there isn't one already.
204
          case $v in
205
            *-dirty) ;;
206
            *) v="$v-dirty" ;;
207
          esac ;;
208
  esac
209
fi
210
211
# Omit the trailing newline, so that m4_esyscmd can use the result directly.
212
echo "$v" | tr -d "$nl"
213
214
# Local variables:
215
# eval: (add-hook 'write-file-hooks 'time-stamp)
216
# time-stamp-start: "scriptversion="
217
# time-stamp-format: "%:y-%02m-%02d.%02H"
218
# time-stamp-time-zone: "UTC"
219
# time-stamp-end: "; # UTC"
220
# End:
tab: 248 wrap: offon