Changeset 59384


Ignore:
Timestamp:
Oct 14, 2009, 12:56:18 PM (11 years ago)
Author:
jmr@…
Message:

guide: update regarding universal options, parallel build, build_arch, developer_dir

Location:
trunk/doc-new/guide/xml
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/macports.conf.xml

    r57840 r59384  
    106106        </listitem>
    107107      </varlistentry>
     108     
     109      <varlistentry>
     110        <term>build_arch</term>
     111
     112        <listitem>
     113          <para>The machine architecture to build for in normal use.
     114          Options include: ppc, i386, ppc64, x86_64</para>
     115
     116          <para>Default:
     117          <para>(Snow Leopard) <option>x86_64</option> or <option>i386</option> depending on hardware</para>
     118          <para>(Leopard/Tiger) <option>i386</option> or <option>ppc</option> depending on hardware</para>
     119        </listitem>
     120      </varlistentry>
    108121
    109122      <varlistentry>
     
    126139          <para>Default:
    127140          <filename>${prefix}/Library/Frameworks</filename></para>
     141        </listitem>
     142      </varlistentry>
     143     
     144      <varlistentry>
     145        <term>developer_dir</term>
     146
     147        <listitem>
     148          <para>Directory where Xcode Tools is installed.</para>
     149
     150          <para>Default:
     151          <filename>/Developer</filename></para>
    128152        </listitem>
    129153      </varlistentry>
     
    221245          all available processer cores.</para>
    222246
    223           <para>Default: 1</para>
     247          <para>Default: 0</para>
    224248        </listitem>
    225249      </varlistentry>
     
    304328    <variablelist>
    305329      <varlistentry>
    306         <term>universal_target</term>
    307 
    308         <listitem>
    309           <para>Sets MACOSX_DEPLOYMENT_TARGET</para>
    310 
    311           <para>Example: 10.5</para>
    312         </listitem>
    313       </varlistentry>
    314 
    315       <varlistentry>
    316         <term>universal_sysroot</term>
    317 
    318         <listitem>
    319           <para>The SDK "sysroot" full path to use for +universal
    320           variant.</para>
    321 
    322           <para>Example:
    323           <filename>/Developer/SDKs/MacOSX10.5.sdk</filename></para>
    324         </listitem>
    325       </varlistentry>
    326 
    327       <varlistentry>
    328330        <term>universal_archs</term>
    329331
  • trunk/doc-new/guide/xml/portfile-phase.xml

    r57844 r59384  
    22112211
    22122212          <listitem>
    2213             <para>Arguments appended to the configure script to build the port
    2214             universal.</para>
     2213            <para>Additional flags to put in the CFLAGS environment variable
     2214            when invoking the configure script. Default value is based on
     2215            <literal>${configure.universal_archs}</literal>.</para>
    22152216
    22162217            <itemizedlist>
    22172218              <listitem>
    2218                 <para>Default: <literal>-sysroot
    2219                 /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
    2220                 ppc</literal></para>
     2219                <para>Default: </para>
     2220                <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
     2221                <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
     2222                <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
    22212223              </listitem>
    22222224
     
    22392241            <itemizedlist>
    22402242              <listitem>
    2241                 <para>Default: <literal>???</literal></para>
     2243                <para>Default: </para>
     2244                <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk</literal></para>
     2245                <para>(Others) none</para>
    22422246              </listitem>
    22432247
     
    22562260          <listitem>
    22572261            <para>Additional flags to put in the CXXFLAGS environment variable
    2258             when invoking the configure script.</para>
     2262            when invoking the configure script. Default value is based on
     2263            <literal>${configure.universal_archs}</literal>.</para>
    22592264
    22602265            <itemizedlist>
    22612266              <listitem>
    2262                 <para>Default: <literal>-isysroot
    2263                 /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
    2264                 ppc</literal></para>
     2267                <para>Default: </para>
     2268                <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
     2269                <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
     2270                <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
    22652271              </listitem>
    22662272
     
    22832289            <itemizedlist>
    22842290              <listitem>
    2285                 <para>Default: <literal>-arch i386 -arch ppc</literal></para>
     2291                <para>Default: </para>
     2292                <para>(PowerPC Tiger) <literal>-Wl,-syslibroot,${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
     2293                <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
     2294                <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
    22862295              </listitem>
    22872296
     
    26262635          <para>This keyword is for specifying whether or not it is safe for a
    26272636          port to use multiple CPUs or multiple cores in parallel during its
    2628           build phase. If <code>use_parallel_build</code> is set to
    2629           <quote>yes</quote> in a given port, the option <option>-jN</option>
     2637          build phase. If <code>use_parallel_build</code> is not set to
     2638          <quote>no</quote> in a given port, the option <option>-j${build.jobs}</option>
    26302639          is passed to <varname>${build.cmd}</varname> (if
    26312640          <varname>${build.cmd}</varname> is <command>make</command> or
    2632           <command>scons</command>) where <option>N</option> represents the
    2633           number of parallel build threads defined by the variable
     2641          <command>scons</command>).</para>
     2642
     2643          <itemizedlist>
     2644            <listitem>
     2645              <para>Default: <option>yes</option></para>
     2646            </listitem>
     2647
     2648            <listitem>
     2649              <para>Example:</para>
     2650
     2651              <programlisting>use_parallel_build  no</programlisting>
     2652            </listitem>
     2653          </itemizedlist>
     2654        </listitem>
     2655      </varlistentry>
     2656     
     2657      <varlistentry>
     2658        <term>build.jobs</term>
     2659
     2660        <listitem>
     2661          <para>The number of simultaneous jobs to run when parallel build is
     2662          enabled. The default value is based on the variable
    26342663          <varname>buildmakejobs</varname> in
    2635           <filename>macports.conf</filename>. The default value of
    2636           <varname>buildmakejobs</varname> is set to 1, therefore unless this
    2637           variable is increased for a given MacPorts installation, parallel
    2638           builds will not occur in any case.</para>
    2639 
    2640           <itemizedlist>
    2641             <listitem>
    2642               <para>Default: <option>no</option></para>
    2643             </listitem>
    2644 
    2645             <listitem>
    2646               <para>Example:</para>
    2647 
    2648               <programlisting>use_parallel_build  yes</programlisting>
    2649             </listitem>
    2650           </itemizedlist>
    2651         </listitem>
    2652       </varlistentry>
     2664          <filename>macports.conf</filename>.</para>
     2665
     2666          <itemizedlist>
     2667            <listitem>
     2668              <para>Default: If <varname>buildmakejobs</varname> is 0, the
     2669              number of CPU cores in the machine, or the number of GB of
     2670              physical memory plus one, whichever is less. Otherwise,
     2671              the actual value of <literal>${buildmakejobs}</literal>.</para>
     2672            </listitem>
     2673          </itemizedlist>
     2674        </listitem>
     2675      </varlistentry>
     2676     
    26532677    </variablelist>
    26542678  </section>
Note: See TracChangeset for help on using the changeset viewer.