diff options
| author | rillig <rillig@pkgsrc.org> | 2005-05-15 20:31:45 +0000 |
|---|---|---|
| committer | rillig <rillig@pkgsrc.org> | 2005-05-15 20:31:45 +0000 |
| commit | 0390e4d07f38c33fed7904721380ae0fdecbc4dd (patch) | |
| tree | c68f1936a8a409189db1420bed4e5dcfa01b19e8 /doc | |
| parent | 2b43f50777155fd63be67414a65eab1b777a5341 (diff) | |
| download | pkgsrc-0390e4d07f38c33fed7904721380ae0fdecbc4dd.tar.gz | |
Using <command> instead of <varname> to quote the .for loops.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guide/files/makefile.xml | 19 |
1 files changed, 9 insertions, 10 deletions
diff --git a/doc/guide/files/makefile.xml b/doc/guide/files/makefile.xml index b55ca920d09..053a5812e30 100644 --- a/doc/guide/files/makefile.xml +++ b/doc/guide/files/makefile.xml @@ -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 @@ pkgsrc/bootstrap/bmake/var.c 1.2 a string is splitted into words, it is splitted as you would expect it from &man.sh.1;.</para> - <para>No rule without exception—the ``.for'' loop does not - follow the shell quoting rules but splits at sequences of - whitespace.</para> + <para>No rule without exception—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 @@ pkgsrc/bootstrap/bmake/var.c 1.2 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 @@ pkgsrc/bootstrap/bmake/var.c 1.2 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> |