1SHTOOL-VERSION.TMP(1)       GNU Portable Shell Tool      SHTOOL-VERSION.TMP(1)
2
3
4

NAME

6       shtool version - GNU shtool maintain version information file
7

SYNOPSIS

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

DESCRIPTION

14       This command displays and maintains version information in file.
15
16       The version is always described with a triple <version,revision,level>
17       and is represented by a string which always matches the regular
18       expression ""[0-9]+\.[0-9]+[sabp.][0-9]+"".
19
20       The hexadecimal format for a version "v.rtl" is "VVRRTLL" where "VV"
21       and "RR" directly correspond to "v" and "r", "T" encodes the level type
22       as 9, 2, 1, 0 (representing "s", "p"/".", "b", "a" in this order) and
23       "LL" is either directly corresponding to "l" or set to 99 if level type
24       is "s".
25

OPTIONS

27       The following command line options are available.
28
29       -v, --verbose
30           Print verbose information during processing.
31
32       -l, --language lang
33           Choose format of version file file. lang=""txt"", ANSI C
34           (lang="c"), M4 (lang="m4"), Perl (lang="perl") or Python
35           (lang="python"). Default is "txt".
36
37       -n, --name name
38           Name the program the version is maintained for. Default is
39           "unknown".
40
41       -p, --prefix prefix =item -s, --set version
42           Set the version to version.
43
44       -e, --edit
45           Interactively enter a new version.
46
47       -i, --increase knob
48           When option ``-i'' is used, the current version in file is updated
49           by increasing one element of the version where knob can be one of
50           the following: ``"v"'' for increasing the version by 1 (and
51           resetting revision and level to 0), ``"r"'' for increasing the
52           revision by 1 (and resetting level to 0) or ``"l"'' for increasing
53           the level by 1.
54
55       -d, --display type
56           Control the display type: ""short"" for a short version display,
57           ""long"" for a longer version display, ""hex"" for a hexadecimal
58           display of the version and ""libtool"" for a format suitable for
59           use with GNU libtool.
60

EXAMPLE

62        #   shell script
63        shtool version -l c -n FooBar -p foobar -s 1.2b3 version.c
64
65        #   configure.in
66        V=`shtool version -l c -d long version.c`
67        echo "Configuring FooBar, Version $V"
68

HISTORY

70       The GNU shtool version command was originally written by Ralf S.
71       Engelschall <rse@engelschall.com> in 1994 for OSSP eperl. It was later
72       rewritten from scratch for inclusion into GNU shtool.
73

SEE ALSO

75       shtool(1).
76
77
78
7918-Jul-2008                      shtool 2.0.8            SHTOOL-VERSION.TMP(1)
Impressum