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