[pkgsrc/trunk]: pkgsrc/doc/guide/files Specified the structure and interpreta...

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

details:   https://anonhg.NetBSD.org/pkgsrc/rev/845f50e5fbad
branches:  trunk
changeset: 511758:845f50e5fbad
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Fri Apr 21 07:54:12 2006 +0000

description:
Specified the structure and interpretation of the WRAPPER_REORDER_CMDS
variable.

diffstat:

 doc/guide/files/build.xml |  19 +++++++++++--------
 1 files changed, 11 insertions(+), 8 deletions(-)

diffs (40 lines):

diff -r f49dda1fa36f -r 845f50e5fbad doc/guide/files/build.xml
--- a/doc/guide/files/build.xml Fri Apr 21 07:30:32 2006 +0000
+++ b/doc/guide/files/build.xml Fri Apr 21 07:54:12 2006 +0000
@@ -1,8 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.26 2006/04/21 07:30:32 rillig Exp $ -->
-
-<!--
-       TODO: after 2006Q1, "SITES_" should be replaced with "SITES.".
--->
+<!-- $NetBSD: build.xml,v 1.27 2006/04/21 07:54:12 rillig Exp $ -->
 
 <chapter id="build">
 <title>The build process</title>
@@ -220,7 +216,7 @@
 
          <para>where ${site} varies through several possibilities in turn: first,
            <varname>MASTER_SITE_OVERRIDE</varname> is tried, then the sites
-           specified in either <varname>SITES_file</varname> if defined, else
+           specified in either <varname>SITES.file</varname> if defined, else
            <varname>MASTER_SITES</varname> or <varname>PATCH_SITES</varname>, as
            applies, then finally the value of
            <varname>MASTER_SITE_BACKUP</varname>. The order of all except the
@@ -354,8 +350,15 @@
                it.</para></listitem></varlistentry>
 
        <varlistentry><term><varname>WRAPPER_REORDER_CMDS</varname></term>
-               <listitem><para>A list of reordering commands. [TODO:
-               investigate further]</para></listitem></varlistentry>
+
+               <listitem><para>A list of reordering commands. A
+               reordering command has the form
+               <literal>reorder:l:<replaceable>lib1</replaceable>:<replaceable>lib2</replaceable></literal>.
+               It ensures that that
+               <literal>-l<replaceable>lib1</replaceable></literal>
+               occurs before
+               <literal>-l<replaceable>lib2</replaceable></literal>.
+               </para></listitem></varlistentry>
 
        <varlistentry><term><varname>WRAPPER_TRANSFORM_CMDS</varname></term>
                <listitem><para>A list of transformation commands. [TODO: