Mon May 19 13:16:56 2014 UTC ()
and use DEFAULT_DISTFILES in examples too.


(obache)
diff -r1.65 -r1.66 pkgsrc/doc/guide/files/build.xml
cvs diff -r1.65 -r1.66 pkgsrc/doc/guide/files/build.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/build.xml 2014/05/19 13:15:10 1.65
+++ pkgsrc/doc/guide/files/build.xml 2014/05/19 13:16:56 1.66
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: build.xml,v 1.65 2014/05/19 13:15:10 obache Exp $ --> 1<!-- $NetBSD: build.xml,v 1.66 2014/05/19 13:16:56 obache Exp $ -->
2 2
3<chapter id="build"> 3<chapter id="build">
4 <title>The build process</title> 4 <title>The build process</title>
5 5
6 <sect1 id="build.intro"> 6 <sect1 id="build.intro">
7 <title>Introduction</title> 7 <title>Introduction</title>
8 8
9 <para>This chapter gives a detailed description on how a package is 9 <para>This chapter gives a detailed description on how a package is
10 built. Building a package is separated into different 10 built. Building a package is separated into different
11 <emphasis>phases</emphasis> (for example <varname>fetch</varname>, 11 <emphasis>phases</emphasis> (for example <varname>fetch</varname>,
12 <varname>build</varname>, <varname>install</varname>), all of which are 12 <varname>build</varname>, <varname>install</varname>), all of which are
13 described in the following sections. Each phase is split into 13 described in the following sections. Each phase is split into
14 so-called <emphasis>stages</emphasis>, which take the name of the 14 so-called <emphasis>stages</emphasis>, which take the name of the
@@ -253,27 +253,27 @@ GTKDIR_DEFAULT= ${LOCALBASE} @@ -253,27 +253,27 @@ GTKDIR_DEFAULT= ${LOCALBASE}
253 <para>The variable <varname>DISTFILES</varname> specifies 253 <para>The variable <varname>DISTFILES</varname> specifies
254 the list of distfiles that have to be fetched. Its value 254 the list of distfiles that have to be fetched. Its value
255 defaults to <literal>${DEFAULT_DISTFILES}</literal> and 255 defaults to <literal>${DEFAULT_DISTFILES}</literal> and
256 its value is <literal>${DISTNAME}${EXTRACT_SUFX}</literal>, 256 its value is <literal>${DISTNAME}${EXTRACT_SUFX}</literal>,
257 so that most packages don't need to define it at all. 257 so that most packages don't need to define it at all.
258 <varname>EXTRACT_SUFX</varname> is 258 <varname>EXTRACT_SUFX</varname> is
259 <literal>.tar.gz</literal> by default, but can be changed 259 <literal>.tar.gz</literal> by default, but can be changed
260 freely. Note that if your package requires additional 260 freely. Note that if your package requires additional
261 distfiles to the default one, you cannot just append the 261 distfiles to the default one, you cannot just append the
262 additional filenames using the <literal>+=</literal> 262 additional filenames using the <literal>+=</literal>
263 operator, but you have write for example:</para> 263 operator, but you have write for example:</para>
264 264
265<programlisting> 265<programlisting>
266DISTFILES= ${DISTNAME}${EXTRACT_SUFX} additional-files.tar.gz 266DISTFILES= ${DEFAULT_DISTFILES} additional-files.tar.gz
267</programlisting> 267</programlisting>
268 268
269 <para>Each distfile is fetched from a list of sites, usually 269 <para>Each distfile is fetched from a list of sites, usually
270 <varname>MASTER_SITES</varname>. If the package has multiple 270 <varname>MASTER_SITES</varname>. If the package has multiple
271 <varname>DISTFILES</varname> or multiple 271 <varname>DISTFILES</varname> or multiple
272 <varname>PATCHFILES</varname> from different sites, you can 272 <varname>PATCHFILES</varname> from different sites, you can
273 set 273 set
274 <varname>SITES.<replaceable>distfile</replaceable></varname> 274 <varname>SITES.<replaceable>distfile</replaceable></varname>
275 to the list of URLs where the file 275 to the list of URLs where the file
276 <filename><replaceable>distfile</replaceable></filename> 276 <filename><replaceable>distfile</replaceable></filename>
277 (including the suffix) can be found.</para> 277 (including the suffix) can be found.</para>
278 278
279<programlisting> 279<programlisting>