1#!/bin/sh 2# Print a version string. 3scriptversion=2010-06-14.19; # UTC 4 5# Copyright (C) 2007-2010 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# It is probably wise to add these two files to .gitignore, so that you 48# don't accidentally commit either generated file. 49# 50# Use the following line in your configure.ac, so that $(VERSION) will 51# automatically be up-to-date each time configure is run (and note that 52# since configure.ac no longer includes a version string, Makefile rules 53# should not depend on configure.ac for version updates). 54# 55# AC_INIT([GNU project], 56# m4_esyscmd([build-aux/git-version-gen .tarball-version]), 57# [bug-project@example]) 58# 59# Then use the following lines in your Makefile.am, so that .version 60# will be present for dependencies, and so that .tarball-version will 61# exist in distribution tarballs. 62# 63# BUILT_SOURCES = $(top_srcdir)/.version 64# $(top_srcdir)/.version: 65# echo $(VERSION) > $@-t && mv $@-t $@ 66# dist-hook: 67# echo $(VERSION) > $(distdir)/.tarball-version 68 69case $# in 70 1|2) ;; 71 *) echo 1>&2 "Usage: $0 \$srcdir/.tarball-version" \ 72 '[TAG-NORMALIZATION-SED-SCRIPT]' 73 exit 1;; 74esac 75 76tarball_version_file=$1 77tag_sed_script="${2:-s/x/x/}" 78nl=' 79' 80 81# Avoid meddling by environment variable of the same name. 82v= 83 84# First see if there is a tarball-only version file. 85# then try "git describe", then default. 86if test -f $tarball_version_file 87then 88 v=`cat $tarball_version_file` || exit 1 89 case $v in 90 *$nl*) v= ;; # reject multi-line output 91 [0-9]*) ;; 92 *) v= ;; 93 esac 94 test -z "$v" \ 95 && echo "$0: WARNING: $tarball_version_file seems to be damaged" 1>&2 96fi 97 98if test -n "$v" 99then 100 : # use $v 101elif test -d .git \ 102 && v=`git describe --abbrev=4 --match='v*' HEAD 2>/dev/null \ 103 || git describe --abbrev=4 HEAD 2>/dev/null` \ 104 && v=`printf '%s\n' "$v" | sed "$tag_sed_script"` \ 105 && case $v in 106 v[0-9]*) ;; 107 *) (exit 1) ;; 108 esac 109then 110 # Is this a new git that lists number of commits since the last 111 # tag or the previous older version that did not? 112 # Newer: v6.10-77-g0f8faeb 113 # Older: v6.10-g0f8faeb 114 case $v in 115 *-*-*) : git describe is okay three part flavor ;; 116 *-*) 117 : git describe is older two part flavor 118 # Recreate the number of commits and rewrite such that the 119 # result is the same as if we were using the newer version 120 # of git describe. 121 vtag=`echo "$v" | sed 's/-.*//'` 122 numcommits=`git rev-list "$vtag"..HEAD | wc -l` 123 v=`echo "$v" | sed "s/\(.*\)-\(.*\)/\1-$numcommits-\2/"`; 124 ;; 125 esac 126 127 # Change the first '-' to a '.', so version-comparing tools work properly. 128 # Remove the "g" in git describe's output string, to save a byte. 129 v=`echo "$v" | sed 's/-/./;s/\(.*\)-g/\1-/'`; 130else 131 v=UNKNOWN 132fi 133 134v=`echo "$v" |sed 's/^v//'` 135 136# Don't declare a version "dirty" merely because a time stamp has changed. 137git update-index --refresh > /dev/null 2>&1 138 139dirty=`sh -c 'git diff-index --name-only HEAD' 2>/dev/null` || dirty= 140case "$dirty" in 141 '') ;; 142 *) # Append the suffix only if there isn't one already. 143 case $v in 144 *-dirty) ;; 145 *) v="$v-dirty" ;; 146 esac ;; 147esac 148 149# Omit the trailing newline, so that m4_esyscmd can use the result directly. 150echo "$v" | tr -d "$nl" 151 152# Local variables: 153# eval: (add-hook 'write-file-hooks 'time-stamp) 154# time-stamp-start: "scriptversion=" 155# time-stamp-format: "%:y-%02m-%02d.%02H" 156# time-stamp-time-zone: "UTC" 157# time-stamp-end: "; # UTC" 158# End: 159