document the actual problems that pkg_check-version can diagnose

diff --git a/share/man/man1/pkg_check-version.1 b/share/man/man1/pkg_check-version.1
index 8b1a7b6..8ded578 100644 (file)
--- a/share/man/man1/pkg_check-version.1
+++ b/share/man/man1/pkg_check-version.1
@@ -1,4 +1,4 @@
-.\"    $OpenBSD: pkg_check-version.1,v 1.2 2021/03/01 17:51:43 jmc Exp $
+.\"    $OpenBSD: pkg_check-version.1,v 1.3 2022/04/19 15:03:12 espie Exp $
 .\"
 .\" Copyright (c) 2021 Marc Espie <espie@openbsd.org>
 .\"
@@ -14,7 +14,7 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd $Mdocdate: March 1 2021 $
+.Dd $Mdocdate: April 19 2022 $
 .Dt PKG_CHECK-VERSION 1
 .Os
 .Sh NAME
@@ -49,6 +49,18 @@ verbose mode, which will explicitly state
 .Ar pkgname
 with no issues and sort one element lists.
 .El
+.Sh EXIT STATUS
+The
+.Nm
+utility exits with 0, unless one of the
+.Ar pkgname
+was malformed, or two names are actually non comparable
+.Po
+such as
+.Sq moo-1.23pre1
+and
+.Sq moo-1.23rc1
+.Pc .
 .Sh SEE ALSO
 .Xr packages-specs 7
 .Sh AUTHORS