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
"CW[0-9]+\.[0-9]+[sabp.][0-9]+".
The hexadecimal format for a version CWv.rtl is CWVVRRTLL where CWVV
and CWRR directly correspond to CWv and CWr, CWT encodes the level
type as CW9, CW2, CW1, CW0 (representing CWs, CWp/CW., CWb, CWa
in this order) and CWLL is either directly corresponding to CWl or set
to CW99 if level type is CWs.
OPTIONS
The following command line options are available.
"-v,
Print verbose information during processing.
"-l,
Choose format of version file file. lang="CWtxt", \s-1ANSI\s0 C
(lang=“c”), M4 (lang=“m4”), Perl (lang=“perl”) or Python
(lang=“python”). Default is CWtxt.
"-n,
Name the program the version is maintained for. Default is CWunknown.
"-p,
Set the version to version.
"-e,
Interactively enter a new version.
"-i,
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: ``CWv'' for increasing the version by 1 (and resetting
revision and level to 0), ``CWr'' for increasing the revision by 1 (and
resetting level to 0) or ``CWl'' for increasing the level by 1.
"-d,
Control the display type: "CWshort“ for a short version display,
”CWlong“ for a longer version display, ”CWhex“ for a hexadecimal
display of the version and ”CWlibtool" for a format suitable for use
with \s-1GNU\s0 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 \s-1GNU\s0 shtool version command was originally written by Ralf S.
Engelschall <rse@engelschall.com> in 1994 for \s-1OSSP\s0 eperl. It
was later rewritten from scratch for inclusion into \s-1GNU\s0 shtool.
SEE ALSO
shtool(1).
