shtool version - GNU shtool maintain version information file

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

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.

The following command line options are available.

-v, --verbose

Print verbose information during processing.

-l, --language lang

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

-n, --name name

Name the program the version is maintained for. Default is CWunknown.

-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: ``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, --display type

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 GNU libtool.

 #   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"

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.

shtool(1).