Received: by mail.netbsd.org (Postfix, from userid 605)
	id DF49884E9F; Fri, 18 Nov 2022 19:35:04 +0000 (UTC)
Received: from localhost (localhost [127.0.0.1])
	by mail.netbsd.org (Postfix) with ESMTP id 1BDBD84D96
	for <pkgsrc-changes@NetBSD.org>; Fri, 18 Nov 2022 19:35:04 +0000 (UTC)
X-Virus-Scanned: amavisd-new at netbsd.org
Received: from mail.netbsd.org ([127.0.0.1])
	by localhost (mail.netbsd.org [127.0.0.1]) (amavisd-new, port 10025)
	with ESMTP id eGyuXg_MPJzh for <pkgsrc-changes@netbsd.org>;
	Fri, 18 Nov 2022 19:35:03 +0000 (UTC)
Received: from cvs.NetBSD.org (ivanova.NetBSD.org [IPv6:2001:470:a085:999:28c:faff:fe03:5984])
	by mail.netbsd.org (Postfix) with ESMTP id 8369384CD9
	for <pkgsrc-changes@NetBSD.org>; Fri, 18 Nov 2022 19:35:03 +0000 (UTC)
Received: by cvs.NetBSD.org (Postfix, from userid 500)
	id 7D283FA90; Fri, 18 Nov 2022 19:35:03 +0000 (UTC)
Content-Transfer-Encoding: 7bit
Content-Type: multipart/mixed; boundary="_----------=_1668800103170450"
MIME-Version: 1.0
Date: Fri, 18 Nov 2022 19:35:03 +0000
From: "Roland Illig" <rillig@netbsd.org>
Subject: CVS commit: pkgsrc/doc/guide/files
To: pkgsrc-changes@NetBSD.org
Reply-To: rillig@netbsd.org
X-Mailer: log_accum
Message-Id: <20221118193503.7D283FA90@cvs.NetBSD.org>
Sender: pkgsrc-changes-owner@NetBSD.org
List-Id: <pkgsrc-changes.NetBSD.org>
Precedence: bulk
List-Unsubscribe: <mailto:majordomo@NetBSD.org?subject=Unsubscribe%20pkgsrc-changes&body=unsubscribe%20pkgsrc-changes>

This is a multi-part message in MIME format.

--_----------=_1668800103170450
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
Content-Type: text/plain; charset="US-ASCII"

Module Name:	pkgsrc
Committed By:	rillig
Date:		Fri Nov 18 19:35:03 UTC 2022

Modified Files:
	pkgsrc/doc/guide/files: makefile.xml

Log Message:
guide: document how to test yes/no variables

https://mail-index.netbsd.org/tech-pkg/2022/11/16/msg026992.html


To generate a diff of this commit:
cvs rdiff -u -r1.30 -r1.31 pkgsrc/doc/guide/files/makefile.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.


--_----------=_1668800103170450
Content-Disposition: inline
Content-Length: 2384
Content-Transfer-Encoding: binary
Content-Type: text/x-diff; charset=us-ascii

Modified files:

Index: pkgsrc/doc/guide/files/makefile.xml
diff -u pkgsrc/doc/guide/files/makefile.xml:1.30 pkgsrc/doc/guide/files/makefile.xml:1.31
--- pkgsrc/doc/guide/files/makefile.xml:1.30	Sun Apr 28 11:16:07 2019
+++ pkgsrc/doc/guide/files/makefile.xml	Fri Nov 18 19:35:03 2022
@@ -1,4 +1,4 @@
-<!-- $NetBSD: makefile.xml,v 1.30 2019/04/28 11:16:07 rillig Exp $ -->
+<!-- $NetBSD: makefile.xml,v 1.31 2022/11/18 19:35:03 rillig Exp $ -->
 
 <chapter id="makefile"> <?dbhtml filename="makefile.html"?>
   <title>Programming in <filename>Makefile</filename>s</title>
@@ -47,13 +47,13 @@ correct:
     <filename>wrong</filename> will exist, although there was an error
     message in the first run. On the other hand, running <command>make
     correct</command> gives an error message twice, as expected.</para>
-    
+
     <para>You might remember that &man.make.1; sometimes removes
     <literal>${.TARGET}</literal> in case of error, but this only
     happens when it is interrupted, for example by pressing
     <literal>Ctrl+C</literal>. This does <emphasis>not</emphasis> happen
     when one of the commands fails (like &man.false.1; above).</para>
-    
+
     </listitem>
     </itemizedlist>
   </sect1>
@@ -229,7 +229,7 @@ install-examples:   # produces a syntax 
 To fix this syntax error, use one of the snippets below.</para>
 
 <programlisting>
-EMPTY=          # empty
+EGFILES=        # empty
 
 install-examples:
         for egfile in ${EGFILES} ""; do         \
@@ -257,5 +257,27 @@ enclosed in single or double quotes.</pa
 the following code: <code>${TEST} -z ${POSSIBLY_EMPTY:Q}""</code>.</para>
 
 </sect2>
+
+<sect2 id="makefile.yesno">
+<title>Testing yes/no variables in conditions</title>
+
+<para>When a variable can have the values <literal>yes</literal> or
+<literal>no</literal>, use the following pattern to test the variable:</para>
+
+<programlisting>
+.if ${VAR:U:tl} == "yes"
+# do something
+.endif
+</programlisting>
+
+<para>The <literal>:U</literal> modifier is only necessary if the variable
+can be undefined. If the variable is guaranteed to be defined, the
+<literal>:U</literal> can be omitted.</para>
+
+<para>The <literal>:tl</literal> modifier converts the variable value to
+lowercase, allowing for the values <literal>yes</literal>,
+<literal>Yes</literal>, <literal>YES</literal>.</para>
+
+</sect2>
 </sect1>
 </chapter>


--_----------=_1668800103170450--