Differential D2118 Diff 4342 en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Changeset View

Standalone View

en_US.ISO8859-1/books/porters-handbook/makefiles/chapter.xml

Show First 20 Lines • Show All 1,823 Lines • ▼ Show 20 Lines	<entry><literal>${PORTNAME}</literal></entry>
</row>		</row>


<row>		<row>
<entry><varname>GH_TAGNAME</varname></entry>		<entry><varname>GH_TAGNAME</varname></entry>
<entry>Name of the tag to download (2.0.1, hash, ...)		<entry>Name of the tag to download (2.0.1, hash, ...)
Using the name of a branch here is incorrect. It is		Using the name of a branch here is incorrect. It is
also possible to use the hash of a commit id to do a		also possible to use the hash of a commit id to do a
snapshot</entry>		snapshot.</entry>
<entry><literal>${DISTVERSION}</literal></entry>		<entry><literal>${DISTVERSIONFULL}</literal></entry>
		bdreweryUnsubmitted Not Done Inline Actions I don't believe DISTVERSIONFULL is documented anywhere. I added it to avoid duplication, but it may be overkill. Either need to define DISTVERSIONFULL in the PH or just expand it out here to {DISTVERSIONPREVIX}{DISTVERSION}{DISTVERSIONSUFFIX} bdrewery: I don't believe DISTVERSIONFULL is documented anywhere. I added it to avoid duplication, but it…
		matAuthorUnsubmitted Not Done Inline Actions Yeah, it's not documented anywhere, I started by expanding it here, but then the last column gets a bit big, and I'm sure the pdf version will look aweful. Maybe we don't really care. mat: Yeah, it's not documented anywhere, I started by expanding it here, but then the last column…
</row>		</row>
</tbody>		</tbody>
</tgroup>		</tgroup>
</table>		</table>

<example xml:id="makefile-master_sites-github-ex1">		<example xml:id="makefile-master_sites-github-ex1">
<title>Simple Use of <varname>USE_GITHUB</varname></title>		<title>Simple Use of <varname>USE_GITHUB</varname></title>

Show All 34 Lines
GH_ACCOUNT= freebsd		GH_ACCOUNT= freebsd
GH_PROJECT= pkg		GH_PROJECT= pkg
GH_TAGNAME= 6dbb17b</programlisting>		GH_TAGNAME= 6dbb17b</programlisting>

<para>It will automatically have		<para>It will automatically have
<varname>MASTER_SITES</varname> set to <literal>GH		<varname>MASTER_SITES</varname> set to <literal>GH
GHC</literal> and <varname>WRKSRC</varname> to		GHC</literal> and <varname>WRKSRC</varname> to
<literal>${WRKDIR}/pkg-6dbb17b</literal>.</para>		<literal>${WRKDIR}/pkg-6dbb17b</literal>.</para>
		</example>

		<example xml:id="makefile-master_sites-github-ex3">
		<title>Use of <varname>USE_GITHUB</varname> with
		<varname>DISTVERSIONPREFIX</varname></title>

		<para>From time to time, <varname>GH_TAGNAME</varname> is a
		slight variation from <varname>PORTREVISION</varname>, for
		bcrUnsubmitted Not Done Inline Actions I'd stop the sentence here at the , and start a new one in order not to make the sentence too long. The paragraph should then be like this: From time to time ... variation from PORTREVISION. For example, if the version ... bcr: I'd stop the sentence here at the , and start a new one in order not to make the sentence too…
		example if the version is <literal>1.0.2</literal>, the
		bcrUnsubmitted Not Done Inline Actions Add a comma after the word "example", then it is perfect (for me). bcr: Add a comma after the word "example", then it is perfect (for me).
		tag is <literal>v1.0.2</literal>, in those case, it is
		bcrUnsubmitted Not Done Inline Actions ... and another stop here. The sentence goes from: For example, if the version ... the tag is v1.0.2. In those cases, it is possible to use DISTVERSIONPREFIX or DISTVERSIONSUFFIX: ... bcr: ... and another stop here. The sentence goes from: For example, if the version ... the tag is…
		possible to use <varname>DISTVERSIONPREFIX</varname> or
		<varname>DISTVERSIONSUFFIX</varname>:</para>

		<programlisting>PORTNAME= foo
		PORTVERSION= 1.0.2
		DISTVERSIONPREFIX= v

		USE_GITHUB= yes</programlisting>

		<para>It will automatically set
		<varname>GH_TAGNAME</varname> to
		<literal>v1.0.2</literal>, while <varname>WRKSRC</varname>
		will be kept to
		<varname>${WRKDIR}/foo-1.0.2</varname>.</para>
</example>		</example>

</sect3>		</sect3>
</sect2>		</sect2>

<sect2 xml:id="makefile-extract_sufx">		<sect2 xml:id="makefile-extract_sufx">
<title><varname>EXTRACT_SUFX</varname></title>		<title><varname>EXTRACT_SUFX</varname></title>

▲ Show 20 Lines • Show All 2,921 Lines • Show Last 20 Lines