[src/trunk]: src/usr.bin/make make(1): document CondParser_Comparison

[rillig <rillig%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/74bf6c515500
branches:  trunk
changeset: 954802:74bf6c515500
user:      rillig <rillig%NetBSD.org@localhost>
date:      Fri Sep 11 07:09:40 2020 +0000

description:
make(1): document CondParser_Comparison

diffstat:

 usr.bin/make/cond.c |  13 ++++++++++---
 1 files changed, 10 insertions(+), 3 deletions(-)

diffs (40 lines):

diff -r 2c09600713ae -r 74bf6c515500 usr.bin/make/cond.c
--- a/usr.bin/make/cond.c       Fri Sep 11 06:51:38 2020 +0000
+++ b/usr.bin/make/cond.c       Fri Sep 11 07:09:40 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: cond.c,v 1.128 2020/09/11 06:47:42 rillig Exp $        */
+/*     $NetBSD: cond.c,v 1.129 2020/09/11 07:09:40 rillig Exp $        */
 
 /*
  * Copyright (c) 1988, 1989, 1990 The Regents of the University of California.
@@ -70,14 +70,14 @@
  */
 
 #ifndef MAKE_NATIVE
-static char rcsid[] = "$NetBSD: cond.c,v 1.128 2020/09/11 06:47:42 rillig Exp $";
+static char rcsid[] = "$NetBSD: cond.c,v 1.129 2020/09/11 07:09:40 rillig Exp $";
 #else
 #include <sys/cdefs.h>
 #ifndef lint
 #if 0
 static char sccsid[] = "@(#)cond.c     8.2 (Berkeley) 1/2/94";
 #else
-__RCSID("$NetBSD: cond.c,v 1.128 2020/09/11 06:47:42 rillig Exp $");
+__RCSID("$NetBSD: cond.c,v 1.129 2020/09/11 07:09:40 rillig Exp $");
 #endif
 #endif /* not lint */
 #endif
@@ -523,6 +523,13 @@
     { NULL,    0, FALSE, NULL }
 };
 
+/* Parse a comparison condition such as:
+ *
+ *     0
+ *     ${VAR:Mpattern}
+ *     ${VAR} == value
+ *     ${VAR:U0} < 12345
+ */
 static Token
 CondParser_Comparison(CondParser *par, Boolean doEval)
 {