NAME
Pandoc::Version - version number of pandoc and its libraries
SYNOPSIS
$version
= Pandoc::Version->new(
"1.17.2"
);
# create version
$version
=
bless
[1,17,2],
'Pandoc::Version'
;
# equivalent
"$version"
;
# stringify to "1.17.2"
$version
> 1.9;
# compare
$version
->[0];
# major
$version
->[1];
# minor
$version
->match(
'1.17'
);
# true for 1.17, 1.17.x, 1.17.x.y...
DESCRIPTION
This module is used to store and compare version numbers of pandoc executable and Haskell libraries compiled into pandoc. A Pandoc::Version object is an array reference of one or more non-negative integer values.
In most cases there is no need to create Pandoc::Version objects by hand. Just use the instances returned by methods version
and libs
of module Pandoc and trust in overloading.
METHODS
string
Return a string representation of a version, for instance "1.17.0.4"
. This method is automatically called by overloading in string context.
number
Return a number representation of a version, for instance 1.017000004
. This method is automatically called by overloading in number context.
cmp( $version )
Compare two version numbers. This is method is used automatically by overloading to compare version objects with strings or numbers (operators eq
, lt
, le
, ge
, ==
, <
, >
, <=
, and >=
).
match( $version )
Return whether a version number matches another version number if cut to the same number of parts. For instance 1.2.3
matches 1
, 1.2
, and 1.2.3
.
fulfills( $version_requirement )
Return whether a version number fullfills a version requirement, such as !=1.16, <=1.17
. See "Version Ranges" in CPAN::Meta::Spec for possible values.
TO_JSON
Return an array reference of the version number to serialize in JSON format.
SEE ALSO
version is a similar module for Perl version numbers.
SemVer extends versions to Semantic Versioning as described at http://semver.org/.
Pandoc::Release to get information about and download pandoc releases.