--- shtool.pod 2000/06/18 10:48:38 1.42
+++ shtool.pod 2000/06/30 16:27:41 1.43
@@ -266,7 +266,7 @@
=item B<version>
-Generate and maintain a version information file in either text, C or Perl
+Maintain a version information file in either text, C/C++, Perl or Python
format.
=item B<path>
@@ -698,31 +698,34 @@
return 0;
}
-=item B<version> [B<-l> I<lang>] [B<-n> I<name>] [B<-p> I<prefix>] [B<-s> I<version>] [B<-i> I<knob>] [B<-d> I<type>] I<file>
+=item B<version> [B<-l> I<lang>] [B<-n> I<name>] [B<-p> I<prefix>] [B<-s> I<version>] [B<-e>] [B<-i> I<knob>] [B<-d> I<type>] I<file>
-This command generates and maintains a version information file I<file>
-for program name I<name> in either textual (I<lang>="C<txt>"), ANSI
-C (I<lang>="c", Perl (I<lang>="perl") or Python (I<lang>="python")
-language. The version is always described with a triple
-E<lt>I<version>,I<revision>,I<patch/alpha/beta-level>E<gt> and is
+This command generates and maintains a version information file I<file> for
+program name I<name> in either textual (I<lang>="C<txt>"), ANSI C
+(I<lang>="c") or Perl (I<lang>="perl") language. The version is always
+described with a triple E<lt>I<version>,I<revision>,I<level>E<gt> and is
represented by a string which always matches the regular expression
-``C<[0-9]+\.[0-9]+[.abps][0-9]+>''. When the option ``B<-s>'' is given,
-the contents of I<file> is overridden with the specified I<version>.
+``C<[0-9]+\.[0-9]+[sabp.][0-9]+>''. When the option ``B<-s>'' is given, the
+contents of I<file> is overridden with the specified I<version>.
-When option ``B<-i>'' is used the version ingredients in I<file> are updated
-by adjusting one I<knob> of the version where I<knob> can be one of the
-following: ``C<a>'', ``C<b>'', ``C<p>'', ``C<P>'' and ``C<s>'' just increase
-the alpha/beta/patch/snap level by 1 (and set the separator character between
-version and the level position). ``C<r>'' increases the revision by 1 and sets
-the alpha/beta/patch/snap level to 0. ``C<v>'' increases the version by 1 and
-sets both the revision and alpha/beta/patch/snap level to 0.
-
-When option ``B<-d>'' is given the current version in I<file> is displayed
-either in short (I<type>="short") or long (I<type>="long") texual format or in
-a format suitable for use with GNU libtool (I<type>="libtool") or in a
-hexadecimal format (I<type>="hex").
-
-When no option is given at all, ``C<-i P>'' is assumed.
+When option ``B<-i>'' is used, the current version in I<file> is updated
+by increasing one element of the version where I<knob> can be one of
+the following: ``C<v>'' for increasing the version by 1 (and resetting
+revision and level to 0), ``C<r>'' for increasing the revision by 1 (and
+resetting level to 0) or ``C<l>'' for increasing the level by 1. Option
+``B<-e>'' can be used to interactively enter a new version.
+
+Unless option ``B<-e>'', ``B<-i>'' or ``B<-s>'' is specified, the performed
+action is to display the current version. Option ``B<-d>'' then can be used
+to control the display type: "C<short>" for a short version display, "C<long>"
+for a longer version display, "C<hex>" for a hexadecial display of the version
+and "C<libtool>" for a format suitable for use with GNU libtool.
+
+The hexadecimal format for a version C<v.rtl> is C<VVRRTLL> where C<VV>
+and C<RR> directly correspond to C<v> and C<r>, C<T> encodes the level
+type as C<9>, C<2>, C<1>, C<0> (representing C<s>, C<p>/C<.>, C<b>, C<a>
+in this order) and C<LL> is either directly corresponding to C<l> or set
+to C<99> if level type is C<s>.
Example:
|
