[32051] trunk/doc-new/guide/xml

simon at macports.org simon at macports.org
Fri Dec 14 08:05:21 PST 2007


Revision: 32051
          http://trac.macosforge.org/projects/macports/changeset/32051
Author:   simon at macports.org
Date:     2007-12-14 08:05:19 -0800 (Fri, 14 Dec 2007)

Log Message:
-----------
doc-new: Minor typo fix, added more links and fixed some tags.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-keywords.xml
    trunk/doc-new/guide/xml/portfile-variants.xml
    trunk/doc-new/guide/xml/portfiledev.xml

Modified: trunk/doc-new/guide/xml/portfile-keywords.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-keywords.xml	2007-12-14 15:34:19 UTC (rev 32050)
+++ trunk/doc-new/guide/xml/portfile-keywords.xml	2007-12-14 16:05:19 UTC (rev 32051)
@@ -94,7 +94,7 @@
         example, if an application version 1.5 is superseded by a snapshot
         release 20081022, the new release could be given version number
         1.5.20081022, rather than 20081022, so the newer release will have a
-        numericaly greater value.</para>
+        numerically greater value.</para>
       </listitem>
     </varlistentry>
 
@@ -111,7 +111,7 @@
       </listitem>
     </varlistentry>
 
-    <varlistentry>
+    <varlistentry id="reference.keywords.maintainers">
       <term>maintainers</term>
 
       <listitem>
@@ -183,6 +183,8 @@
       <listitem>
         <para>The platforms on which the port has been tested.</para>
 
+        <!-- TODO: add possible values -->
+
         <programlisting>platforms           darwin freebsd</programlisting>
       </listitem>
     </varlistentry>

Modified: trunk/doc-new/guide/xml/portfile-variants.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-variants.xml	2007-12-14 15:34:19 UTC (rev 32050)
+++ trunk/doc-new/guide/xml/portfile-variants.xml	2007-12-14 16:05:19 UTC (rev 32051)
@@ -10,8 +10,9 @@
 
   <variablelist>
     <varlistentry>
-      <term>variant [requires variant] [conflicts variant] [description
-      description]</term>
+      <term>variant [requires <replaceable>variant</replaceable>] [conflicts
+      <replaceable>variant</replaceable>] [description
+      <replaceable>description</replaceable>]</term>
 
       <listitem>
         <para>The variant declaration may contain any keywords that can be
@@ -26,6 +27,7 @@
 
         <itemizedlist>
           <listitem>
+            <!-- TODO: should this really be no, not none? -->
             <para>Default: no</para>
           </listitem>
 
@@ -50,9 +52,11 @@
         modularity and also allows users to suppress default variants if
         they wish.</para>
 
-        <para>Due to a bug in the current Macports base default_variants
-        shouldn't be used at the moment as they cause problems while
-        upgrading ports.</para>
+        <note>
+          <para>Due to a bug in the current Macports base default_variants
+          shouldn't be used at the moment as they cause problems while
+          upgrading ports.</para>
+        </note>
 
         <itemizedlist>
           <listitem>
@@ -81,15 +85,16 @@
       <term>universal_variant</term>
 
       <listitem>
-        <para>When using MacPorts on Mac OS X, a universal variant is
-        defined by default to configure ports with universal flags. The
-        variant can be overridden if the default code does not work (see the
-        Configure Universal section below), or suppressed if a universal
-        variant is not possible for the port with this keyword.</para>
+        <para>When using MacPorts on Mac OS X, a universal variant is defined
+        by default to configure ports with universal flags. The variant can be
+        overridden if the default code does not work (see the <link
+        linkend="reference.phases.configure.universal">Configure
+        Universal</link> section above), or suppressed if a universal variant
+        is not possible for the port with this keyword.</para>
 
         <itemizedlist>
           <listitem>
-            <para>Default: yes</para>
+            <para>Default: <option>yes</option></para>
           </listitem>
 
           <listitem>

Modified: trunk/doc-new/guide/xml/portfiledev.xml
===================================================================
--- trunk/doc-new/guide/xml/portfiledev.xml	2007-12-14 15:34:19 UTC (rev 32050)
+++ trunk/doc-new/guide/xml/portfiledev.xml	2007-12-14 16:05:19 UTC (rev 32051)
@@ -133,9 +133,10 @@
         <para>A port's maintainer is a person or persons who take
         responsibility for keeping the port up-to-date, and the maintainer
         keyword lists maintainer email addresses(s). To hide these addresses
-        from spambots, see the more full explanation of the maintainer keyword
-        in the <link linkend="reference.keywords">Global Keywords</link>
-        section of the <link linkend="reference">Portfile Reference</link>
+        from spambots, see the more full explanation of the <link
+        linkend="reference.keywords.maintainers">maintainer keyword</link> in
+        the <link linkend="reference.keywords">Global Keywords</link> section
+        of the <link linkend="reference">Portfile Reference</link>
         chapter.</para>
 
         <programlisting>maintainers         julesverne at example.org</programlisting>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20071214/0465daa5/attachment.html


More information about the macports-changes mailing list