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.