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 either 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 following: ``"v"'' for increasing the version by 1 (and resetting revision and level to 0), ``"r"'' for increasing the revision by 1 (and resetting 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 display 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. Engelschall <rse@engelschall.com> in 1994 for OSSP eperl. It was later rewritten from scratch for inclusion into GNU shtool.

SEE ALSO¶

shtool(1).