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

[simon at macports.org]

Revision: 33461
          http://trac.macosforge.org/projects/macports/changeset/33461
Author:   simon at macports.org
Date:     2008-01-27 06:31:32 -0800 (Sun, 27 Jan 2008)

Log Message:
-----------
doc-new: Added missing options fetch.type and cvs.password and add missing default values.

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

Modified: trunk/doc-new/guide/xml/portfile-phase.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-phase.xml	2008-01-27 14:25:32 UTC (rev 33460)
+++ trunk/doc-new/guide/xml/portfile-phase.xml	2008-01-27 14:31:32 UTC (rev 33461)
@@ -491,6 +491,38 @@
       fetched.</para>
 
       <variablelist>
+        <varlistentry id="reference.phases.fetch.advanced.fetch-type">
+          <term>fetch.type</term>
+
+          <listitem>
+            <para>Change the fetch type. This is only necessary if a <link
+            linkend="reference.phases.fetch.cvs">CVS</link> or <link
+            linkend="reference.phases.fetch.svn">SVN</link> checkout is be
+            used. <option>standard</option> is used for a normal http or ftp
+            fetch using <varname>${distfiles}</varname> and is used as
+            default.</para>
+
+            <itemizedlist>
+              <listitem>
+                <para>Default: <option>standard</option></para>
+              </listitem>
+
+              <listitem>
+                <para>Values: <option>standard</option> <option>cvs</option>
+                <option>svn</option></para>
+              </listitem>
+
+              <listitem>
+                <para>Example:</para>
+
+                <programlisting>fetch.type          svn
+svn.url             svn://example.org
+svn.tag             2100</programlisting>
+              </listitem>
+            </itemizedlist>
+          </listitem>
+        </varlistentry>
+
         <varlistentry>
           <term>fetch.user</term>
 
@@ -499,7 +531,7 @@
 
             <itemizedlist>
               <listitem>
-                <para>Default: ???</para>
+                <para>Default: none</para>
               </listitem>
 
               <listitem>
@@ -519,7 +551,7 @@
 
             <itemizedlist>
               <listitem>
-                <para>Default: ???</para>
+                <para>Default: none</para>
               </listitem>
 
               <listitem>
@@ -582,6 +614,10 @@
       in this section. However, fetching via CVS may cause non-reproducible
       builds, so it is strongly discouraged.</para>
 
+      <para>You have to set <link
+      linkend="reference.phases.fetch.advanced.fetch-type"><varname>fetch.type</varname></link>
+      to <option>cvs</option> to fetch from CVS.</para>
+
       <variablelist>
         <varlistentry>
           <term>cvs.root</term>
@@ -604,6 +640,26 @@
         </varlistentry>
 
         <varlistentry>
+          <term>cvs.password</term>
+
+          <listitem>
+            <para>Password to login to the CVS server.</para>
+
+            <itemizedlist>
+              <listitem>
+                <para>Default: none</para>
+              </listitem>
+
+              <listitem>
+                <para>Example:</para>
+
+                <programlisting>TODO: add example</programlisting>
+              </listitem>
+            </itemizedlist>
+          </listitem>
+        </varlistentry>
+
+        <varlistentry>
           <term>cvs.tag</term>
 
           <listitem>
@@ -674,6 +730,10 @@
       the keywords in this section. However, fetching via Subversion may cause
       non-reproducible builds, so it is strongly discouraged.</para>
 
+      <para>You have to set <link
+      linkend="reference.phases.fetch.advanced.fetch-type"><varname>fetch.type</varname></link>
+      to <option>svn</option> to fetch from SVN.</para>
+
       <variablelist>
         <varlistentry>
           <term>svn.url</term>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20080127/684e9fe7/attachment.html