[59384] trunk/doc-new/guide/xml
jmr at macports.org
jmr at macports.org
Wed Oct 14 05:56:21 PDT 2009
Revision: 59384
http://trac.macports.org/changeset/59384
Author: jmr at macports.org
Date: 2009-10-14 05:56:18 -0700 (Wed, 14 Oct 2009)
Log Message:
-----------
guide: update regarding universal options, parallel build, build_arch, developer_dir
Modified Paths:
--------------
trunk/doc-new/guide/xml/macports.conf.xml
trunk/doc-new/guide/xml/portfile-phase.xml
Modified: trunk/doc-new/guide/xml/macports.conf.xml
===================================================================
--- trunk/doc-new/guide/xml/macports.conf.xml 2009-10-14 09:59:28 UTC (rev 59383)
+++ trunk/doc-new/guide/xml/macports.conf.xml 2009-10-14 12:56:18 UTC (rev 59384)
@@ -105,7 +105,20 @@
<para>Default: <option>image</option></para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>build_arch</term>
+ <listitem>
+ <para>The machine architecture to build for in normal use.
+ Options include: ppc, i386, ppc64, x86_64</para>
+
+ <para>Default:
+ <para>(Snow Leopard) <option>x86_64</option> or <option>i386</option> depending on hardware</para>
+ <para>(Leopard/Tiger) <option>i386</option> or <option>ppc</option> depending on hardware</para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>applications_dir</term>
@@ -127,7 +140,18 @@
<filename>${prefix}/Library/Frameworks</filename></para>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>developer_dir</term>
+ <listitem>
+ <para>Directory where Xcode Tools is installed.</para>
+
+ <para>Default:
+ <filename>/Developer</filename></para>
+ </listitem>
+ </varlistentry>
+
<varlistentry>
<term>portarchivemode</term>
@@ -220,7 +244,7 @@
building ports. Using "0" will cause a runtime autodetection to use
all available processer cores.</para>
- <para>Default: 1</para>
+ <para>Default: 0</para>
</listitem>
</varlistentry>
@@ -303,28 +327,6 @@
<variablelist>
<varlistentry>
- <term>universal_target</term>
-
- <listitem>
- <para>Sets MACOSX_DEPLOYMENT_TARGET</para>
-
- <para>Example: 10.5</para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
- <term>universal_sysroot</term>
-
- <listitem>
- <para>The SDK "sysroot" full path to use for +universal
- variant.</para>
-
- <para>Example:
- <filename>/Developer/SDKs/MacOSX10.5.sdk</filename></para>
- </listitem>
- </varlistentry>
-
- <varlistentry>
<term>universal_archs</term>
<listitem>
Modified: trunk/doc-new/guide/xml/portfile-phase.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-phase.xml 2009-10-14 09:59:28 UTC (rev 59383)
+++ trunk/doc-new/guide/xml/portfile-phase.xml 2009-10-14 12:56:18 UTC (rev 59384)
@@ -2210,14 +2210,16 @@
<term>configure.universal_cflags</term>
<listitem>
- <para>Arguments appended to the configure script to build the port
- universal.</para>
+ <para>Additional flags to put in the CFLAGS environment variable
+ when invoking the configure script. Default value is based on
+ <literal>${configure.universal_archs}</literal>.</para>
<itemizedlist>
<listitem>
- <para>Default: <literal>-sysroot
- /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
- ppc</literal></para>
+ <para>Default: </para>
+ <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
+ <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
+ <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
</listitem>
<listitem>
@@ -2238,7 +2240,9 @@
<itemizedlist>
<listitem>
- <para>Default: <literal>???</literal></para>
+ <para>Default: </para>
+ <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk</literal></para>
+ <para>(Others) none</para>
</listitem>
<listitem>
@@ -2255,13 +2259,15 @@
<listitem>
<para>Additional flags to put in the CXXFLAGS environment variable
- when invoking the configure script.</para>
+ when invoking the configure script. Default value is based on
+ <literal>${configure.universal_archs}</literal>.</para>
<itemizedlist>
<listitem>
- <para>Default: <literal>-isysroot
- /Developer/SDKs/MacOSX10.4u.sdk -arch i386 -arch
- ppc</literal></para>
+ <para>Default: </para>
+ <para>(PowerPC Tiger) <literal>-isysroot ${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
+ <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
+ <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
</listitem>
<listitem>
@@ -2282,7 +2288,10 @@
<itemizedlist>
<listitem>
- <para>Default: <literal>-arch i386 -arch ppc</literal></para>
+ <para>Default: </para>
+ <para>(PowerPC Tiger) <literal>-Wl,-syslibroot,${developer_dir}/SDKs/MacOSX10.4u.sdk -arch i386 -arch ppc</literal></para>
+ <para>(Leopard / Intel Tiger) <literal>-arch i386 -arch ppc</literal></para>
+ <para>(Snow Leopard) <literal>-arch x86_64 -arch i386</literal></para>
</listitem>
<listitem>
@@ -2625,31 +2634,46 @@
<listitem>
<para>This keyword is for specifying whether or not it is safe for a
port to use multiple CPUs or multiple cores in parallel during its
- build phase. If <code>use_parallel_build</code> is set to
- <quote>yes</quote> in a given port, the option <option>-jN</option>
+ build phase. If <code>use_parallel_build</code> is not set to
+ <quote>no</quote> in a given port, the option <option>-j${build.jobs}</option>
is passed to <varname>${build.cmd}</varname> (if
<varname>${build.cmd}</varname> is <command>make</command> or
- <command>scons</command>) where <option>N</option> represents the
- number of parallel build threads defined by the variable
- <varname>buildmakejobs</varname> in
- <filename>macports.conf</filename>. The default value of
- <varname>buildmakejobs</varname> is set to 1, therefore unless this
- variable is increased for a given MacPorts installation, parallel
- builds will not occur in any case.</para>
+ <command>scons</command>).</para>
<itemizedlist>
<listitem>
- <para>Default: <option>no</option></para>
+ <para>Default: <option>yes</option></para>
</listitem>
<listitem>
<para>Example:</para>
- <programlisting>use_parallel_build yes</programlisting>
+ <programlisting>use_parallel_build no</programlisting>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>build.jobs</term>
+
+ <listitem>
+ <para>The number of simultaneous jobs to run when parallel build is
+ enabled. The default value is based on the variable
+ <varname>buildmakejobs</varname> in
+ <filename>macports.conf</filename>.</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>Default: If <varname>buildmakejobs</varname> is 0, the
+ number of CPU cores in the machine, or the number of GB of
+ physical memory plus one, whichever is less. Otherwise,
+ the actual value of <literal>${buildmakejobs}</literal>.</para>
+ </listitem>
+ </itemizedlist>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</section>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20091014/b183ac1b/attachment.html>
More information about the macports-changes
mailing list