vercmp
version comparison utility
SYNOPSIS
vercmp [ -h] [ --help] <version1> <version2>
DESCRIPTION
vercmp is used to determine the relationship between two given version numbers . It outputs values as follows: '-04' '+03' .sp -1
2.3 < 0 : if ver1 < ver2 '-04' '+03' .sp -1
2.3 = 0 : if ver1 == ver2 '-04' '+03' .sp -1
2.3 > 0 : if ver1 > ver2 Version comparison operates as follows: .RS 4
Alphanumeric: 1 .0a < 1 .0b < 1 .0beta < 1 .0p < 1 .0pre < 1 .0rc < 1 .0 < 1 .0 .a < 1 .0 .1 Numeric: 1 < 1 .0 < 1 .1 < 1 .1 .1 < 1 .2 < 2 .0 < 3 .0 .0 .RE Additionally, version strings can have an epoch value defined that will overrule any version comparison, unless the epoch values are equal . This is specified in an epoch:version -rel format . For example, 2:1 .0 -1 is always greater than 1:3 .6 -1 . Keep in mind that the pkgrel is only compared if it is available on both versions given to this tool . For example, comparing 1 .5 -1 and 1 .5 will yield 0; comparing 1 .5 -1 and 1 .5 -2 will yield < 0 as expected . This is mainly for supporting versioned dependencies that do not include the pkgrel .
2.3 < 0 : if ver1 < ver2 '-04' '+03' .sp -1
2.3 = 0 : if ver1 == ver2 '-04' '+03' .sp -1
2.3 > 0 : if ver1 > ver2 Version comparison operates as follows: .RS 4
Alphanumeric: 1 .0a < 1 .0b < 1 .0beta < 1 .0p < 1 .0pre < 1 .0rc < 1 .0 < 1 .0 .a < 1 .0 .1 Numeric: 1 < 1 .0 < 1 .1 < 1 .1 .1 < 1 .2 < 2 .0 < 3 .0 .0 .RE Additionally, version strings can have an epoch value defined that will overrule any version comparison, unless the epoch values are equal . This is specified in an epoch:version -rel format . For example, 2:1 .0 -1 is always greater than 1:3 .6 -1 . Keep in mind that the pkgrel is only compared if it is available on both versions given to this tool . For example, comparing 1 .5 -1 and 1 .5 will yield 0; comparing 1 .5 -1 and 1 .5 -2 will yield < 0 as expected . This is mainly for supporting versioned dependencies that do not include the pkgrel .
OPTIONS
-h, --help Display summary of the available return codes . Must be the first option specified .
EXAMPLES
.RS 4
$ vercmp 1 2 -1 .RE .RS 4
$ vercmp 2 1 1 .RE .RS 4
$ vercmp 2 .0 -1 1 .7 -6 1 .RE .RS 4
$ vercmp 2 .0 2 .0 -13 0 .RE .RS 4
$ vercmp 4 .34 1:001 -1 .RE
$ vercmp 1 2 -1 .RE .RS 4
$ vercmp 2 1 1 .RE .RS 4
$ vercmp 2 .0 -1 1 .7 -6 1 .RE .RS 4
$ vercmp 2 .0 2 .0 -13 0 .RE .RS 4
$ vercmp 4 .34 1:001 -1 .RE
BUGS
Bugs? You must be kidding; there are no bugs in this software . But if we happen to be wrong, send us an email with as much detail as possible to pacman -dev@archlinux .org .
AUTHORS
Current maintainers: '-04' '+03' .sp -1
2.3 Allan McRae <allan@archlinux .org> '-04' '+03' .sp -1
2.3 Andrew Gregory <andrew .gregory .8@gmail .com> '-04' '+03' .sp -1
2.3 Dan McGee <dan@archlinux .org> '-04' '+03' .sp -1
2.3 Dave Reisner <dreisner@archlinux .org> Past major contributors: '-04' '+03' .sp -1
2.3 Judd Vinet <jvinet@zeroflux .org> '-04' '+03' .sp -1
2.3 Aurelien Foret <aurelien@archlinux .org> '-04' '+03' .sp -1
2.3 Aaron Griffin <aaron@archlinux .org> '-04' '+03' .sp -1
2.3 Xavier Chantry <shiningxc@gmail .com> '-04' '+03' .sp -1
2.3 Nagy Gabor <ngaba@bibl .u -szeged .hu> For additional contributors, use git shortlog -s on the pacman .git repository .
2.3 Allan McRae <allan@archlinux .org> '-04' '+03' .sp -1
2.3 Andrew Gregory <andrew .gregory .8@gmail .com> '-04' '+03' .sp -1
2.3 Dan McGee <dan@archlinux .org> '-04' '+03' .sp -1
2.3 Dave Reisner <dreisner@archlinux .org> Past major contributors: '-04' '+03' .sp -1
2.3 Judd Vinet <jvinet@zeroflux .org> '-04' '+03' .sp -1
2.3 Aurelien Foret <aurelien@archlinux .org> '-04' '+03' .sp -1
2.3 Aaron Griffin <aaron@archlinux .org> '-04' '+03' .sp -1
2.3 Xavier Chantry <shiningxc@gmail .com> '-04' '+03' .sp -1
2.3 Nagy Gabor <ngaba@bibl .u -szeged .hu> For additional contributors, use git shortlog -s on the pacman .git repository .
