Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
SHTOOL-VERSION.TMP(1)	     GNU Portable Shell Tool	   SHTOOL-VERSION.TMP(1)

NAME
     shtool version - GNU shtool maintain version information file

SYNOPSIS
     shtool version [-l|--language lang] [-n|--name name] [-p|--prefix prefix]
     [-s|--set version] [-e|--edit] [-i|--increase knob] [-d|--display type]
     file

DESCRIPTION
     This command displays and maintains version information in file.

     The version is always described with a triple <version,revision,level> and
     is represented by a string which always matches the regular expression
     ""[0-9]+\.[0-9]+[sabp.][0-9]+"".

     The hexadecimal format for a version "v.rtl" is "VVRRTLL" where "VV" and
     "RR" directly correspond to "v" and "r", "T" encodes the level type as 9,
     2, 1, 0 (representing "s", "p"/".", "b", "a" in this order) and "LL" is ei-
     ther directly corresponding to "l" or set to 99 if level type is "s".

OPTIONS
     The following command line options are available.

     -v, --verbose
	 Print verbose information during processing.

     -l, --language lang
	 Choose format of version file file. lang=""txt"", ANSI C (lang="c"), M4
	 (lang="m4"), Perl (lang="perl") or Python (lang="python"). Default is
	 "txt".

     -n, --name name
	 Name the program the version is maintained for. Default is "unknown".

     -p, --prefix prefix =item -s, --set version
	 Set the version to version.

     -e, --edit
	 Interactively enter a new version.

     -i, --increase knob
	 When option ``-i'' is used, the current version in file is updated by
	 increasing one element of the version where knob can be one of the fol-
	 lowing: ``"v"'' for increasing the version by 1 (and resetting revision
	 and level to 0), ``"r"'' for increasing the revision by 1 (and reset-
	 ting level to 0) or ``"l"'' for increasing the level by 1.

     -d, --display type
	 Control the display type: ""short"" for a short version display,
	 ""long"" for a longer version display, ""hex"" for a hexadecimal dis-
	 play of the version and ""libtool"" for a format suitable for use with
	 GNU libtool.

EXAMPLE
      #   shell script
      shtool version -l c -n FooBar -p foobar -s 1.2b3 version.c

      #   configure.in
      V=`shtool version -l c -d long version.c`
      echo "Configuring FooBar, Version $V"

HISTORY
     The GNU shtool version command was originally written by Ralf S.  En-
     gelschall <rse@engelschall.com> in 1994 for OSSP eperl. It was later
     rewritten from scratch for inclusion into GNU shtool.

SEE ALSO
     shtool(1).

18-Jul-2008			  shtool 2.0.8		   SHTOOL-VERSION.TMP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shtool-version&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help