[31878] trunk/doc-new/guide/xml/portfile-phase.7.xml

[simon at macports.org]

Revision: 31878
          http://trac.macosforge.org/projects/macports/changeset/31878
Author:   simon at macports.org
Date:     2007-12-10 13:16:50 -0800 (Mon, 10 Dec 2007)

Log Message:
-----------
doc-new: Fixed an overlong line and some minor TODO items: use "Values:" to display possible values for a keyword/command.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-phase.7.xml

Modified: trunk/doc-new/guide/xml/portfile-phase.7.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-phase.7.xml	2007-12-10 20:42:53 UTC (rev 31877)
+++ trunk/doc-new/guide/xml/portfile-phase.7.xml	2007-12-10 21:16:50 UTC (rev 31878)
@@ -1484,10 +1484,15 @@
             </listitem>
 
             <listitem>
-              <!-- TODO: should this be Options or renamed? -->
-              <para>Options:</para>
-
-              <programlisting>gcc-3.3 gcc-4.0 apple-gcc-3.3 apple-gcc-4.0 macports-gcc-3.3 macports-gcc-3.4 macports-gcc-4.0 macports-gcc-4.1 macports-gcc-4.2 macports-gcc-4.3</programlisting>
+              <para>Values: <literal>gcc-3.3</literal>
+              <literal>gcc-4.0</literal> <literal>apple-gcc-3.3</literal>
+              <literal>apple-gcc-4.0</literal>
+              <literal>macports-gcc-3.3</literal>
+              <literal>macports-gcc-3.4</literal>
+              <literal>macports-gcc-4.0</literal>
+              <literal>macports-gcc-4.1</literal>
+              <literal>macports-gcc-4.2</literal>
+              <literal>macports-gcc-4.3</literal></para>
             </listitem>
 
             <listitem>
@@ -2032,8 +2037,8 @@
         <term>build.cmd</term>
 
         <listitem>
-          <para>Make command to run in <varname>${worksrcdir}</varname>; the
-          default is "make".</para>
+          <para>Make command to run in <varname>${worksrcdir}</varname>. Only
+          use it if you can't use <literal>build.type</literal>.</para>
 
           <itemizedlist>
             <listitem>
@@ -2053,17 +2058,21 @@
         <term>build.type</term>
 
         <listitem>
-          <para>Defines which "make" is required: "gnu" or "bsd". Sets
-          build.cmd to either "gnumake" or "bsdmake" accordingly.</para>
+          <para>Defines which "make" is required. Sets
+          <varname>${build.cmd}</varname> to either "gnumake" or "bsdmake"
+          accordingly.</para>
 
-          <!-- TODO: how to display "gnu" or "bsd". -->
-
           <itemizedlist>
             <listitem>
               <para>Default: <literal>gnu</literal></para>
             </listitem>
 
             <listitem>
+              <para>Values: <literal>gnu</literal>
+              <literal>bsd</literal></para>
+            </listitem>
+
+            <listitem>
               <para>Example:</para>
 
               <programlisting>build.type          bsd</programlisting>
@@ -2192,7 +2201,8 @@
 
         <listitem>
           <para>Install command to run relative to
-          <varname>${worksrcdir}</varname>.</para>
+          <varname>${worksrcdir}</varname>. Only use it if you can't use
+          <literal>destroot.type</literal>.</para>
 
           <itemizedlist>
             <listitem>
@@ -2212,18 +2222,21 @@
         <term>destroot.type</term>
 
         <listitem>
-          <para>Defines which "make" is required: either "gnu" or "bsd". Sets
+          <para>Defines which "make" is required. Sets
           <varname>${destroot.cmd}</varname> to either "gnumake" or "bsdmake"
           accordingly.</para>
 
-          <!-- TODO: Options? -->
-
           <itemizedlist>
             <listitem>
               <para>Default: <varname>${build.type}</varname></para>
             </listitem>
 
             <listitem>
+              <para>Values: <literal>gnu</literal>
+              <literal>bsd</literal></para>
+            </listitem>
+
+            <listitem>
               <para>Example:</para>
 
               <programlisting>destroot.type       bsd</programlisting>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071210/3cc77458/attachment.html