Revision
87570
Author
cal@macports.org
Date
2011-11-25 18:14:33 -0800 (Fri, 25 Nov 2011)

Log Message

base: Document supported_archs in man 7 portfile (closes #25189)

Modified Paths

Diff

Modified: trunk/base/doc/portfile.7 (87569 => 87570)


--- trunk/base/doc/portfile.7	2011-11-26 02:11:29 UTC (rev 87569)
+++ trunk/base/doc/portfile.7	2011-11-26 02:14:33 UTC (rev 87570)
@@ -206,6 +206,28 @@
 .br
 .Sy Example:
 .Dl platforms darwin
+.It Ic supported_archs
+The CPU architectures for which this port can be built. Archs currently
+supported by Mac OS X are: i386, ppc, ppc64, x86_64. If this option is not set,
+it is assumed that the port can build for all archs. If a port does not install
+any architecture-specific files, use the special value noarch.
+.br
+If the building architecture isn't among supported_archs, port fails with an
+error message except when building on x86_64 (resp. ppc64) and supported_archs
+contains i386 (resp. ppc). In this case, the port will be built in 32 bit mode.
+.br
+.Sy Type:
+.Em optional
+.br
+.Sy Values:
+.Em i386 x86_64 ppc ppc64 noarch
+.br
+.Sy Default:
+.Em i386 x86_64 ppc ppc64
+.br
+.Sy Examples:
+.Dl supported_archs i386 x86_64
+.Dl supported_archs noarch
 .It Ic homepage
 Project homepage for the port.
 .br

Modified: trunk/doc-new/guide/xml/portfile-keywords.xml (87569 => 87570)


--- trunk/doc-new/guide/xml/portfile-keywords.xml	2011-11-26 02:11:29 UTC (rev 87569)
+++ trunk/doc-new/guide/xml/portfile-keywords.xml	2011-11-26 02:14:33 UTC (rev 87570)
@@ -199,6 +199,11 @@
         install any architecture-specific files, use the special value
         <option>noarch</option>.</para>
 
+        <para>If the building architecture isn't among supported_archs, port
+        fails with an error message except when building on x86_64 (resp.
+        ppc64) and supported_archs contains i386 (resp. ppc). In this case, the
+        port will be built in 32 bit mode.</para>
+
         <programlisting>supported_archs           i386 ppc</programlisting>
         <programlisting>supported_archs           noarch</programlisting>
       </listitem>