[36803] trunk/doc-new/guide/xml/installing.xml

[markd at macports.org]

Revision: 36803
          http://trac.macosforge.org/projects/macports/changeset/36803
Author:   markd at macports.org
Date:     2008-05-14 18:24:38 -0700 (Wed, 14 May 2008)

Log Message:
-----------
Reference binpath in the install section to clearly distinguish it from $PATH,
but warn people against using it.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/installing.xml

Modified: trunk/doc-new/guide/xml/installing.xml
===================================================================
--- trunk/doc-new/guide/xml/installing.xml	2008-05-15 01:02:15 UTC (rev 36802)
+++ trunk/doc-new/guide/xml/installing.xml	2008-05-15 01:24:38 UTC (rev 36803)
@@ -297,9 +297,21 @@
         <para>A <varname>PATH</varname> variable is set as shown regardless of
         platform or environment that appends the MacPorts file paths in front
         of the default file paths so MacPorts libraries will take precedence
-        over vendor-supplied libraries.</para>
+        over vendor-supplied libraries for ported software at runtime.</para>
 
         <programlisting>export PATH=/opt/local/bin:/opt/local/sbin:$PATH</programlisting>
+
+        <note>
+          <para>The user environment's $PATH affects ported software at
+          runtime, i. e. after port installation, because the $PATH is
+          scrubbed before a port is installed. To change the search path for
+          locating system executables (rsync, tar, etc.) during port
+          installation, see the <link
+          linkend="internals.configuration-files.macports-conf">macports.conf</link>
+          file variable <varname>binpath</varname>, though changing this
+          variable is not generally needed or recomended, and for advanced
+          users only.</para>
+        </note>
       </listitem>
 
       <listitem>
@@ -359,4 +371,4 @@
 SECURITYSESSIONID=b0cea0
 _=/usr/bin/env</screen>
   </section>
-</chapter>
+</chapter>
\ No newline at end of file

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20080514/b79fafa6/attachment.htm