Changeset 41267 for trunk/doc-new


Ignore:
Timestamp:
Oct 29, 2008, 4:45:06 PM (11 years ago)
Author:
markd@…
Message:

Add definitions for xcode.universal.settings and xcode.universal.sdk.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portgroup-xcode.xml

    r34791 r41267  
    33"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
    44<section id="reference.portgroup.xcode">
    5 
    65  <title>PortGroup xcode</title>
    76
    8   <para>PortGroup xcode allows for efficient porting of Xcode-based
    9   opensource software. It handles configuration, build, and destroot phases.
    10   It also defines some values for Xcode-based software. A minimum Portfile
    11   using the xcode PortGroup class only defines the fetch and the checksum
    12   phases.</para>
    13 
    14   <para>Using PortGroup xcode is a way to make your port able to tolerate
    15   Xcode version updates because the PortGroup is tested against all
     7  <para><code>PortGroup xcode</code> allows for efficient porting of
     8  Xcode-based opensource software. A minimum Portfile for <code>PortGroup
     9  xcode</code> uses defaults for the configuration, build, and destroot
     10  phases. It also defines some values for Xcode-based software. </para>
     11
     12  <para>Using <code>PortGroup xcode</code> is a way to make your port able to
     13  tolerate Xcode version updates because the PortGroup is tested against all
    1614  supported Mac OS X and Xcode versions.</para>
    1715
     
    1917    <title>xcode PortGroup Specific Keywords</title>
    2018
    21     <para>Portfiles using the xcode PortGroup allow for port authors to set
    22     the following keywords in addition to the general Portfile
     19    <para>Portfiles using <code>PortGroup xcode</code> allow for port authors
     20    to set the following keywords in addition to the general Portfile
    2321    keywords.</para>
    2422
     
    2826
    2927        <listitem>
    30           <para>The path relative to ${build.dir} and ${destroot.dir} of the
    31           Xcode project. If unset, let xcode tool figure it out. It usually
     28          <para>The path relative to <varname>${build.dir}</varname> and
     29          <varname>${destroot.dir}</varname> of the Xcode project. If unset,
     30          let Xcode Tools should determine it automatically. It usually
    3231          succeeds if there is a single project in the directory.</para>
    3332
     
    3837
    3938            <listitem>
     39              <para>Default: none</para>
     40            </listitem>
     41
     42            <listitem>
    4043              <para>Example:</para>
    4144
     
    5861
    5962            <listitem>
    60               <para>Default: Deployment</para>
     63              <para>Default: <option>Deployment</option></para>
    6164            </listitem>
    6265
     
    7477
    7578        <listitem>
    76           <para>If present, it overrides build.target and
    77           destroot.target.</para>
    78 
    79           <itemizedlist>
    80             <listitem>
    81               <para>Type: optional</para>
     79          <para>If present, it overrides <varname>build.target</varname> and
     80          <varname>destroot.target</varname>.</para>
     81
     82          <itemizedlist>
     83            <listitem>
     84              <para>Type: optional</para>
     85            </listitem>
     86
     87            <listitem>
     88              <para>Default: none</para>
    8289            </listitem>
    8390
     
    95102
    96103        <listitem>
    97           <para>Additional settings passed to the xcode build tool during
    98           the build phase. These settings should be in the X=Y form.</para>
    99 
    100           <itemizedlist>
    101             <listitem>
    102               <para>Type: optional</para>
     104          <para>Additional settings passed to the xcode build tool during the
     105          build phase. These settings should be in the X=Y form.</para>
     106
     107          <itemizedlist>
     108            <listitem>
     109              <para>Type: optional</para>
     110            </listitem>
     111
     112            <listitem>
     113              <para>Default: none</para>
    103114            </listitem>
    104115
     
    118129          <para>Type of project that will be installed. This tells the xcode
    119130          PortGroup how to destroot the project. Correct values are
    120           application and framework.</para>
    121 
    122           <itemizedlist>
    123             <listitem>
    124               <para>Type: optional</para>
    125             </listitem>
    126 
    127             <listitem>
    128               <para>Default: application</para>
     131          <option>application</option> and <option>framework</option>.</para>
     132
     133          <itemizedlist>
     134            <listitem>
     135              <para>Type: optional</para>
     136            </listitem>
     137
     138            <listitem>
     139              <para>Default: <option>application</option></para>
    129140            </listitem>
    130141
     
    152163              <para>Default: <filename>/Library/Frameworks</filename> or
    153164              <filename>/Applications/MacPorts</filename> depending on
    154               xcode.destroot.type.</para>
     165              <code>xcode.destroot.type</code>.</para>
    155166            </listitem>
    156167          </itemizedlist>
     
    162173
    163174        <listitem>
    164           <para>Additional settings passed to the xcode build tool during
    165           the destroot phase. These settings should be in the X=Y
     175          <para>Additional settings passed to the xcode build tool during the
     176          destroot phase. These settings should be in the X=Y form.</para>
     177
     178          <itemizedlist>
     179            <listitem>
     180              <para>Type: optional</para>
     181            </listitem>
     182
     183            <listitem>
     184              <para>Default: none</para>
     185            </listitem>
     186
     187            <listitem>
     188              <para>Example:</para>
     189
     190              <programlisting>xcode.destroot.settings SKIP_INSTALL=NO</programlisting>
     191            </listitem>
     192          </itemizedlist>
     193        </listitem>
     194      </varlistentry>
     195
     196      <varlistentry>
     197        <term>xcode.universal.settings</term>
     198
     199        <listitem>
     200          <para>Settings passed to the xcode build tool when the +universal
     201          variant is selected. These settings should be in the X=Y
    166202          form.</para>
    167203
     
    172208
    173209            <listitem>
    174               <para>Example:</para>
    175 
    176               <programlisting>xcode.destroot.settings SKIP_INSTALL=NO</programlisting>
     210              <para>Default: <code>ARCHS="${universal_archs}"
     211              MACOSX_DEPLOYMENT_TARGET=${universal_target}</code></para>
     212            </listitem>
     213          </itemizedlist>
     214        </listitem>
     215      </varlistentry>
     216
     217      <varlistentry>
     218        <term>xcode.universal.sdk</term>
     219
     220        <listitem>
     221          <para>SDK to use when the +universal variant is selected. The
     222          argument may be an absolute path to an SDK, or the canonical name of
     223          an SDK.</para>
     224
     225          <itemizedlist>
     226            <listitem>
     227              <para>Type: optional</para>
     228            </listitem>
     229
     230            <listitem>
     231              <para>Default: <code>${universal_sysroot}</code></para>
    177232            </listitem>
    178233          </itemizedlist>
     
    218273    <title>Portfile-Phase Keywords Affecting the xcode PortGroup</title>
    219274
    220     <para>The following Portfile phase keywords affect the xcode PortGroup
    221     in a unique way. In most cases, you will not need to set any of these
     275    <para>The following Portfile phase keywords affect the xcode PortGroup in
     276    a unique way. In most cases, you will not need to set any of these
    222277    keywords in the Portfile. See <citerefentry>
    223278        <refentrytitle>portfile-phase</refentrytitle>
     
    241296          <para>Default: ""</para>
    242297
    243           <para>This variable will be ignored if xcode.target is set.</para>
     298          <para>This variable will be ignored if
     299          <varname>xcode.target</varname> is set.</para>
    244300        </listitem>
    245301      </varlistentry>
     
    267323          <para>Default: ""</para>
    268324
    269           <para>This variable will be ignored if xcode.target is set.</para>
     325          <para>This variable will be ignored if
     326          <varname>xcode.target</varname> is set.</para>
    270327        </listitem>
    271328      </varlistentry>
    272329    </variablelist>
    273330  </section>
    274 
    275331</section>
Note: See TracChangeset for help on using the changeset viewer.