Changeset 70013 for trunk/doc-new


Ignore:
Timestamp:
Jul 26, 2010, 11:23:22 AM (9 years ago)
Author:
jmr@…
Message:

guide: update dependencies section

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-dependencies.xml

    r58044 r70013  
    99  for a given port are called a port's <quote>dependencies</quote>.</para>
    1010
    11   <para>The three keywords used when specifying dependencies in a Portfile are
     11  <para>The keywords used when specifying dependencies in a Portfile are
    1212  related to port install phases, and they refer to what are called library,
    13   build, and run dependencies. Though all of them install dependencies before
    14   a given port is installed, specifying dependencies with the correct keyword
    15   is important for proper port upgrade and uninstall behavior. For example,
    16   you may not uninstall a port that is a library dependency for another port,
    17   though you may remove one that is a build dependency; likewise, upgrading a
    18   port will upgrade its library and build dependencies also, but not its run
    19   dependencies.</para>
     13  build, fetch, extract and run dependencies. Though all of them install dependencies
     14  before a given port is installed, specifying dependencies with the correct keyword
     15  is important for proper port upgrade and uninstall behavior, or when running targets
     16  other than install. For example,
     17  you may not uninstall a port that is a library dependency for another installed port,
     18  though you may remove one that is a build dependency. Likewise, if you run the
     19  fetch target for a port, only the fetch dependencies will be installed first, so
     20  they should be all that is needed for that target.</para>
    2021
    2122  <variablelist>
    2223    <varlistentry>
    23       <term>depends_lib</term>
     24      <term>depends_fetch</term>
    2425
    25       <term>depends_lib-append</term>
     26      <term>depends_fetch-append</term>
    2627
    27       <term>depends_lib-delete</term>
     28      <term>depends_fetch-delete</term>
    2829
    2930      <listitem>
    3031        <para>The list of dependencies to check before phases
     32        <option>fetch</option>, <option>checksum</option>,
     33        <option>extract</option>, <option>patch</option>,
    3134        <option>configure</option>, <option>build</option>,
    3235        <option>destroot</option>, <option>install</option>, and
    33         <option>package</option>. Library dependencies are needed both at
    34         build time (for headers and libraries to link against) and at run
    35         time.</para>
     36        <option>package</option>. Fetch dependencies are needed to download
     37        the distfiles for a port, and are not needed at all once the software
     38        is installed.</para>
     39      </listitem>
     40    </varlistentry>
     41
     42    <varlistentry>
     43      <term>depends_extract</term>
     44
     45      <term>depends_extract-append</term>
     46
     47      <term>depends_extract-delete</term>
     48
     49      <listitem>
     50        <para>The list of dependencies to check before phases
     51        <option>extract</option>, <option>patch</option>,
     52        <option>configure</option>, <option>build</option>,
     53        <option>destroot</option>, <option>install</option>, and
     54        <option>package</option>. Extract dependencies are needed to unpack a
     55        port's distfiles into the work directory, and are not needed at all once
     56        the software is installed.</para>
    3657      </listitem>
    3758    </varlistentry>
     
    4970        <option>destroot</option>, <option>install</option>, and
    5071        <option>package</option>. Build dependencies are needed when software
    51         is compiled, but not needed at all once the software is compiled and
    52         installed.</para>
     72        is being built, but not needed at all once it is installed.</para>
     73      </listitem>
     74    </varlistentry>
     75
     76    <varlistentry>
     77      <term>depends_lib</term>
     78
     79      <term>depends_lib-append</term>
     80
     81      <term>depends_lib-delete</term>
     82
     83      <listitem>
     84        <para>The list of dependencies to check before phases
     85        <option>configure</option>, <option>build</option>,
     86        <option>destroot</option>, <option>install</option>, and
     87        <option>package</option>. Library dependencies are needed both at
     88        build time (for headers and libraries to link against) and at run
     89        time.</para>
    5390      </listitem>
    5491    </varlistentry>
Note: See TracChangeset for help on using the changeset viewer.