1.\" $OpenBSD: pkg_check-version.1,v 1.3 2022/04/19 15:03:12 espie Exp $ 2.\" 3.\" Copyright (c) 2021 Marc Espie <espie@openbsd.org> 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: April 19 2022 $ 18.Dt PKG_CHECK-VERSION 1 19.Os 20.Sh NAME 21.Nm pkg_check-version 22.Nd verify parsing and ordering of package names 23.Sh SYNOPSIS 24.Nm 25.Op Fl Hv 26.Ar pkgname ... 27.Sh DESCRIPTION 28.Nm 29takes a list of 30.Ar pkgname 31and processes them. 32.Bl -bullet -compact 33.It 34each name is parsed and checked for issues. 35.It 36in addition, comparable names (same stem and same flavor) are sorted 37from older to newer version. 38.El 39.Pp 40Options are as follows: 41.Bl -tag -width Hv 42.It Fl H 43displays a human-readable version of each 44.Ar pkgname 45(full version parsing, including known suffixes, dewey numbers parsing, 46REVISION, EPOCH, flavor markers). 47.It Fl v 48verbose mode, which will explicitly state 49.Ar pkgname 50with no issues and sort one element lists. 51.El 52.Sh EXIT STATUS 53The 54.Nm 55utility exits with 0, unless one of the 56.Ar pkgname 57was malformed, or two names are actually non comparable 58.Po 59such as 60.Sq moo-1.23pre1 61and 62.Sq moo-1.23rc1 63.Pc . 64.Sh SEE ALSO 65.Xr packages-specs 7 66.Sh AUTHORS 67.An Marc Espie Aq Mt espie@openbsd.org 68