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.