Perl client $VERSION should be numeric
Jamie McCarthy
jamie@mccarthy.vg
Wed, 31 Mar 2004 12:42:57 -0500
The version number for the latest Cache::Memcached is 1.0.12. For
the next release, it should be set to 1.13.
perldoc perlmodlib:
o Give the module a version/issue/release number.
To be fully compatible with the Exporter and
MakeMaker modules you should store your module's
version number in a non-my package variable called
$VERSION. This should be a floating point number
with at least two digits after the decimal (i.e.,
hundredths, e.g, "$VERSION =3D "0.01""). Don't use a
"1.3.2" style version.
perldoc perlstyle:
The most common CPAN version numbering scheme looks like this:
1.00, 1.10, 1.11, 1.20, 1.30, 1.31, 1.32
A correct CPAN version number is a floating point number
with at least 2 digits after the decimal. You can test
whether it conforms to CPAN by using
perl -MExtUtils::MakeMaker -le 'print MM->parse_version(shift)' =
'Foo.pm'
If you want to release a 'beta' or 'alpha' version of a
module but don't want CPAN.pm to list it as most recent use
an '_' after the regular version number followed by at
least 2 digits, eg. 1.20_01.
perldoc Exporter:
Since the default require_version method treats the
$VERSION number as a simple numeric value it will regard
version 1.10 as lower than 1.9. For this reason it is
strongly recommended that you use numbers with at least two
decimal places, e.g., 1.09.
The symptom right now is that if you have 1.0.11 or any previous
1.0 version of Cache::Memcached installed, CPAN will report that
it is already up to date, and refuse to install without a "force,"
since:
$ perl -le 'print "1.0.11" =3D=3D "1.0.12"'
1
--=20
Jamie McCarthy
http://mccarthy.vg/
jamie@mccarthy.vg