Changeset 126039 for trunk/doc-new


Ignore:
Timestamp:
Oct 2, 2014, 2:39:05 PM (4 years ago)
Author:
khindenburg@…
Message:

guide: sort fetch types alphabetically; add stub for bzr

File:
1 edited

Legend:

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

    r119075 r126039  
    526526          <listitem>
    527527            <para>Change the fetch type. This is only necessary if a <link
    528             linkend="reference.phases.fetch.cvs">CVS</link>, <link
    529             linkend="reference.phases.fetch.svn">svn</link>, <link
    530             linkend="reference.phases.fetch.git">git</link> or <link
    531             linkend="reference.phases.fetch.hg">hg</link> checkout is be used.
     528            linkend="reference.phases.fetch.bzr">bzr</link>, <link
     529            linkend="reference.phases.fetch.cvs">cvs</link>, <link
     530            linkend="reference.phases.fetch.git">git</link>, <link
     531            linkend="reference.phases.fetch.hg">hg</link>, or <link
     532            linkend="reference.phases.fetch.svn">svn</link> checkout is be used.
    532533            <option>standard</option> is used for a normal http or ftp fetch
    533534            using <varname>${distfiles}</varname> and is used as
     
    540541
    541542              <listitem>
    542                 <para>Values: <option>standard</option> <option>cvs</option>
    543                 <option>svn</option> <option>git</option></para>
     543                <para>Values: <option>standard</option> <option>bzr</option>
     544                <option>cvs</option> <option>git</option>
     545                <option>hg</option> <option>svn</option></para>
    544546              </listitem>
    545547
     
    638640    </section>
    639641
     642    <section id="reference.phases.fetch.bzr">
     643      <title>Fetch from BZR</title>
     644
     645    </section>
     646
    640647    <section id="reference.phases.fetch.cvs">
    641648      <title>Fetch from CVS</title>
     
    747754
    748755                <programlisting>cvs.module          Sources</programlisting>
     756              </listitem>
     757            </itemizedlist>
     758          </listitem>
     759        </varlistentry>
     760      </variablelist>
     761    </section>
     762
     763
     764    <section id="reference.phases.fetch.git">
     765      <title>Fetch from Git</title>
     766
     767      <para><ulink url="http://git-scm.com/">Git</ulink> may be used as an
     768      alternative method of fetching distribution files using the keywords in
     769      this section. However, fetching via Git may cause non-reproducible
     770      builds, so it is strongly discouraged.</para>
     771
     772      <para>The <option>git</option> <link
     773      linkend="reference.phases.fetch.advanced.fetch-type">fetch.type</link>
     774      is used to fetch source code from a git repository.</para>
     775
     776      <variablelist>
     777        <varlistentry>
     778          <term>git.url</term>
     779
     780          <listitem>
     781            <para>This specifies the url from which to fetch files.</para>
     782
     783            <itemizedlist>
     784              <listitem>
     785                <para>Default: none</para>
     786              </listitem>
     787
     788              <listitem>
     789                <para>Examples:</para>
     790
     791                <programlisting>git.url             git://git.kernel.org/pub/scm/git/git.git</programlisting>
     792
     793                <programlisting>git.url             http://www.kernel.org/pub/scm/git/git.git</programlisting>
     794              </listitem>
     795            </itemizedlist>
     796          </listitem>
     797        </varlistentry>
     798
     799        <varlistentry>
     800          <term>git.branch</term>
     801
     802          <listitem>
     803            <para>Optional tag for fetching with git, this specifies the tag
     804            or other commit-ish that git should checkout. Note that any tag on
     805            a branch besides HEAD should be prefixed by origin/.</para>
     806
     807            <itemizedlist>
     808              <listitem>
     809                <para>Default: none</para>
     810              </listitem>
     811
     812              <listitem>
     813                <para>Example:</para>
     814
     815                <programlisting>git.branch             72bf1c8</programlisting>
     816
     817                <programlisting>git.branch             origin/next</programlisting>
     818              </listitem>
     819            </itemizedlist>
     820          </listitem>
     821        </varlistentry>
     822      </variablelist>
     823    </section>
     824
     825    <section id="reference.phases.fetch.hg">
     826      <title>Fetch from Mercurial</title>
     827
     828      <para><ulink url="http://mercurial.selenic.com/">Mercurial</ulink> may be
     829      used as an alternative method of fetching distribution files using the
     830      keywords in this section. However, fetching via Mercurial may cause
     831      non-reproducible builds, so it is strongly discouraged.</para>
     832
     833      <para>The <option>hg</option> <link
     834      linkend="reference.phases.fetch.advanced.fetch-type">fetch.type</link>
     835      is used to fetch source code from a Mercurial repository.</para>
     836
     837      <variablelist>
     838        <varlistentry>
     839          <term>hg.url</term>
     840
     841          <listitem>
     842            <para>This specifies the url from which to fetch files.</para>
     843
     844            <itemizedlist>
     845              <listitem>
     846                <para>Default: none</para>
     847              </listitem>
     848
     849              <listitem>
     850                <para>Examples:</para>
     851
     852                <programlisting>hg.url              http://www.kernel.org/hg/index.cgi/linux-2.6/</programlisting>
     853
     854                <programlisting>hg.url              http://hg.intevation.org/mercurial</programlisting>
     855              </listitem>
     856            </itemizedlist>
     857          </listitem>
     858        </varlistentry>
     859
     860        <varlistentry>
     861          <term>hg.tag</term>
     862
     863          <listitem>
     864            <para>Optional tag which should be fetched. Can be a Mercurial tag
     865            or a revision. To prevent non-reproducible builds use of tip as
     866            revision is discouraged.</para>
     867
     868            <itemizedlist>
     869              <listitem>
     870                <para>Default: tip</para>
     871              </listitem>
     872
     873              <listitem>
     874                <para>Example:</para>
     875
     876                <programlisting>hg.tag              v1.3</programlisting>
     877
     878                <programlisting>hg.tag              ceb884843737</programlisting>
    749879              </listitem>
    750880            </itemizedlist>
     
    831961
    832962                <programlisting>svn.method          checkout</programlisting>
    833               </listitem>
    834             </itemizedlist>
    835           </listitem>
    836         </varlistentry>
    837       </variablelist>
    838     </section>
    839 
    840     <section id="reference.phases.fetch.git">
    841       <title>Fetch from Git</title>
    842 
    843       <para><ulink url="http://git-scm.com/">Git</ulink> may be used as an
    844       alternative method of fetching distribution files using the keywords in
    845       this section. However, fetching via Git may cause non-reproducible
    846       builds, so it is strongly discouraged.</para>
    847 
    848       <para>The <option>git</option> <link
    849       linkend="reference.phases.fetch.advanced.fetch-type">fetch.type</link>
    850       is used to fetch source code from a git repository.</para>
    851 
    852       <variablelist>
    853         <varlistentry>
    854           <term>git.url</term>
    855 
    856           <listitem>
    857             <para>This specifies the url from which to fetch files.</para>
    858 
    859             <itemizedlist>
    860               <listitem>
    861                 <para>Default: none</para>
    862               </listitem>
    863 
    864               <listitem>
    865                 <para>Examples:</para>
    866 
    867                 <programlisting>git.url             git://git.kernel.org/pub/scm/git/git.git</programlisting>
    868 
    869                 <programlisting>git.url             http://www.kernel.org/pub/scm/git/git.git</programlisting>
    870               </listitem>
    871             </itemizedlist>
    872           </listitem>
    873         </varlistentry>
    874 
    875         <varlistentry>
    876           <term>git.branch</term>
    877 
    878           <listitem>
    879             <para>Optional tag for fetching with git, this specifies the tag
    880             or other commit-ish that git should checkout. Note that any tag on
    881             a branch besides HEAD should be prefixed by origin/.</para>
    882 
    883             <itemizedlist>
    884               <listitem>
    885                 <para>Default: none</para>
    886               </listitem>
    887 
    888               <listitem>
    889                 <para>Example:</para>
    890 
    891                 <programlisting>git.branch             72bf1c8</programlisting>
    892 
    893                 <programlisting>git.branch             origin/next</programlisting>
    894               </listitem>
    895             </itemizedlist>
    896           </listitem>
    897         </varlistentry>
    898       </variablelist>
    899     </section>
    900 
    901     <section id="reference.phases.fetch.hg">
    902       <title>Fetch from Mercurial</title>
    903 
    904       <para><ulink url="http://mercurial.selenic.com/">Mercurial</ulink> may be
    905       used as an alternative method of fetching distribution files using the
    906       keywords in this section. However, fetching via Mercurial may cause
    907       non-reproducible builds, so it is strongly discouraged.</para>
    908 
    909       <para>The <option>hg</option> <link
    910       linkend="reference.phases.fetch.advanced.fetch-type">fetch.type</link>
    911       is used to fetch source code from a Mercurial repository.</para>
    912 
    913       <variablelist>
    914         <varlistentry>
    915           <term>hg.url</term>
    916 
    917           <listitem>
    918             <para>This specifies the url from which to fetch files.</para>
    919 
    920             <itemizedlist>
    921               <listitem>
    922                 <para>Default: none</para>
    923               </listitem>
    924 
    925               <listitem>
    926                 <para>Examples:</para>
    927 
    928                 <programlisting>hg.url              http://www.kernel.org/hg/index.cgi/linux-2.6/</programlisting>
    929 
    930                 <programlisting>hg.url              http://hg.intevation.org/mercurial</programlisting>
    931               </listitem>
    932             </itemizedlist>
    933           </listitem>
    934         </varlistentry>
    935 
    936         <varlistentry>
    937           <term>hg.tag</term>
    938 
    939           <listitem>
    940             <para>Optional tag which should be fetched. Can be a Mercurial tag
    941             or a revision. To prevent non-reproducible builds use of tip as
    942             revision is discouraged.</para>
    943 
    944             <itemizedlist>
    945               <listitem>
    946                 <para>Default: tip</para>
    947               </listitem>
    948 
    949               <listitem>
    950                 <para>Example:</para>
    951 
    952                 <programlisting>hg.tag              v1.3</programlisting>
    953 
    954                 <programlisting>hg.tag              ceb884843737</programlisting>
    955963              </listitem>
    956964            </itemizedlist>
Note: See TracChangeset for help on using the changeset viewer.