Changeset 31923 for trunk/doc-new


Ignore:
Timestamp:
Dec 12, 2007, 2:48:59 AM (12 years ago)
Author:
markd@…
Message:

Use a variable list instead of many sections in the phase introduction.

File:
1 edited

Legend:

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

    r31902 r31923  
    22<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    4 
    54<section id="reference.phases">
    65  <title>Port Phases</title>
     
    1918    Development</link> chapter.</para>
    2019
    21     <section id="reference.phases.introduction.fetch">
    22       <title>Fetch</title>
    23 
    24       <para>Overview: Fetch the <varname>${distfiles}</varname> from
    25       <varname>${master_sites}</varname> and place it in
    26       <filename>${prefix}/var/macports/distfiles</filename>.</para>
    27     </section>
    28 
    29     <section id="reference.phases.introduction.checksum">
    30       <title>Checksum</title>
    31 
    32       <para>Overview: Compare <varname>${checksums}</varname> specified in a
    33       <filename>Portfile</filename> to the checksums of the fetched
    34       ${distfiles}.</para>
    35     </section>
    36 
    37     <section id="reference.phases.introduction.extract">
    38       <title>Extract</title>
    39 
    40       <para>Overview: Unzip and untar the <varname>${distfiles}</varname> into
    41       the path ${prefix}/var/macports/build/..../work</para>
    42     </section>
    43 
    44     <section id="reference.phases.introduction.patch">
    45       <title>Patch</title>
    46 
    47       <para>Overview: Apply optional <ulink
    48       url="http://en.wikipedia.org/wiki/Patch_(Unix)">patch</ulink> files
    49       specified in <varname>${patchfiles}</varname> to modify a port's source
    50       code file(s).</para>
    51 
    52       <para>Details: Patch files are made using the <ulink
    53       url="http://en.wikipedia.org/wiki/Diff">diff</ulink> command, and
    54       MacPorts patches should be created as <ulink
    55       url="http://en.wikipedia.org/wiki/Diff#Unified_format">unified
    56       diffs</ulink>.</para>
    57     </section>
    58 
    59     <section id="reference.phases.introduction.configure">
    60       <title>Configure</title>
    61 
    62       <para>Overview: Execute the command "configure" in
    63       <varname>${workpath}</varname>.</para>
    64     </section>
    65 
    66     <section id="reference.phases.introduction.build">
    67       <title>Build</title>
    68 
    69       <para>Overview: Execute the command "make" in
    70       <varname>${workpath}</varname>.</para>
    71     </section>
    72 
    73     <section id="reference.phases.introduction.destroot">
    74       <title>Destroot</title>
    75 
    76       <para>Overview: Execute the command <command>make install
    77       DESTDIR=${destroot}</command> in <varname>${workpath}</varname>.</para>
    78 
    79       <para>Details: Understanding the destroot phase is critical to
    80       understanding MacPorts, because, unlike some port systems, MacPorts
    81       "stages" an installation into an intermediate location —not the final
    82       file destination. There are two main advantages to this method.</para>
    83 
    84       <orderedlist>
    85         <listitem>
    86           <para>A port's files may be cleanly uninstalled because all files
    87           and locations are tracked.</para>
    88         </listitem>
    89 
    90         <listitem>
    91           <para>Since a port's files are not installed into MacPorts directory
    92           structure until an activation phase, a port may be deactivated
    93           through MacPorts to allow activation of a different version of the
    94           same port, thus allowing two versions of a port to be present,
    95           though not both active, on a given host.</para>
    96         </listitem>
    97       </orderedlist>
    98 
    99       <note>
    100         <para>The <varname>$(DESTDIR)</varname> variable must be supported in
    101         an application's Makefile for the MacPorts destroot phase to work
    102         properly. Urge developers to fully support
    103         <varname>$(DESTDIR)</varname> in their Makefiles.</para>
    104       </note>
    105 
    106       <para>At the beginning of the destroot phase, all the directories in the
    107       file <filename>${prefix}/etc/macports/prefix.mtree</filename> are
    108       created. Any directories still empty upon completion of the destroot
    109       phase are removed unless a directory is listed using a destroot.keepdirs
    110       keyword.</para>
    111     </section>
    112 
    113     <section id="reference.phases.introduction.archive">
    114       <title>Archive</title>
    115 
    116       <para>Overview: Use tar to create a tarball of a port's destrooted files
    117       and copy it to
    118       <filename>${prefix}/var/macports/packages/</filename>.</para>
    119     </section>
    120 
    121     <section id="reference.phases.introduction.install">
    122       <title>Install</title>
    123 
    124       <para>Overview: Copy a port's destrooted files into
    125       <filename>${prefix}/var/macports/software</filename>. See <link
    126       linkend="internals.images">Port Images</link> in the <link
    127       linkend="internals">MacPorts Internals</link> chapter for
    128       details.</para>
    129     </section>
    130 
    131     <section id="reference.phases.introduction.activate">
    132       <title>Activate</title>
    133 
    134       <para>Overview: Set <ulink
    135       url="http://en.wikipedia.org/wiki/Hard_link">hardlinks</ulink> pointing
    136       to <filename>${prefix}/var/macports/software</filename> to point to
    137       ${prefix}.</para>
    138     </section>
     20    <variablelist>
     21      <varlistentry>
     22        <term>fetch</term>
     23
     24        <listitem>
     25          <para>Fetch the <varname>${distfiles}</varname> from
     26          <varname>${master_sites}</varname> and place it in
     27          <filename>${prefix}/var/macports/distfiles/${name}</filename>.</para>
     28        </listitem>
     29      </varlistentry>
     30
     31      <varlistentry>
     32        <term>checksum</term>
     33
     34        <listitem>
     35          <para>Compare <varname>${checksums}</varname> specified in a
     36          <filename>Portfile</filename> to the checksums of the fetched
     37          ${distfiles}.</para>
     38        </listitem>
     39      </varlistentry>
     40
     41      <varlistentry>
     42        <term>extract</term>
     43
     44        <listitem>
     45          <para>Unzip and untar the <varname>${distfiles}</varname> into the
     46          path ${prefix}/var/macports/build/..../work</para>
     47        </listitem>
     48      </varlistentry>
     49
     50      <varlistentry>
     51        <term>patch</term>
     52
     53        <listitem>
     54          <para>Apply optional <ulink
     55          url="http://en.wikipedia.org/wiki/Patch_(Unix)">patch</ulink> files
     56          specified in <varname>${patchfiles}</varname> to modify a port's
     57          source code file(s).</para>
     58        </listitem>
     59      </varlistentry>
     60
     61      <varlistentry>
     62        <term>configure</term>
     63
     64        <listitem>
     65          <para>Execute the command <command>configure</command> in
     66          <varname>${workpath}</varname>.</para>
     67        </listitem>
     68      </varlistentry>
     69
     70      <varlistentry>
     71        <term>build</term>
     72
     73        <listitem>
     74          <para>Execute the command <command>make</command> in
     75          <varname>${workpath}</varname>.</para>
     76        </listitem>
     77      </varlistentry>
     78
     79      <varlistentry>
     80        <term>destroot</term>
     81
     82        <listitem>
     83          <para>Execute the command <command>make install</command>
     84          <varname>DESTDIR=${destroot}</varname>in
     85          <varname>${workpath}</varname>.</para>
     86
     87          <para>Understanding the destroot phase is critical to understanding
     88          MacPorts, because, unlike some port systems, MacPorts "stages" an
     89          installation into an intermediate location —not the final file
     90          destination. MacPorts uses the destroot phase to provide:</para>
     91
     92          <itemizedlist>
     93            <listitem>
     94              <para>Port uninstalls - a port's files may be cleanly
     95              uninstalled because all files and directories are recorded
     96              during install.</para>
     97            </listitem>
     98
     99            <listitem>
     100              <para>Multiple port versions may be installed on the same host,
     101              since a port's files are not directly inserted into
     102              <varname>${prefix}</varname> but rather hard-linked into
     103              <varname>${prefix}</varname> from an intermediate location
     104              during a later activation phase.</para>
     105            </listitem>
     106          </itemizedlist>
     107
     108          <note>
     109            <para>The <varname>DESTDIR</varname> variable must be supported in
     110            an application's Makefile for the MacPorts destroot phase to work
     111            properly. Urge developers to fully support
     112            <varname>DESTDIR</varname> in their Makefiles.</para>
     113          </note>
     114
     115          <para>Any empty directories in ${destroot} upon completion of the
     116          destroot phase are removed unless a directory name is placed in the
     117          value field of the optional destroot.keepdirs keyword.</para>
     118        </listitem>
     119      </varlistentry>
     120
     121      <varlistentry>
     122        <term>archive</term>
     123
     124        <listitem>
     125          <para>Use tar to create a tarball of a port's destrooted files and
     126          copy it to
     127          <filename>${prefix}/var/macports/packages/</filename>.</para>
     128        </listitem>
     129      </varlistentry>
     130
     131      <varlistentry>
     132        <term>install</term>
     133
     134        <listitem>
     135          <para>Copy a port's destrooted files into
     136          <filename>${prefix}/var/macports/software</filename>. See <link
     137          linkend="internals.images">Port Images</link> in the <link
     138          linkend="internals">MacPorts Internals</link> chapter for
     139          details.</para>
     140        </listitem>
     141      </varlistentry>
     142
     143      <varlistentry>
     144        <term>activate</term>
     145
     146        <listitem>
     147          <para>Set <ulink
     148          url="http://en.wikipedia.org/wiki/Hard_link">hardlinks</ulink>
     149          pointing to <filename>${prefix}/var/macports/software</filename> to
     150          point to <varname>${prefix}</varname>.</para>
     151        </listitem>
     152      </varlistentry>
     153    </variablelist>
    139154  </section>
    140155
     
    154169
    155170    <section id="reference.phases.installation.list-modifiers">
    156       <title>A Word about Keyword List Modifiers (-append / -delete)</title>
    157 
    158       <para>It is often necessary to add to a list of keyword values
    159       previously set by a previously executed Portfile keyword or by MacPorts
    160       base. To keep from overwriting a previous keyword list, use a keyword
    161       list modifier. Keywords that support list modifiers are identified under
    162       appropriate reference sections below.</para>
    163 
    164       <para>The three most common uses for keyword list modifiers are to
    165       preserve configure defaults, to preserve PortGroup dependencies, and to
    166       add or delete items for variants.</para>
    167 
    168       <section id="reference.phases.installation.list-modifiers.uses">
    169         <title>Common Uses for Keyword List Modifiers</title>
    170 
    171         <para>The three most common uses for keyword list modifiers are to
    172         preserve configure defaults, to preserve PortGroup dependencies, and
    173         to add or delete items for variants.</para>
    174 
    175         <variablelist>
    176           <varlistentry>
    177             <term>Preserve configure Defaults</term>
    178 
    179             <listitem>
    180               <para>MacPorts base sets the gcc compiler flags CFLAGS and
    181               LDFLAGS for all ports using <literal>configure.cflags</literal>
    182               and <literal>configure.ldflags</literal>, therefore to keep from
    183               overwriting the default compiler flags use
    184               <literal>configure.cflags-append</literal> and
    185               <literal>configure.ldflags-append</literal>.</para>
    186 
    187               <itemizedlist>
    188                 <listitem>
    189                   <para><code>configure.cflags-append</code></para>
    190                 </listitem>
    191 
    192                 <listitem>
    193                   <para><code>configure.ldflags-append</code></para>
    194                 </listitem>
    195               </itemizedlist>
    196             </listitem>
    197           </varlistentry>
    198 
    199           <varlistentry>
    200             <term>Preserve PortGroup Dependencies</term>
    201 
    202             <listitem>
    203               <para>Ports in a PortGroup have default library dependencies set
    204               by MacPorts base. Therefore, never use
    205               <literal>depends_lib</literal> in ports belonging to a PortGroup
    206               or it will overwrite the default library dependencies. Instead,
    207               use <literal>depends_lib-append</literal>.</para>
    208             </listitem>
    209           </varlistentry>
    210 
    211           <varlistentry>
    212             <term>Add or Delete Items for Variants</term>
    213 
    214             <listitem>
    215               <para>When a variant requires more or fewer dependencies,
    216               distfiles, or patchfiles, when the variant is invoked you want
    217               to add or remove items to the appropriate keyword values list
    218               set in the global section of the Portfile. Use the appropriate
    219               keywords, for example:</para>
    220 
    221               <itemizedlist>
    222                 <listitem>
    223                   <para><code>depends_lib-append</code> or
    224                   <code>depends_lib-delete</code></para>
    225                 </listitem>
    226 
    227                 <listitem>
    228                   <para><code>distfiles-append</code> or
    229                   <code>distfile-delete</code></para>
    230                 </listitem>
    231 
    232                 <listitem>
    233                   <para><code>patchfiles-append</code> or
    234                   <code>patchfiles-delete</code></para>
    235                 </listitem>
    236               </itemizedlist>
    237             </listitem>
    238           </varlistentry>
    239         </variablelist>
    240       </section>
     171      <title>Keyword List Modifiers (-append / -delete)</title>
     172
     173      <para>Keyword list modifiers are keywords that end in -append or
     174      -delete. Keywords that support list modifiers are identified under
     175      appropriate reference sections below. Keyword list modifiers are most
     176      frequently used for these three purposes:</para>
     177
     178      <orderedlist>
     179        <listitem>
     180          <para>Preserve configure Defaults set by a previously executed
     181          Portfile keyword or by MacPorts base</para>
     182
     183          <para>MacPorts base sets the gcc compiler flags CFLAGS and LDFLAGS
     184          for all ports using <literal>configure.cflags</literal> and
     185          <literal>configure.ldflags</literal>, therefore to keep from
     186          overwriting the default compiler flags use
     187          <literal>configure.cflags-append</literal> and
     188          <literal>configure.ldflags-append</literal>.</para>
     189
     190          <itemizedlist>
     191            <listitem>
     192              <para><code>configure.cflags-append</code></para>
     193            </listitem>
     194
     195            <listitem>
     196              <para><code>configure.ldflags-append</code></para>
     197            </listitem>
     198          </itemizedlist>
     199        </listitem>
     200
     201        <listitem>
     202          <para>Preserve PortGroup Dependencies</para>
     203
     204          <para>Ports in a PortGroup have default library dependencies set by
     205          MacPorts base. Therefore, never use <literal>depends_lib</literal>
     206          in ports belonging to a PortGroup or it will overwrite the default
     207          library dependencies. Instead, use
     208          <literal>depends_lib-append</literal>.</para>
     209        </listitem>
     210
     211        <listitem>
     212          <para>Add or Delete Items for Variants</para>
     213
     214          <para>When a variant requires more or fewer dependencies, distfiles,
     215          or patchfiles, when the variant is invoked you want to add or remove
     216          items to the appropriate keyword values list set in the global
     217          section of the Portfile. Use the appropriate keywords, for
     218          example:</para>
     219
     220          <itemizedlist>
     221            <listitem>
     222              <para><code>depends_lib-append</code> or
     223              <code>depends_lib-delete</code></para>
     224            </listitem>
     225
     226            <listitem>
     227              <para><code>distfiles-append</code> or
     228              <code>distfile-delete</code></para>
     229            </listitem>
     230
     231            <listitem>
     232              <para><code>patchfiles-append</code> or
     233              <code>patchfiles-delete</code></para>
     234            </listitem>
     235          </itemizedlist>
     236        </listitem>
     237      </orderedlist>
    241238    </section>
    242239
    243240    <section id="reference.phases.installation.argument-modifiers">
    244       <title>A Word about Keyword Argument Modifiers (.pre_args /
    245       .post_args)</title>
     241      <title>Keyword Argument Modifiers (.pre_args / .post_args)</title>
    246242
    247243      <para>Keywords that support pre_args and post_args are used to assemble
     
    253249      <literal>configure.pre_args-delete</literal>.</para>
    254250    </section>
    255 
    256251  </section>
    257252
     
    284279</programlisting>
    285280
    286               <para>You may also use mirror site lists predefined by
    287               MacPorts. Here the sourceforge and gnu mirrors are
    288               used.</para>
     281              <para>You may also use mirror site lists predefined by MacPorts.
     282              Here the sourceforge and gnu mirrors are used.</para>
    289283
    290284              <programlisting>master_sites        sourceforge gnu
     
    294288              <para>When using mirror master_sites, the subdirectory
    295289              <varname>${name}</varname> is checked on every mirror. If the
    296               mirror subdirectory does not match ${name}, then you may
    297               specify it using after the mirror separated by a colon.</para>
     290              mirror subdirectory does not match ${name}, then you may specify
     291              it using after the mirror separated by a colon.</para>
    298292
    299293              <programlisting>master_sites        sourceforge:widget \
     
    308302
    309303              <para>In the example below, file_one.tar.gz is fetched from
    310               sourceforge mirrors in subdirectory
    311               <varname>${name}</varname>; file tagtwo.tar.gz is fetched from
    312               the gnu mirrors in subdirectory sources.</para>
     304              sourceforge mirrors in subdirectory <varname>${name}</varname>;
     305              file tagtwo.tar.gz is fetched from the gnu mirrors in
     306              subdirectory sources.</para>
    313307
    314308              <programlisting>master_sites        sourceforge::tagone \
     
    414408
    415409        <listitem>
    416           <para>The full distribution filename, including the extract
    417           suffix. Used to specify non-default distribution filenames; this
    418           keyword must be specified (and tags used) when a port has multiple
    419           download files (see master_sites).</para>
     410          <para>The full distribution filename, including the extract suffix.
     411          Used to specify non-default distribution filenames; this keyword
     412          must be specified (and tags used) when a port has multiple download
     413          files (see master_sites).</para>
    420414
    421415          <itemizedlist>
     
    674668      <title>Fetch from CVS</title>
    675669
    676       <para><ulink url="http://www.nongnu.org/cvs/">CVS</ulink> may be used
    677       as an alternative method of fetching distribution files using the
    678       keywords in this section. However, fetching via CVS may cause
    679       non-reproducible builds, so it is strongly discouraged.</para>
     670      <para><ulink url="http://www.nongnu.org/cvs/">CVS</ulink> may be used as
     671      an alternative method of fetching distribution files using the keywords
     672      in this section. However, fetching via CVS may cause non-reproducible
     673      builds, so it is strongly discouraged.</para>
    680674
    681675      <variablelist>
     
    725719
    726720          <listitem>
    727             <para>A date that identifies the CVS code set to
    728             checkout.</para>
     721            <para>A date that identifies the CVS code set to checkout.</para>
    729722
    730723            <itemizedlist>
     
    767760      <title>Fetch from Subversion</title>
    768761
    769       <para><ulink url="http://subversion.tigris.org/">Subversion</ulink>
    770       may be used as an alternative method of fetching distribution files
    771       using the keywords in this section. However, fetching via Subversion
    772       may cause non-reproducible builds, so it is strongly
    773       discouraged.</para>
     762      <para><ulink url="http://subversion.tigris.org/">Subversion</ulink> may
     763      be used as an alternative method of fetching distribution files using
     764      the keywords in this section. However, fetching via Subversion may cause
     765      non-reproducible builds, so it is strongly discouraged.</para>
    774766
    775767      <variablelist>
     
    801793          <listitem>
    802794            <para>Optional tag for fetching with Subversion, this specifies
    803             the code revision to checkout; it corresponds to the -r option
    804             in the svn cli.</para>
     795            the code revision to checkout; it corresponds to the -r option in
     796            the svn cli.</para>
    805797
    806798            <itemizedlist>
     
    831823
    832824        <listitem>
    833           <para>Checksum(s) of the distribution files. For ports with
    834           multiple distribution files, filenames must be included to
    835           associate files with their checksums.</para>
     825          <para>Checksum(s) of the distribution files. For ports with multiple
     826          distribution files, filenames must be included to associate files
     827          with their checksums.</para>
     828
    836829          <para>All checksum types (md5, sha1 and rdm160) should be used to
    837830          ensure the integrity of the distfiles.</para>
     
    891884
    892885              <programlisting>extract.only        foo.tar.gz</programlisting>
     886
    893887              <programlisting>extract.only-append     bar.tar.gz
    894888extract.only-delete     foo.tar.gz</programlisting>
     
    10251019        <listitem>
    10261020          <para>Specify patch files to be applied for a port; list modifiers
    1027           specify patchfiles to be added or removed from a previous
    1028           patchfile declaration.</para>
     1021          specify patchfiles to be added or removed from a previous patchfile
     1022          declaration.</para>
    10291023
    10301024          <itemizedlist>
     
    10381032              <programlisting>patchfiles          patch-Makefile.in \
    10391033                    patch-source.c</programlisting>
     1034
    10401035              <programlisting>patchfiles-append   patch-configure
    10411036patchfiles-delete   patch-src-Makefile.in</programlisting>
     
    10531048
    10541049        <listitem>
    1055           <para>Main arguments to patch.cmd; optional argument modifiers
    1056           pass arguments before and after the main arguments.</para>
     1050          <para>Main arguments to patch.cmd; optional argument modifiers pass
     1051          arguments before and after the main arguments.</para>
    10571052
    10581053          <itemizedlist>
     
    11391134        <listitem>
    11401135          <para>Set environment variables for configure; list modifiers add
    1141           and delete items from a previous Portfile configure.env keyword,
    1142           or a default set by MacPorts base. If available, it is encouraged
    1143           to use the predefined options (like configure.cflags) instead of
     1136          and delete items from a previous Portfile configure.env keyword, or
     1137          a default set by MacPorts base. If available, it is encouraged to
     1138          use the predefined options (like configure.cflags) instead of
    11441139          modifying configure.env directly.</para>
    11451140
     
    11541149
    11551150              <programlisting>configure.env       QTDIR=${prefix}/lib/qt3</programlisting>
     1151
    11561152              <programlisting>configure.env-append    ABI=32
    11571153configure.env-delete    TCLROOT=${prefix}</programlisting>
     
    11691165
    11701166        <listitem>
    1171           <para>Set CFLAGS compiler flags; list modifiers add or delete
    1172           items from a previous Portfile configure.cflags keyword or the
    1173           default set by MacPorts base.</para>
     1167          <para>Set CFLAGS compiler flags; list modifiers add or delete items
     1168          from a previous Portfile configure.cflags keyword or the default set
     1169          by MacPorts base.</para>
    11741170
    11751171          <itemizedlist>
     
    11821178
    11831179              <programlisting>configure.cflags    -Os -flat_namespace</programlisting>
     1180
    11841181              <programlisting>configure.cflags-append     "-undefined suppress"
    11851182configure.cflags-delete     -O2</programlisting>
     
    11971194
    11981195        <listitem>
    1199           <para>Set LDFLAGS compiler flags; list modifiers add or delete
    1200           items from a previous Portfile configure.ldflags keyword or the
    1201           default set by MacPorts base.</para>
     1196          <para>Set LDFLAGS compiler flags; list modifiers add or delete items
     1197          from a previous Portfile configure.ldflags keyword or the default
     1198          set by MacPorts base.</para>
    12021199
    12031200          <itemizedlist>
     
    12101207
    12111208              <programlisting>configure.ldflags   "-L${worksrcpath}/zlib -lz"</programlisting>
     1209
    12121210              <programlisting>configure.ldflags-append    "-L/usr/X11R6/lib -L${worksrcpath}/lib"
    12131211configure.ldflags-delete    -L${prefix}/lib/db44</programlisting>
     
    12381236
    12391237              <programlisting>configure.cppflags  -I${worksrcpath}/include</programlisting>
     1238
    12401239              <programlisting>configure.cppflags-append   "-I/usr/X11R6/lib -I${worksrcpath}/lib -DHAVE_RRD_12X"
    12411240configure.cppflags-delete   -I${prefix}/lib/db44</programlisting>
     
    13551354          <para>Set FFLAGS to be passed to the Fortran compiler; list
    13561355          modifiers add or delete items from a previous Portfile
    1357           configure.fflags keyword or the default set by MacPorts
    1358           base.</para>
     1356          configure.fflags keyword or the default set by MacPorts base.</para>
    13591357
    13601358          <itemizedlist>
     
    14541452
    14551453        <listitem>
    1456           <para>Set CPP compiler flags for selecting a C
    1457           preprocessor.</para>
     1454          <para>Set CPP compiler flags for selecting a C preprocessor.</para>
    14581455
    14591456          <itemizedlist>
     
    15161513
    15171514        <listitem>
    1518           <para>Set FC compiler flags for selecting a Fortran
    1519           compiler.</para>
     1515          <para>Set FC compiler flags for selecting a Fortran compiler.</para>
    15201516
    15211517          <itemizedlist>
     
    15791575
    15801576        <listitem>
    1581           <para>Set JAVAC compiler flags for selecting a Java
    1582           compiler.</para>
     1577          <para>Set JAVAC compiler flags for selecting a Java compiler.</para>
    15831578
    15841579          <itemizedlist>
     
    16011596        <listitem>
    16021597          <para>Select a compiler suite to fill the compiler environment
    1603           variables. All variables/tools a compiler suite can provide are
    1604           set. Manually set variables are not overwritten. Dependencies are
    1605           not added for you, as they may be just build- or also
    1606           run-dependencies. Keep in mind that not all compiler suites might
    1607           be available on your platform: <literal>gcc-3.3</literal> is
    1608           available on Mac OS X 10.3 and 10.4 PowerPC,
    1609           <literal>gcc-4.0</literal> is available on 10.4 and 10.5,
    1610           <literal>gcc-4.2</literal> is available as preview for 10.5.
    1611           </para>
     1598          variables. All variables/tools a compiler suite can provide are set.
     1599          Manually set variables are not overwritten. Dependencies are not
     1600          added for you, as they may be just build- or also run-dependencies.
     1601          Keep in mind that not all compiler suites might be available on your
     1602          platform: <literal>gcc-3.3</literal> is available on Mac OS X 10.3
     1603          and 10.4 PowerPC, <literal>gcc-4.0</literal> is available on 10.4
     1604          and 10.5, <literal>gcc-4.2</literal> is available as preview for
     1605          10.5.</para>
    16121606
    16131607          <itemizedlist>
     
    16161610              10.3</para>
    16171611            </listitem>
     1612
    16181613            <listitem>
    16191614              <para>Default: <literal>gcc-4.0</literal> on Mac OS X 10.4 and
     
    18751870
    18761871      <note>
    1877         <para>There is a default universal variant made available to all
    1878         ports by MacPorts base, so redefining universal keywords should only
    1879         be done to make a given port compile if the default options fail to
    1880         do so.</para>
     1872        <para>There is a default universal variant made available to all ports
     1873        by MacPorts base, so redefining universal keywords should only be done
     1874        to make a given port compile if the default options fail to do
     1875        so.</para>
    18811876      </note>
    18821877
     
    19081903
    19091904          <listitem>
    1910             <para>Arguments appended to the configure script to build the
    1911             port universal.</para>
     1905            <para>Arguments appended to the configure script to build the port
     1906            universal.</para>
    19121907
    19131908            <itemizedlist>
     
    19311926
    19321927          <listitem>
    1933             <para>Additional flags to put in the CPPFLAGS environment
    1934             variable when invoking the configure script.</para>
     1928            <para>Additional flags to put in the CPPFLAGS environment variable
     1929            when invoking the configure script.</para>
    19351930
    19361931            <itemizedlist>
     
    19521947
    19531948          <listitem>
    1954             <para>Additional flags to put in the CXXFLAGS environment
    1955             variable when invoking the configure script.</para>
     1949            <para>Additional flags to put in the CXXFLAGS environment variable
     1950            when invoking the configure script.</para>
    19561951
    19571952            <itemizedlist>
     
    19751970
    19761971          <listitem>
    1977             <para>Additional flags to put in the LDFLAGS environment
    1978             variable when invoking the configure script.</para>
     1972            <para>Additional flags to put in the LDFLAGS environment variable
     1973            when invoking the configure script.</para>
    19791974
    19801975            <itemizedlist>
     
    22922287
    22932288              <programlisting>build.target        all-src</programlisting>
     2289
    22942290              <programlisting>build.target-append     doc extra
    22952291build.target-delete     compat</programlisting>
     
    23032299
    23042300        <listitem>
    2305           <para>This keyword is for specifying whether or not it is safe for
    2306           a port to use multiple cpus or multiple cores in parallel during
    2307           its build phase. If a port is declared to be builadble this way,
    2308           the option <option>-j N</option> may be passed to the
     2301          <para>This keyword is for specifying whether or not it is safe for a
     2302          port to use multiple cpus or multiple cores in parallel during its
     2303          build phase. If a port is declared to be builadble this way, the
     2304          option <option>-j N</option> may be passed to the
    23092305          <command>make</command> command if parallel builds are enabled
    2310           system-wide.  This can be obtained by setting
     2306          system-wide. This can be obtained by setting
    23112307          <varname>buildmakejobs</varname> in
    23122308          <filename>macports.conf</filename>. The integer <option>N</option>
     
    24562452
    24572453              <programlisting>destroot.target     install install-config install-commandmode</programlisting>
     2454
    24582455              <programlisting>destroot.target-append  install-plugins
    24592456destroot.target-delete  install-commandmode</programlisting>
     
    24842481          <note>
    24852482            <para>If an application's Makefile properly supports the DESTDIR
    2486             variable, MacPorts will automatically destroot the port
    2487             properly. A port must destroot properly or the port will not
    2488             install correctly, upgrade, or uninstall. If not, you may need
    2489             to set this variable, or even patch the application's
    2490             Makefile.</para>
     2483            variable, MacPorts will automatically destroot the port properly.
     2484            A port must destroot properly or the port will not install
     2485            correctly, upgrade, or uninstall. If not, you may need to set this
     2486            variable, or even patch the application's Makefile.</para>
    24912487          </note>
    24922488        </listitem>
     
    25172513
    25182514        <listitem>
    2519           <para>A list of directories that should not be removed if empty
    2520           upon destroot completion.</para>
     2515          <para>A list of directories that should not be removed if empty upon
     2516          destroot completion.</para>
    25212517
    25222518          <itemizedlist>
     
    25632559    </variablelist>
    25642560  </section>
    2565 
    25662561</section>
Note: See TracChangeset for help on using the changeset viewer.