[pkgsrc/trunk]: pkgsrc/doc/guide/files Using <command> instead of <varname> t...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/dbe6a5e7011c
branches:  trunk
changeset: 493840:dbe6a5e7011c
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun May 15 20:31:45 2005 +0000

description:
Using <command> instead of <varname> to quote the .for loops.

diffstat:

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

diffs (52 lines):

diff -r ef470a7fa002 -r dbe6a5e7011c doc/guide/files/makefile.xml
--- a/doc/guide/files/makefile.xml      Sun May 15 20:30:54 2005 +0000
+++ b/doc/guide/files/makefile.xml      Sun May 15 20:31:45 2005 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: makefile.xml,v 1.12 2005/05/14 22:34:59 rillig Exp $ -->
+<!-- $NetBSD: makefile.xml,v 1.13 2005/05/15 20:31:45 rillig Exp $ -->
 
 <!-- based on:
 pkgsrc/bootstrap/bmake/for.c 1.1.1.1
@@ -66,9 +66,9 @@
     a string is splitted into words, it is splitted as you would expect
     it from &man.sh.1;.</para>
 
-    <para>No rule without exception&mdash;the ``.for'' loop does not
-    follow the shell quoting rules but splits at sequences of
-    whitespace.</para>
+    <para>No rule without exception&mdash;the <command>.for</command>
+    loop does not follow the shell quoting rules but splits at sequences
+    of whitespace.</para>
 
     <para>There are several types of variables that should be handled
     differently. Strings and two types of lists.</para>
@@ -85,15 +85,14 @@
       are never exported to any shell command. Their elements are
       separated by whitespace. Therefore the elements themselves cannot
       have embedded whitespace. Any other characters are allowed.
-      Internal lists can be used in <!-- FIXME
-      --><varname>.for</varname> loops. Examples are
-      <varname>DEPENDS</varname> and
+      Internal lists can be used in <command>.for</command> loops.
+      Examples are <varname>DEPENDS</varname> and
       <varname>BUILD_DEPENDS</varname>.</para></listitem>
 
       <listitem><para><emphasis>External lists</emphasis> are lists that
       may be exported to a shell command. Their elements can contain any
       characters, including whitespace. That's why they cannot be used
-      in <!-- FIXME --><varname>.for</varname> loops. Examples are
+      in <command>.for</command> loops. Examples are
       <varname>DISTFILES</varname> and
       <varname>MASTER_SITES</varname>.</para></listitem>
 
@@ -109,8 +108,8 @@
        not be used by package
        <filename>Makefile</filename>s.</para></listitem>
 
-       <listitem><para>In <!-- FIXME --><varname>.for</varname> loops
-       you should use lowercase variable names for the iteration
+       <listitem><para>In <command>.for</command> loops you should use
+       lowercase variable names for the iteration
        variables.</para></listitem>
 
       </itemizedlist>