/ git-version-gen
git-version-gen
  1  #!/bin/sh
  2  # Print a version string.
  3  scriptversion=2017-12-12.21
  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  
 69  case $# in
 70      1) ;;
 71      *) echo 1>&2 "Usage: $0 \$srcdir/.tarball-version"; exit 1;;
 72  esac
 73  
 74  tarball_version_file=$1
 75  nl='
 76  '
 77  
 78  # First see if there is a tarball-only version file.
 79  # then try "git describe", then default.
 80  if test -f $tarball_version_file
 81  then
 82      v=`cat $tarball_version_file` || exit 1
 83      case $v in
 84  	*$nl*) v= ;; # reject multi-line output
 85  	[0-9]*) ;;
 86  	*) v= ;;
 87      esac
 88      test -z "$v" \
 89  	&& echo "$0: WARNING: $tarball_version_file seems to be damaged" 1>&2
 90  fi
 91  
 92  # Second, see if there is a debian/changelog file.
 93  # then use the package version.
 94  if test -f debian/changelog
 95  then
 96      v=`dpkg-parsechangelog -ldebian/changelog | sed -rne 's,^Version: (.*),\1,p'` || exit 1
 97      test -z "$v" \
 98  	&& echo "$0: WARNING: Cannot parse Debian version" 1>&2
 99  fi
100  
101  if test -n "$v"
102  then
103      : # use $v
104  elif
105         v=`git describe --abbrev=4 --match='v*' HEAD 2>/dev/null \
106  	  || git describe --abbrev=4 HEAD 2>/dev/null` \
107      && case $v in
108  	 [0-9]*) ;;
109  	 v[0-9]*) ;;
110  	 *) (exit 1) ;;
111         esac
112  then
113      # Is this a new git that lists number of commits since the last
114      # tag or the previous older version that did not?
115      #   Newer: v6.10-77-g0f8faeb
116      #   Older: v6.10-g0f8faeb
117      case $v in
118  	*-*-*) : git describe is okay three part flavor ;;
119  	*-*)
120  	    : git describe is older two part flavor
121  	    # Recreate the number of commits and rewrite such that the
122  	    # result is the same as if we were using the newer version
123  	    # of git describe.
124  	    vtag=`echo "$v" | sed 's/-.*//'`
125  	    numcommits=`git rev-list "$vtag"..HEAD | wc -l`
126  	    v=`echo "$v" | sed "s/\(.*\)-\(.*\)/\1-$numcommits-\2/"`;
127  	    ;;
128      esac
129  
130      # Change the first '-' to a '.', so version-comparing tools work properly.
131      # Remove the "g" in git describe's output string, to save a byte.
132      v=`echo "$v" | sed 's/-/./;s/\(.*\)-g/\1-/'`;
133  else
134      v=UNKNOWN
135  fi
136  
137  v=`echo "$v" |sed 's/^v//'`
138  
139  # Don't declare a version "dirty" merely because a time stamp has changed.
140  git status > /dev/null 2>&1
141  
142  dirty=`sh -c 'git diff-index --name-only HEAD' 2>/dev/null` || dirty=
143  case "$dirty" in
144      '') ;;
145      *) # Append the suffix only if there isn't one already.
146  	case $v in
147  	  *-dirty) ;;
148  	  *) v="$v-dirty" ;;
149  	esac ;;
150  esac
151  
152  # Omit the trailing newline, so that m4_esyscmd can use the result directly.
153  echo "$v" | tr -d '\012'
154  
155  # Local variables:
156  # eval: (add-hook 'write-file-hooks 'time-stamp)
157  # time-stamp-start: "scriptversion="
158  # time-stamp-format: "%:y-%02m-%02d.%02H"
159  # time-stamp-end: "$"
160  # End: