Debian Codegraph @

build-aux/git-version-gen

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: