Date: Mon, 14 Aug 2017 14:59:20 +0000 (UTC) From: Mathieu Arnold <mat@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r50673 - head/en_US.ISO8859-1/books/porters-handbook/makefiles Message-ID: <201708141459.v7EExKUd010575@repo.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: mat Date: Mon Aug 14 14:59:20 2017 New Revision: 50673 URL: https://svnweb.freebsd.org/changeset/doc/50673 Log: Add another example about GitHub projects with no versions. Sponsored by: Absolight Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Aug 14 14:59:17 2017 (r50672) +++ head/en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml Mon Aug 14 14:59:20 2017 (r50673) @@ -2516,6 +2516,39 @@ USE_GITHUB= yes</programlisting> <varname>${WRKDIR}/foo-1.0.2</varname>.</para> </example> + <example xml:id="makefile-master_sites-github-ex4"> + <title>Using <varname>USE_GITHUB</varname> When Upstream Does + Not Use Versions</title> + + <para>If there never was a version upstream, do not invent one + like <literal>0.1</literal> or <literal>1.0</literal>. + Create the port with a <varname>DISTVERSION</varname> of + <literal>g<replaceable>YYYY</replaceable><replaceable>MM</replaceable><replaceable>DD</replaceable></literal>, + where <literal>g</literal> is for + <application>Git</application>, and + <literal><replaceable>YYYY</replaceable><replaceable>MM</replaceable><replaceable>DD</replaceable></literal> + represents the date the commit referenced in + <varname>GH_TAGNAME</varname>.</para> + + <programlisting>PORTNAME= bar +DISTVERSION= g20140411 + +USE_GITHUB= yes +GH_TAGNAME= c472d66b</programlisting> + + <para>This creates a versioning scheme that increases over + time, and that is still before version <literal>0</literal> + (see <xref linkend="makefile-versions-ex-pkg-version"/> for + details on &man.pkg-version.8;):</para> + + <screen>&prompt.user; <userinput>pkg version -t g20140411 0</userinput> +<</screen> + + <para>Which means using <varname>PORTEPOCH</varname> will not + be needed in case upstream decides to cut versions in the + future.</para> + </example> + <sect3 xml:id="makefile-master_sites-github-multiple"> <title>Fetching Multiple Files from GitHub</title>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201708141459.v7EExKUd010575>