[80729] trunk/doc-new/guide/xml/portfile-dependencies.xml

[mk at macports.org]

Revision: 80729
          http://trac.macports.org/changeset/80729
Author:   mk at macports.org
Date:     2011-07-16 08:05:35 -0700 (Sat, 16 Jul 2011)
Log Message:
-----------
Guide: be more specific about bin/lib/path dependencies

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-dependencies.xml

Modified: trunk/doc-new/guide/xml/portfile-dependencies.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-dependencies.xml	2011-07-16 14:29:46 UTC (rev 80728)
+++ trunk/doc-new/guide/xml/portfile-dependencies.xml	2011-07-16 15:05:35 UTC (rev 80729)
@@ -136,18 +136,28 @@
     <para>File dependencies may be of three types: <option>bin</option> for
     programs, <option>lib</option> for libraries, and <option>path</option>
     for any installed file. File dependencies are specifed in the form:
-    <replaceable><type></replaceable>:<replaceable><filespec></replaceable>:<replaceable><port></replaceable>.
-    For <option>bin</option> dependencies,
+    <replaceable><type></replaceable>:<replaceable><filespec></replaceable>:<replaceable><port></replaceable>.</para>
+    
+    <para>For <option>bin</option> dependencies,
     <replaceable><filespec></replaceable> is the name of a program in a
-    bin directory like <filename>${prefix}/bin</filename>. For
-    <option>lib</option> dependencies,
-    <replaceable><filespec></replaceable> is the name of a library in a
-    lib directory like <filename>${prefix}/lib</filename> but without its
-    extension. For <option>path</option> dependencies,
+    bin directory like <filename>${prefix}/bin</filename>, /usr/bin, /bin, and
+    the associated sbin directories.</para>
+    
+    <para>For <option>lib</option> dependencies,
+    <replaceable><filespec></replaceable> is the name of a library
+    (but without its extension) in a lib directory like
+    <filename>${prefix}/lib</filename>, /usr/lib, /lib, some Framework
+    directories, and those found in environment variables like DYLD_LIBRARY_PATH.</para>
+    
+    <para>For <option>path</option> dependencies,
     <replaceable><filespec></replaceable> is the complete absolute path
     to the file, or more usually, when the file is inside
     <filename>${prefix}</filename>, it is specified relative to
-    <filename>${prefix}</filename>.</para>
+    <filename>${prefix}</filename>.
+    Since <option>path</option> dependencies are the only ones which would find
+    files only in an absolute path or a path inside <filename>${prefix}</filename>
+    they are - in cases when a port needs to be more restrictive - often used
+    instead of <option>bin</option> and <option>lib</option> dependencies .</para>
 
     <para>Note that the <replaceable><port></replaceable> specified is
     only installed if the specified library, binary, or file is not found. See
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20110716/637fe6e1/attachment.html>