Changeset 27580


Ignore:
Timestamp:
Aug 9, 2007, 1:45:59 AM (12 years ago)
Author:
markd@…
Message:

Refinements and fixes to the dependency section.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc/guide/new/xml/portfileref.xml

    r27558 r27580  
    132132
    133133  <section>
    134     <title>Port Dependencies</title>
     134    <title>Dependencies</title>
    135135
    136136    <para>Free and open source software is highly modular, and MacPorts ports
     
    142142
    143143    <para>There are three types of dependencies in MacPorts: library, build,
    144     and run dependencies.</para>
     144    and run dependencies. The dependency type is important for proper port
     145    upgrade and uninstall behavior. For example, you may not uninstall a port
     146    that is a library dependency for another port, though you may remove one
     147    with a build dependency; likewise, upgrading a port will upgrade its
     148    library and build dependencies also, but not its run dependencies.</para>
    145149
    146150    <section>
     
    171175
    172176      <programlisting>depends_run         port:apache2</programlisting>
    173 
    174       <note>
    175         <para>The three dependency types become important for port upgrades
    176         and uninstalls. For example, you may not uninstall a port that is a
    177         library dependency for another port, though you may remove ports that
    178         are build dependencies for other ports.</para>
    179       </note>
    180177    </section>
    181178
     
    186183      possible. However, if satisfying a dependency with a port is not
    187184      practical or desirable for a special reason, you may specify
    188       dependencies in the Unix standard binary, library, or a specified
    189       path.</para>
     185      dependencies by having MacPorts test for an individual file by replacing
     186      <literal>port:</literal> with one of the options <literal>lib: bin: or
     187      path:</literal>.</para>
    190188
    191189      <para>In this lib style dependency, if the file
    192       <filename>libX11.6.2.dylib</filename> is not found in the library path
     190      <filename>libX11.6.x.dylib</filename> is not found in the library path
    193191      the XFree86 port will be installed to satisfy it.</para>
    194192
    195193      <programlisting>depends_lib         lib:libX11.6:XFree86</programlisting>
    196194
    197       <para>In this bin style dependency, if the <filename>rrdtool</filename>
    198       binary is not found in the binary path the port rrdtool will be
     195      <para>In this bin style dependency, if the <filename>python</filename>
     196      binary is not found in the shell's binary path the port python24 will be
    199197      installed.</para>
    200198
    201       <programlisting>depends_lib         bin:python:python24</programlisting>
    202 
    203       <para>In this path style dependency, if the <filename>nano</filename>
    204       binary is not found in the path /usr/bin/nano the nano port will be
     199      <programlisting>depends_build       bin:python:python24</programlisting>
     200
     201      <para>In this path style dependency, if the file
     202      <filename>/usr/bin/nano</filename> is not found the nano port will be
    205203      installed.</para>
    206204
    207       <programlisting>depends_lib         path:/usr/bin/nano:nano</programlisting>
     205      <programlisting>depends_run         path:/usr/bin/nano:nano</programlisting>
    208206    </section>
    209207  </section>
Note: See TracChangeset for help on using the changeset viewer.