Sat Jun 13 06:33:35 2009 UTC ()
Documented the most recent change.


(rillig)
diff -r1.16 -r1.17 pkgsrc/pkgtools/pkglint/files/doc/chap.types.xml
cvs diff -r1.16 -r1.17 pkgsrc/pkgtools/pkglint/files/doc/Attic/chap.types.xml (expand / switch to unified diff)

--- pkgsrc/pkgtools/pkglint/files/doc/Attic/chap.types.xml 2009/04/26 11:27:42 1.16
+++ pkgsrc/pkgtools/pkglint/files/doc/Attic/chap.types.xml 2009/06/13 06:33:35 1.17
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: chap.types.xml,v 1.16 2009/04/26 11:27:42 rillig Exp $ --> 1<!-- $NetBSD: chap.types.xml,v 1.17 2009/06/13 06:33:35 rillig Exp $ -->
2 2
3<chapter id="types"> 3<chapter id="types">
4<title>The &pkglint; type system</title> 4<title>The &pkglint; type system</title>
5 5
6 <para>One of the most notable additions to &pkglint; is the 6 <para>One of the most notable additions to &pkglint; is the
7 introduction of typed variables. Traditionally, in 7 introduction of typed variables. Traditionally, in
8 <filename>Makefile</filename>s, all variables have the type 8 <filename>Makefile</filename>s, all variables have the type
9 <type>String</type>. This prevents many useful checks from being 9 <type>String</type>. This prevents many useful checks from being
10 done before executing the code.</para> 10 done before executing the code.</para>
11 11
12 <para>Up to 2004, &pkglint; already did some checks based on 12 <para>Up to 2004, &pkglint; already did some checks based on
13 the value of the variables, but these checks had no common 13 the value of the variables, but these checks had no common
14 structure that could be described easily.</para> 14 structure that could be described easily.</para>
@@ -266,26 +266,31 @@ @@ -266,26 +266,31 @@
266 <listitem><para>A dependency (see above), followed by a colon 266 <listitem><para>A dependency (see above), followed by a colon
267 and a relative directory. For some packages, special variables 267 and a relative directory. For some packages, special variables
268 like <varname>USE_TOOLS</varname> should be used instead of an 268 like <varname>USE_TOOLS</varname> should be used instead of an
269 explicit dependency.</para></listitem></varlistentry> 269 explicit dependency.</para></listitem></varlistentry>
270 270
271 <varlistentry><term><literal><type>DistSuffix</type></literal></term> 271 <varlistentry><term><literal><type>DistSuffix</type></literal></term>
272 <listitem><para>The value of the variable 272 <listitem><para>The value of the variable
273 <varname>EXTRACT_SUFX</varname>. The difference in the name is 273 <varname>EXTRACT_SUFX</varname>. The difference in the name is
274 intentional here, since <varname>EXTRACT_SUFX</varname> is a 274 intentional here, since <varname>EXTRACT_SUFX</varname> is a
275 misnomer. <varname>DIST_SUFX</varname> or 275 misnomer. <varname>DIST_SUFX</varname> or
276 <varname>DIST_SUFFIX</varname> would be more appropriate.</para> 276 <varname>DIST_SUFFIX</varname> would be more appropriate.</para>
277 </listitem></varlistentry> 277 </listitem></varlistentry>
278 278
 279 <varlistentry><term><literal><type>EmulPlatform</type></literal></term>
 280 <listitem><para>An emulated platform consists of the operating
 281 system (in lowercase, as opposed to <type>PlatformTriple</type>)
 282 and the hardware architecture.</para></listitem></varlistentry>
 283
279 <varlistentry><term><literal><type>Filename</type></literal></term> 284 <varlistentry><term><literal><type>Filename</type></literal></term>
280 <listitem><para>A filename, as defined in <ulink 285 <listitem><para>A filename, as defined in <ulink
281 url="http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap03.html#tag_03_169">POSIX</ulink>. 286 url="http://www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap03.html#tag_03_169">POSIX</ulink>.
282 This type further restricts the set of allowed characters. 287 This type further restricts the set of allowed characters.
283 See also <literal><type>Pathname</type></literal>.</para> 288 See also <literal><type>Pathname</type></literal>.</para>
284 </listitem></varlistentry> 289 </listitem></varlistentry>
285 290
286 <varlistentry><term><literal><type>Filemask</type></literal></term> 291 <varlistentry><term><literal><type>Filemask</type></literal></term>
287 <listitem><para>A shell globbing pattern that does not contain a 292 <listitem><para>A shell globbing pattern that does not contain a
288 slash. See also <literal><type>Pathmask</type></literal>.</para> 293 slash. See also <literal><type>Pathmask</type></literal>.</para>
289 </listitem></varlistentry> 294 </listitem></varlistentry>
290 295
291 <varlistentry><term><literal><type>Identifier</type></literal></term> 296 <varlistentry><term><literal><type>Identifier</type></literal></term>