From 804935b97e0b73f4456e2c0661c7ca1c7ef7ad34 Mon Sep 17 00:00:00 2001
From: Mark Wooding <mdw@distorted.org.uk>
Date: Fri, 8 May 2020 20:15:30 +0100
Subject: [PATCH] utils/versioncmp.h: Add a wrapper macro for `versioncmp'.

Similar to the macros introduced for `strcmp' end friends in
3618811496a6d131fd4bffa19e262c521d39e819.
---
 utils/versioncmp.3 | 9 +++++++++
 utils/versioncmp.h | 1 +
 2 files changed, 10 insertions(+)

diff --git a/utils/versioncmp.3 b/utils/versioncmp.3
index f3afc18..15d1593 100644
--- a/utils/versioncmp.3
+++ b/utils/versioncmp.3
@@ -3,11 +3,13 @@
 .SH NAME
 versioncmp \- compare Debian-format version numbers
 .\" @versioncmp
+.\" @VERSIONCMP
 .SH SYNOPSIS
 .nf
 .B "#include <mLib/versioncmp.h>"
 
 .BI "int versioncmp(const char *" va ", const char *" vb ");"
+.BI "int VERSIONCMP(const char *" va ", " op ", const char *" vb ");"
 .fi
 .SH DESCRIPTION
 The
@@ -48,6 +50,13 @@ or +1 if
 .I va
 is newer than
 .IR vb .
+.PP
+The
+.B VERSIONCMP
+macro provides a more convenient syntax for the
+.B versioncmp
+function, by allowing a relational operator to be written between the
+operands.
 .SH SEE ALSO
 .BR mLib (3).
 .PP
diff --git a/utils/versioncmp.h b/utils/versioncmp.h
index efcb322..1990cc3 100644
--- a/utils/versioncmp.h
+++ b/utils/versioncmp.h
@@ -66,6 +66,7 @@
  */
 
 extern int versioncmp(const char */*va*/, const char */*vb*/);
+#define VERSIONCMP(x, op, y) (versioncmp((x), (y)) op 0)
 
 /*----- That's all, folks -------------------------------------------------*/
 
-- 
2.11.0