[pkgsrc/trunk]: pkgsrc/doc/guide/files Added documentation for a bug in bmake...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/c2c54164e099
branches:  trunk
changeset: 493866:c2c54164e099
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun May 15 23:46:20 2005 +0000

description:
Added documentation for a bug in bmake, and a reference to the package
regress/make-quoting, where a more complete example and a workaround is
presented.

diffstat:

 doc/guide/files/makefile.xml |  20 +++++++++++++++++++-
 1 files changed, 19 insertions(+), 1 deletions(-)

diffs (33 lines):

diff -r 1ef4c39e37bb -r c2c54164e099 doc/guide/files/makefile.xml
--- a/doc/guide/files/makefile.xml      Sun May 15 23:37:13 2005 +0000
+++ b/doc/guide/files/makefile.xml      Sun May 15 23:46:20 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: makefile.xml,v 1.13 2005/05/15 20:31:45 rillig Exp $ -->
+<!-- $NetBSD: makefile.xml,v 1.14 2005/05/15 23:46:20 rillig Exp $ -->
 
 <!-- based on:
 pkgsrc/bootstrap/bmake/for.c 1.1.1.1
@@ -301,5 +301,23 @@
       </itemizedlist>
     </sect2>
 
+    <sect2>
+      <title>Workaround for a bug in BSD Make</title>
+
+      <para>The pkgsrc bmake program does not handle the following
+      assignment correctly. In case <varname>_othervar_</varname>
+      contains a ``-'' character, one of the closing braces is included
+      in <varname>${VAR}</varname> after this code executes.</para>
+
+      <programlisting>
+        VAR:= ${VAR:N${_othervar_:C/-//}}
+      </programlisting>
+
+      <para>For a more complex code snippet and a workaround, see the
+      package <pkg>regress/make-quoting</pkg>, testcase
+      <varname>bug1</varname>.</para>
+
+    </sect2>
+
   </sect1>
 </chapter>