shtool-version (1) Linux Manual Page
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] fileDescription
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"