Changeset 40894 for trunk/doc-new


Ignore:
Timestamp:
Oct 17, 2008, 1:33:45 PM (11 years ago)
Author:
simon@…
Message:

base: Add support to fetch using Mercurial.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-phase.xml

    r38559 r40894  
    526526            <para>Change the fetch type. This is only necessary if a <link
    527527            linkend="reference.phases.fetch.cvs">CVS</link>, <link
    528             linkend="reference.phases.fetch.svn">svn</link>, or <link
    529             linkend="reference.phases.fetch.git">git</link> checkout is be
     528            linkend="reference.phases.fetch.svn">svn</link>, <link
     529            linkend="reference.phases.fetch.git">git</link> or <link
     530            linkend="reference.phases.fetch.hg">hg</link> checkout is be
    530531            used. <option>standard</option> is used for a normal http or ftp
    531532            fetch using <varname>${distfiles}</varname> and is used as
     
    865866
    866867                <programlisting>git.branch             origin/next</programlisting>
     868              </listitem>
     869            </itemizedlist>
     870          </listitem>
     871        </varlistentry>
     872      </variablelist>
     873    </section>
     874
     875    <section id="reference.phases.fetch.hg">
     876      <title>Fetch from Mercurial</title>
     877
     878      <para><ulink url="http://selenic.com/mercurial">Mercurial</ulink> may be
     879      used as an alternative method of fetching distribution files using the
     880      keywords in this section. However, fetching via Mercurial may cause
     881      non-reproducible builds, so it is strongly discouraged.</para>
     882
     883      <para>You have to set <link
     884      linkend="reference.phases.fetch.advanced.fetch-type"><varname>fetch.type</varname></link>
     885      to <option>hg</option> to fetch from Mercurial.</para>
     886
     887      <variablelist>
     888        <varlistentry>
     889          <term>hg.url</term>
     890
     891          <listitem>
     892            <para>This specifies the url from which to fetch files.</para>
     893
     894            <itemizedlist>
     895              <listitem>
     896                <para>Default: none</para>
     897              </listitem>
     898
     899              <listitem>
     900                <para>Examples:</para>
     901
     902                <programlisting>hg.url              http://www.kernel.org/hg/index.cgi/linux-2.6/</programlisting>
     903
     904                <programlisting>hg.url              http://hg.intevation.org/mercurial</programlisting>
     905              </listitem>
     906            </itemizedlist>
     907          </listitem>
     908        </varlistentry>
     909
     910        <varlistentry>
     911          <term>hg.tag</term>
     912
     913          <listitem>
     914            <para>Optional tag which should be fetched. Can be a Mercurial tag
     915            or a revision. To prevent non-reproducible builds use of tip as
     916            revision is discouraged.</para>
     917
     918            <itemizedlist>
     919              <listitem>
     920                <para>Default: tip</para>
     921              </listitem>
     922
     923              <listitem>
     924                <para>Example:</para>
     925
     926                <programlisting>hg.tag                 v1.3</programlisting>
     927
     928                <programlisting>hg.tag                 ceb884843737</programlisting>
    867929              </listitem>
    868930            </itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.