[src/trunk]: src/usr.bin/make make(1): document parameter to Var_Parse

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

details:   https://anonhg.NetBSD.org/src/rev/e8944ecef0d1
branches:  trunk
changeset: 945099:e8944ecef0d1
user:      rillig <rillig%NetBSD.org@localhost>
date:      Tue Oct 20 23:15:23 2020 +0000

description:
make(1): document parameter to Var_Parse

diffstat:

 usr.bin/make/var.c |  8 ++++++--
 1 files changed, 6 insertions(+), 2 deletions(-)

diffs (29 lines):

diff -r 67493e51ef69 -r e8944ecef0d1 usr.bin/make/var.c
--- a/usr.bin/make/var.c        Tue Oct 20 23:04:35 2020 +0000
+++ b/usr.bin/make/var.c        Tue Oct 20 23:15:23 2020 +0000
@@ -1,4 +1,4 @@
-/*     $NetBSD: var.c,v 1.578 2020/10/18 17:19:54 rillig Exp $ */
+/*     $NetBSD: var.c,v 1.579 2020/10/20 23:15:23 rillig Exp $ */
 
 /*
  * Copyright (c) 1988, 1989, 1990, 1993
@@ -121,7 +121,7 @@
 #include    "metachar.h"
 
 /*     "@(#)var.c      8.3 (Berkeley) 3/19/94" */
-MAKE_RCSID("$NetBSD: var.c,v 1.578 2020/10/18 17:19:54 rillig Exp $");
+MAKE_RCSID("$NetBSD: var.c,v 1.579 2020/10/20 23:15:23 rillig Exp $");
 
 #define VAR_DEBUG1(fmt, arg1) DEBUG1(VAR, fmt, arg1)
 #define VAR_DEBUG2(fmt, arg1, arg2) DEBUG2(VAR, fmt, arg1, arg2)
@@ -3445,6 +3445,10 @@
  *     modifiers and find its value by applying the modifiers to the
  *     original value.
  *
+ *     When parsing a condition in ParseEmptyArg, pp may also point to
+ *     the "y" of "empty(VARNAME:Modifiers)", which is syntactically
+ *     identical.
+ *
  * Input:
  *     str             The string to parse
  *     ctxt            The context for the variable