diff options
author | rillig <rillig> | 2007-02-06 20:03:30 +0000 |
---|---|---|
committer | rillig <rillig> | 2007-02-06 20:03:30 +0000 |
commit | 4710aab515890120f87da37fc401eea1cb320e9c (patch) | |
tree | 42709259f9225cdfa6b5dbad9db298152df030d9 /mk/help/distname.help | |
parent | 431e8edc5780479d850c4e0f83faae3a6dea41cb (diff) | |
download | pkgsrc-4710aab515890120f87da37fc401eea1cb320e9c.tar.gz |
Documented PKGNAME and PKGREVISION.
Diffstat (limited to 'mk/help/distname.help')
-rw-r--r-- | mk/help/distname.help | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/mk/help/distname.help b/mk/help/distname.help new file mode 100644 index 00000000000..ca937e71a3a --- /dev/null +++ b/mk/help/distname.help @@ -0,0 +1,51 @@ +# $NetBSD: distname.help,v 1.1 2007/02/06 20:03:30 rillig Exp $ +# +# DISTNAME +# Every package definition should start with the definition of this +# variable. It is used in three places: +# +# 1. It is the first part of the default value for DISTFILES. +# 2. It is the default value for PKGNAME, except for the trailing +# "nb" part. +# 3. The default value of WRKSRC is ${WRKDIR}/${DISTNAME}. +# + +# PKGNAME +# This variable is somewhat special in pkgsrc. On the one hand, it +# is intended to be defined by the package, but on the other hand, +# it is overridden by bsd.pkg.mk with a value that is similar, but +# not identical to the one provided by the package. This makes it +# somewhat tricky to use this variable correctly, because its +# value changes over time. +# +# When the variable is defined by the package, it should consist +# of the package name and version, as released upstream. The "nb" +# part is specified by another variable, PKGREVISION. +# +# Later, in bsd.pkg.mk, the "nb" part is added to PKGNAME, so when +# it is used in the package, its value may differ. The package +# name without the "nb" suffix is provided in the PKGNAME_NOREV +# variable. +# +# See also: DISTNAME, PKGREVISION, PKGNAME_NOREV. +# + +# PKGREVISION +# When a pkgsrc package changes but there has not been an update +# of the upstream package, there must be a way to mark a package +# as "newer" than a previous one. That's the purpose of +# PKGREVISION. +# +# Whenever a package is modified in a user-visible way, this +# variable is increased. +# +# The value of PKGREVISION (if defined, non-empty and non-zero) +# is the last part of the PKGNAME, separated from the rest by the +# letters "nb" (which stand for NetBSD). +# +# Since this variable is specific to a single package, the only +# place where it may be defined is the package Makefile itself. +# No other file may define it. +# +# Keywords: nb +# |