svn commit: r48261 - head/en_US.ISO8859-1/books/porters-handbook/makefiles

[Mathieu Arnold]

Author: mat
Date: Fri Feb 26 15:30:23 2016
New Revision: 48261
URL: https://svnweb.freebsd.org/changeset/doc/48261

Log:
  Add a tip about opt_VARS and whitespace.
  
  Reviewed by:	wblock
  Sponsored by:	Absolight
  Differential Revision:	https://reviews.freebsd.org/D5447

Modified:
  head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Feb 26 10:34:51 2016	(r48260)
+++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml	Fri Feb 26 15:30:23 2016	(r48261)
@@ -4487,6 +4487,22 @@ BIN3_BUILD=	yes
 .else
 BIN3_BUILD=	no
 .endif</programlisting>
+
+	<tip>
+	  <para>Values containing whitespace must be enclosed in
+	    quotes:</para>
+
+	  <programlisting>OPT_VARS=	foo="bar baz"</programlisting>
+
+	  <para>This is due to the way &man.make.1; variable expansion
+	    deals with whitespace.  When <literal>OPT_VARS= foo=bar
+	      baz</literal> is expanded, the variable ends up
+	    containing two strings, <literal>foo=bar</literal> and
+	    <literal>baz</literal>.  But the submitter probably
+	    intended there to be only one string, <literal>foo=bar
+	      baz</literal>.  Quoting the value prevents whitespace
+	    from being used as a delimiter.</para>
+	</tip>
       </sect3>
 
       <sect3 xml:id="options-dependencies">