Add new metadata: PREV_PKGPATH and SUPERSEDES. These will be available from pkg_summary(5) database. To be used to find previous packages when a package is moved or renamed. (Even though that is not recommended.) Documented in pkgsrc Guide and in the pkg_summary(5) manual page. Upcoming commit will have some packages modified to add them.diff -r1.19 -r1.20 pkgsrc/doc/guide/files/submit.xml
(reed)
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | <!-- $NetBSD: submit.xml,v 1.19 2007/08/15 06:33:46 rillig Exp $ --> | 1 | <!-- $NetBSD: submit.xml,v 1.20 2009/05/02 16:14:37 reed Exp $ --> | |
2 | 2 | |||
3 | <chapter id="submit"> <?dbhtml filename="submit.html"?> | 3 | <chapter id="submit"> <?dbhtml filename="submit.html"?> | |
4 | <title>Submitting and Committing</title> | 4 | <title>Submitting and Committing</title> | |
5 | 5 | |||
6 | <sect1 id="submitting-binary-packages"> | 6 | <sect1 id="submitting-binary-packages"> | |
7 | <title>Submitting binary packages</title> | 7 | <title>Submitting binary packages</title> | |
8 | 8 | |||
9 | <para>Our policy is that we accept binaries only from pkgsrc | 9 | <para>Our policy is that we accept binaries only from pkgsrc | |
10 | developers to guarantee that the packages don't contain any | 10 | developers to guarantee that the packages don't contain any | |
11 | trojan horses etc. This is not to annoy anyone but rather to | 11 | trojan horses etc. This is not to annoy anyone but rather to | |
12 | protect our users! You're still free to put up your home-made | 12 | protect our users! You're still free to put up your home-made | |
13 | binary packages and tell the world where to get them. NetBSD | 13 | binary packages and tell the world where to get them. NetBSD | |
14 | developers doing bulk builds and wanting to upload them please | 14 | developers doing bulk builds and wanting to upload them please | |
@@ -139,43 +139,84 @@ | @@ -139,43 +139,84 @@ | |||
139 | the package.</para> | 139 | the package.</para> | |
140 | </listitem> | 140 | </listitem> | |
141 | </itemizedlist> | 141 | </itemizedlist> | |
142 | 142 | |||
143 | <para>Please also recognize that, just because a new version of a package | 143 | <para>Please also recognize that, just because a new version of a package | |
144 | has been released, it should not automatically be upgraded in the CVS | 144 | has been released, it should not automatically be upgraded in the CVS | |
145 | repository. We prefer to be conservative in the packages that are | 145 | repository. We prefer to be conservative in the packages that are | |
146 | included in pkgsrc - development or beta packages are not really the | 146 | included in pkgsrc - development or beta packages are not really the | |
147 | best thing for most places in which pkgsrc is used. Please use your | 147 | best thing for most places in which pkgsrc is used. Please use your | |
148 | judgement about what should go into pkgsrc, and bear in mind that | 148 | judgement about what should go into pkgsrc, and bear in mind that | |
149 | stability is to be preferred above new and possibly untested features.</para> | 149 | stability is to be preferred above new and possibly untested features.</para> | |
150 | </sect1> | 150 | </sect1> | |
151 | 151 | |||
152 | <sect1 id="renaming-package"> | |||
153 | <title>Renaming a package in pkgsrc</title> | |||
154 | ||||
155 | <para>Renaming packages is not recommended.</para> | |||
156 | ||||
157 | ||||
158 | <para>When renaming packages, be sure to fix any references to old name | |||
159 | in other Makefiles, options, buildlink files, etc.</para> | |||
160 | ||||
161 | <para>Also When renaming a package, please define | |||
162 | <varname>SUPERSEDES</varname> to the package name and dewey version | |||
163 | pattern(s) of the previous package name. | |||
164 | This may be repeated for multiple renames. | |||
165 | The new package would be an exact replacement. | |||
166 | </para> | |||
167 | ||||
168 | <para>Note that <quote>successor</quote> in the | |||
169 | CHANGES-<replaceable>YYYY</replaceable> file doesn't necessarily | |||
170 | mean that it <emphasis>supersedes</emphasis>, as that successor may | |||
171 | not be an exact replacement but is a suggestion for the replaced | |||
172 | functionality.</para> | |||
173 | ||||
174 | </sect1> | |||
175 | ||||
152 | <sect1 id="moving-package"> | 176 | <sect1 id="moving-package"> | |
153 | <title>Moving a package in pkgsrc</title> | 177 | <title>Moving a package in pkgsrc</title> | |
154 | 178 | |||
179 | <para>It is preferred that packages are not renamed or moved, but if needed | |||
180 | please follow these steps. | |||
181 | </para> | |||
182 | ||||
155 | <orderedlist> | 183 | <orderedlist> | |
156 | <listitem><para>Make a copy of the directory somewhere else.</para></listitem> | 184 | <listitem><para>Make a copy of the directory somewhere else.</para></listitem> | |
157 | 185 | |||
158 | <listitem><para>Remove all CVS dirs.</para> | 186 | <listitem><para>Remove all CVS dirs.</para> | |
159 | <para>Alternatively to the first two steps you can also do:</para> | 187 | <para>Alternatively to the first two steps you can also do:</para> | |
160 | <screen>&cprompt; <userinput>cvs -d user@cvs.NetBSD.org:/cvsroot export -D today pkgsrc/category/package</userinput></screen> | 188 | <screen>&cprompt; <userinput>cvs -d user@cvs.NetBSD.org:/cvsroot export -D today pkgsrc/category/package</userinput></screen> | |
161 | <para>and use that for further work.</para> | 189 | <para>and use that for further work.</para> | |
162 | </listitem> | 190 | </listitem> | |
163 | 191 | |||
164 | <listitem><para>Fix <varname>CATEGORIES</varname> and any | 192 | <listitem><para>Fix <varname>CATEGORIES</varname> and any | |
165 | <varname>DEPENDS</varname> paths that just did <quote>../package</quote> | 193 | <varname>DEPENDS</varname> paths that just did <quote>../package</quote> | |
166 | instead of <quote>../../category/package</quote>.</para> | 194 | instead of <quote>../../category/package</quote>.</para> | |
167 | </listitem> | 195 | </listitem> | |
168 | 196 | |||
197 | <listitem><para>In the modified package's Makefile, consider setting | |||
198 | <varname>PREV_PKGPATH</varname> to the previous category/package | |||
199 | pathname. The <varname>PREV_PKGPATH</varname> can be used by tools | |||
200 | for doing an update using pkgsrc building; for example, it can | |||
201 | search the &man.pkg.summary.5; database for <varname>PREV_PKGPATH</varname> | |||
202 | (if no <varname>SUPERSEDES</varname>) and then use the corresponding | |||
203 | new <varname>PKGPATH</varname> for that moved package. Note that | |||
204 | it may have multiple matches, so the tool should also check on the | |||
205 | <varname>PKGBASE</varname> too. The <varname>PREV_PKGPATH</varname> | |||
206 | probably has no value unless <varname>SUPERSEDES</varname> is not | |||
207 | set, i.e. <varname>PKGBASE</varname> stays the same. </para> | |||
208 | </listitem> | |||
209 | ||||
169 | <listitem><para><command>cvs import</command> the modified package in the new | 210 | <listitem><para><command>cvs import</command> the modified package in the new | |
170 | place.</para></listitem> | 211 | place.</para></listitem> | |
171 | 212 | |||
172 | <listitem><para>Check if any package depends on it: | 213 | <listitem><para>Check if any package depends on it: | |
173 | <screen>&cprompt; <userinput>cd /usr/pkgsrc</userinput> | 214 | <screen>&cprompt; <userinput>cd /usr/pkgsrc</userinput> | |
174 | &cprompt; <userinput>grep /package */*/Makefile* */*/buildlink*</userinput></screen></para> | 215 | &cprompt; <userinput>grep /package */*/Makefile* */*/buildlink*</userinput></screen></para> | |
175 | </listitem> | 216 | </listitem> | |
176 | 217 | |||
177 | <listitem><para>Fix paths in packages from step 5 to point to new location.</para></listitem> | 218 | <listitem><para>Fix paths in packages from step 5 to point to new location.</para></listitem> | |
178 | 219 | |||
179 | <listitem><para><command>cvs rm (-f)</command> the package at the old location.</para></listitem> | 220 | <listitem><para><command>cvs rm (-f)</command> the package at the old location.</para></listitem> | |
180 | 221 | |||
181 | <listitem><para>Remove from <filename>oldcategory/Makefile</filename>.</para></listitem> | 222 | <listitem><para>Remove from <filename>oldcategory/Makefile</filename>.</para></listitem> |
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | # $NetBSD: metadata.mk,v 1.30 2008/05/21 20:39:52 abs Exp $ | 1 | # $NetBSD: metadata.mk,v 1.31 2009/05/02 16:14:37 reed Exp $ | |
2 | 2 | |||
3 | ###################################################################### | 3 | ###################################################################### | |
4 | ### The targets below are all PRIVATE. | 4 | ### The targets below are all PRIVATE. | |
5 | ###################################################################### | 5 | ###################################################################### | |
6 | 6 | |||
7 | ###################################################################### | 7 | ###################################################################### | |
8 | ### | 8 | ### | |
9 | ### Temporary package meta-data directory. The contents of this directory | 9 | ### Temporary package meta-data directory. The contents of this directory | |
10 | ### are copied directly into the real package meta-data directory. | 10 | ### are copied directly into the real package meta-data directory. | |
11 | ### | 11 | ### | |
12 | PKG_DB_TMPDIR= ${WRKDIR}/.pkgdb | 12 | PKG_DB_TMPDIR= ${WRKDIR}/.pkgdb | |
13 | 13 | |||
14 | unprivileged-install-hook: ${PKG_DB_TMPDIR} | 14 | unprivileged-install-hook: ${PKG_DB_TMPDIR} | |
@@ -37,26 +37,32 @@ ${_BUILD_INFO_FILE}: plist | @@ -37,26 +37,32 @@ ${_BUILD_INFO_FILE}: plist | |||
37 | .endif | 37 | .endif | |
38 | .if !empty(USE_TOOLS:Mgmake) | 38 | .if !empty(USE_TOOLS:Mgmake) | |
39 | ${RUN}${ECHO} "GMAKE=`${GMAKE} --version | ${GREP} Make`" >> ${.TARGET}.tmp | 39 | ${RUN}${ECHO} "GMAKE=`${GMAKE} --version | ${GREP} Make`" >> ${.TARGET}.tmp | |
40 | .endif | 40 | .endif | |
41 | ${RUN}${ECHO} "PKGTOOLS_VERSION=${PKGTOOLS_VERSION}" >> ${.TARGET}.tmp | 41 | ${RUN}${ECHO} "PKGTOOLS_VERSION=${PKGTOOLS_VERSION}" >> ${.TARGET}.tmp | |
42 | .if defined(HOMEPAGE) | 42 | .if defined(HOMEPAGE) | |
43 | ${RUN}${ECHO} "HOMEPAGE=${HOMEPAGE}" >> ${.TARGET}.tmp | 43 | ${RUN}${ECHO} "HOMEPAGE=${HOMEPAGE}" >> ${.TARGET}.tmp | |
44 | .endif | 44 | .endif | |
45 | ${RUN}${ECHO} "CATEGORIES=${CATEGORIES}" >> ${.TARGET}.tmp | 45 | ${RUN}${ECHO} "CATEGORIES=${CATEGORIES}" >> ${.TARGET}.tmp | |
46 | ${RUN}${ECHO} "MAINTAINER=${MAINTAINER}" >> ${.TARGET}.tmp | 46 | ${RUN}${ECHO} "MAINTAINER=${MAINTAINER}" >> ${.TARGET}.tmp | |
47 | .if defined(OWNER) | 47 | .if defined(OWNER) | |
48 | ${RUN}${ECHO} "OWNER=${OWNER}" >> ${.TARGET}.tmp | 48 | ${RUN}${ECHO} "OWNER=${OWNER}" >> ${.TARGET}.tmp | |
49 | .endif | 49 | .endif | |
50 | .if defined(PREV_PKGPATH) | |||
51 | ${RUN}${ECHO} "PREV_PKGPATH=${PREV_PKGPATH}" >> ${.TARGET}.tmp | |||
52 | .endif | |||
53 | .if defined(SUPERSEDES) | |||
54 | ${RUN}${ECHO} "SUPERSEDES=${SUPERSEDES}" >> ${.TARGET}.tmp | |||
55 | .endif | |||
50 | ${RUN}${ECHO} "BUILD_DATE=${_BUILD_DATE_cmd:sh}" >> ${.TARGET}.tmp | 56 | ${RUN}${ECHO} "BUILD_DATE=${_BUILD_DATE_cmd:sh}" >> ${.TARGET}.tmp | |
51 | ${RUN}${ECHO} "BUILD_HOST=${_BUILD_HOST_cmd:sh}" >> ${.TARGET}.tmp | 57 | ${RUN}${ECHO} "BUILD_HOST=${_BUILD_HOST_cmd:sh}" >> ${.TARGET}.tmp | |
52 | .if !empty(CHECK_SHLIBS_SUPPORTED:M[yY][eE][sS]) | 58 | .if !empty(CHECK_SHLIBS_SUPPORTED:M[yY][eE][sS]) | |
53 | ${RUN} \ | 59 | ${RUN} \ | |
54 | case ${LDD:Q}"" in \ | 60 | case ${LDD:Q}"" in \ | |
55 | "") ldd=`${TYPE} ldd 2>/dev/null | ${AWK} '{ print $$NF }'` ;; \ | 61 | "") ldd=`${TYPE} ldd 2>/dev/null | ${AWK} '{ print $$NF }'` ;; \ | |
56 | *) ldd=${LDD:Q} ;; \ | 62 | *) ldd=${LDD:Q} ;; \ | |
57 | esac; \ | 63 | esac; \ | |
58 | bins=`${AWK} '/(^|\/)(bin|sbin|libexec)\// { print "${DESTDIR}${PREFIX}/" $$0 } END { exit 0 }' ${_PLIST_NOKEYWORDS}`; \ | 64 | bins=`${AWK} '/(^|\/)(bin|sbin|libexec)\// { print "${DESTDIR}${PREFIX}/" $$0 } END { exit 0 }' ${_PLIST_NOKEYWORDS}`; \ | |
59 | case ${OBJECT_FMT:Q}"" in \ | 65 | case ${OBJECT_FMT:Q}"" in \ | |
60 | ELF) \ | 66 | ELF) \ | |
61 | libs=`${AWK} '/(^|\/)lib\/lib.*\.so\.[0-9]+$$/ { print "${DESTDIR}${PREFIX}/" $$0 } END { exit 0 }' ${_PLIST_NOKEYWORDS}`; \ | 67 | libs=`${AWK} '/(^|\/)lib\/lib.*\.so\.[0-9]+$$/ { print "${DESTDIR}${PREFIX}/" $$0 } END { exit 0 }' ${_PLIST_NOKEYWORDS}`; \ | |
62 | if ${TEST} -n "$$bins" -o -n "$$libs"; then \ | 68 | if ${TEST} -n "$$bins" -o -n "$$libs"; then \ |
@@ -1,23 +1,23 @@ | @@ -1,23 +1,23 @@ | |||
1 | /* $NetBSD: show.c,v 1.28 2009/04/24 14:00:25 joerg Exp $ */ | 1 | /* $NetBSD: show.c,v 1.29 2009/05/02 16:14:37 reed Exp $ */ | |
2 | 2 | |||
3 | #if HAVE_CONFIG_H | 3 | #if HAVE_CONFIG_H | |
4 | #include "config.h" | 4 | #include "config.h" | |
5 | #endif | 5 | #endif | |
6 | #include <nbcompat.h> | 6 | #include <nbcompat.h> | |
7 | #if HAVE_SYS_CDEFS_H | 7 | #if HAVE_SYS_CDEFS_H | |
8 | #include <sys/cdefs.h> | 8 | #include <sys/cdefs.h> | |
9 | #endif | 9 | #endif | |
10 | __RCSID("$NetBSD: show.c,v 1.28 2009/04/24 14:00:25 joerg Exp $"); | 10 | __RCSID("$NetBSD: show.c,v 1.29 2009/05/02 16:14:37 reed Exp $"); | |
11 | 11 | |||
12 | /* | 12 | /* | |
13 | * FreeBSD install - a package for the installation and maintainance | 13 | * FreeBSD install - a package for the installation and maintainance | |
14 | * of non-core utilities. | 14 | * of non-core utilities. | |
15 | * | 15 | * | |
16 | * Redistribution and use in source and binary forms, with or without | 16 | * Redistribution and use in source and binary forms, with or without | |
17 | * modification, are permitted provided that the following conditions | 17 | * modification, are permitted provided that the following conditions | |
18 | * are met: | 18 | * are met: | |
19 | * 1. Redistributions of source code must retain the above copyright | 19 | * 1. Redistributions of source code must retain the above copyright | |
20 | * notice, this list of conditions and the following disclaimer. | 20 | * notice, this list of conditions and the following disclaimer. | |
21 | * 2. Redistributions in binary form must reproduce the above copyright | 21 | * 2. Redistributions in binary form must reproduce the above copyright | |
22 | * notice, this list of conditions and the following disclaimer in the | 22 | * notice, this list of conditions and the following disclaimer in the | |
23 | * documentation and/or other materials provided with the distribution. | 23 | * documentation and/or other materials provided with the distribution. | |
@@ -324,26 +324,28 @@ show_summary(struct pkg_meta *meta, pack | @@ -324,26 +324,28 @@ show_summary(struct pkg_meta *meta, pack | |||
324 | static const char *bi_vars[] = { | 324 | static const char *bi_vars[] = { | |
325 | "PKGPATH", | 325 | "PKGPATH", | |
326 | "CATEGORIES", | 326 | "CATEGORIES", | |
327 | "PROVIDES", | 327 | "PROVIDES", | |
328 | "REQUIRES", | 328 | "REQUIRES", | |
329 | "PKG_OPTIONS", | 329 | "PKG_OPTIONS", | |
330 | "OPSYS", | 330 | "OPSYS", | |
331 | "OS_VERSION", | 331 | "OS_VERSION", | |
332 | "MACHINE_ARCH", | 332 | "MACHINE_ARCH", | |
333 | "LICENSE", | 333 | "LICENSE", | |
334 | "HOMEPAGE", | 334 | "HOMEPAGE", | |
335 | "PKGTOOLS_VERSION", | 335 | "PKGTOOLS_VERSION", | |
336 | "BUILD_DATE", | 336 | "BUILD_DATE", | |
337 | "PREV_PKGPATH", | |||
338 | "SUPERSEDES", | |||
337 | NULL | 339 | NULL | |
338 | }; | 340 | }; | |
339 | 341 | |||
340 | plist_t *p; | 342 | plist_t *p; | |
341 | struct stat st; | 343 | struct stat st; | |
342 | 344 | |||
343 | for (p = plist->head; p; p = p->next) { | 345 | for (p = plist->head; p; p = p->next) { | |
344 | switch (p->type) { | 346 | switch (p->type) { | |
345 | case PLIST_NAME: | 347 | case PLIST_NAME: | |
346 | printf("PKGNAME=%s\n", p->name); | 348 | printf("PKGNAME=%s\n", p->name); | |
347 | break; | 349 | break; | |
348 | case PLIST_PKGDEP: | 350 | case PLIST_PKGDEP: | |
349 | printf("DEPENDS=%s\n", p->name); | 351 | printf("DEPENDS=%s\n", p->name); |
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | .\" $NetBSD: pkg_summary.5,v 1.8 2009/02/08 23:12:05 wiz Exp $ | 1 | .\" $NetBSD: pkg_summary.5,v 1.9 2009/05/02 16:14:37 reed Exp $ | |
2 | .\" | 2 | .\" | |
3 | .\" Copyright (c) 2006 The NetBSD Foundation | 3 | .\" Copyright (c) 2006 The NetBSD Foundation | |
4 | .\" | 4 | .\" | |
5 | .\" Redistribution and use in source and binary forms, with or without | 5 | .\" Redistribution and use in source and binary forms, with or without | |
6 | .\" modification, are permitted provided that the following conditions | 6 | .\" modification, are permitted provided that the following conditions | |
7 | .\" are met: | 7 | .\" are met: | |
8 | .\" 1. Redistributions of source code must retain the above copyright | 8 | .\" 1. Redistributions of source code must retain the above copyright | |
9 | .\" notice, this list of conditions and the following disclaimer. | 9 | .\" notice, this list of conditions and the following disclaimer. | |
10 | .\" 2. Redistributions in binary form must reproduce the above copyright | 10 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
11 | .\" notice, this list of conditions and the following disclaimer in the | 11 | .\" notice, this list of conditions and the following disclaimer in the | |
12 | .\" documentation and/or other materials provided with the distribution. | 12 | .\" documentation and/or other materials provided with the distribution. | |
13 | .\" 3. Neither the name of the NetBSD Foundation nor the names of its | 13 | .\" 3. Neither the name of the NetBSD Foundation nor the names of its | |
14 | .\" contributors may be used to endorse or promote products derived from | 14 | .\" contributors may be used to endorse or promote products derived from | |
@@ -17,27 +17,27 @@ | @@ -17,27 +17,27 @@ | |||
17 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION AND ITS CONTRIBUTORS | 17 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION AND ITS CONTRIBUTORS | |
18 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT | 18 | .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT | |
19 | .\" NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND | 19 | .\" NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND | |
20 | .\" FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT | 20 | .\" FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT | |
21 | .\" SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, | 21 | .\" SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, | |
22 | .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | 22 | .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES | |
23 | .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | 23 | .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
24 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | 24 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
25 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | 25 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
26 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | 26 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
27 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | 27 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
28 | .\" SUCH DAMAGE. | 28 | .\" SUCH DAMAGE. | |
29 | .\" | 29 | .\" | |
30 | .Dd August 29, 2007 | 30 | .Dd April 11, 2009 | |
31 | .Dt PKG_SUMMARY 5 | 31 | .Dt PKG_SUMMARY 5 | |
32 | .Os | 32 | .Os | |
33 | .Sh NAME | 33 | .Sh NAME | |
34 | .Nm pkg_summary | 34 | .Nm pkg_summary | |
35 | .Nd summary of binary package repository | 35 | .Nd summary of binary package repository | |
36 | .Sh DESCRIPTION | 36 | .Sh DESCRIPTION | |
37 | The file | 37 | The file | |
38 | .Nm | 38 | .Nm | |
39 | contains information about each package in a binary package | 39 | contains information about each package in a binary package | |
40 | repository as a list of variable-value pairs. | 40 | repository as a list of variable-value pairs. | |
41 | The variables describing different packages are separated by one empty | 41 | The variables describing different packages are separated by one empty | |
42 | line. | 42 | line. | |
43 | Each line has the format | 43 | Each line has the format | |
@@ -84,36 +84,46 @@ If empty or missing, it is OSI-approved. | @@ -84,36 +84,46 @@ If empty or missing, it is OSI-approved. | |||
84 | (required) The operating system on which the package was compiled. | 84 | (required) The operating system on which the package was compiled. | |
85 | .It Ev OS_VERSION | 85 | .It Ev OS_VERSION | |
86 | (required) The version of the operating system on which the package | 86 | (required) The version of the operating system on which the package | |
87 | was compiled. | 87 | was compiled. | |
88 | .It Ev PKG_OPTIONS | 88 | .It Ev PKG_OPTIONS | |
89 | (optional) Any options selected to compile this package. | 89 | (optional) Any options selected to compile this package. | |
90 | If missing, the package does not support options. | 90 | If missing, the package does not support options. | |
91 | .It Ev PKGNAME | 91 | .It Ev PKGNAME | |
92 | (required) The name of the package. | 92 | (required) The name of the package. | |
93 | .It Ev PKGPATH | 93 | .It Ev PKGPATH | |
94 | (required) The path of the package directory within pkgsrc. | 94 | (required) The path of the package directory within pkgsrc. | |
95 | .It Ev PKGTOOLS_VERSION | 95 | .It Ev PKGTOOLS_VERSION | |
96 | (required) The version of the package tools used to create the package. | 96 | (required) The version of the package tools used to create the package. | |
97 | .It Ev PREV_PKGPATH | |||
98 | (optional) The previous path of the package directory within pkgsrc when | |||
99 | a package was moved. | |||
100 | (See | |||
101 | .Ev SUPERSEDES | |||
102 | below for a renamed package.) | |||
97 | .It Ev PROVIDES | 103 | .It Ev PROVIDES | |
98 | (optional) A list of shared libraries provided by the package, | 104 | (optional) A list of shared libraries provided by the package, | |
99 | including major version number, one per line. | 105 | including major version number, one per line. | |
100 | If missing, this package does not provide shared libraries. | 106 | If missing, this package does not provide shared libraries. | |
101 | .It Ev REQUIRES | 107 | .It Ev REQUIRES | |
102 | (optional) A list of shared libraries needed by the package, including | 108 | (optional) A list of shared libraries needed by the package, including | |
103 | major version number, one per line. | 109 | major version number, one per line. | |
104 | If missing, this package does not require shared libraries. | 110 | If missing, this package does not require shared libraries. | |
105 | .It Ev SIZE_PKG | 111 | .It Ev SIZE_PKG | |
106 | (required) The size of the package when installed, in bytes. | 112 | (required) The size of the package when installed, in bytes. | |
113 | .It Ev SUPERSEDES | |||
114 | (optional) A list of dewey patterns of previous packages this | |||
115 | package replaces, one per line. | |||
116 | This is used for package renaming. | |||
107 | .El | 117 | .El | |
108 | .Pp | 118 | .Pp | |
109 | The | 119 | The | |
110 | .Nm pkg_summary | 120 | .Nm pkg_summary | |
111 | file can be generated using the | 121 | file can be generated using the | |
112 | .Xr pkg_info 1 | 122 | .Xr pkg_info 1 | |
113 | .Fl X | 123 | .Fl X | |
114 | option. | 124 | option. | |
115 | For example, the following will list this data for all installed packages: | 125 | For example, the following will list this data for all installed packages: | |
116 | .Pp | 126 | .Pp | |
117 | .Dl "pkg_info -X -a" | 127 | .Dl "pkg_info -X -a" | |
118 | .Sh SEE ALSO | 128 | .Sh SEE ALSO | |
119 | .Xr pkg_info 1 | 129 | .Xr pkg_info 1 |
@@ -1,14 +1,14 @@ | @@ -1,14 +1,14 @@ | |||
1 | /* $NetBSD: version.h,v 1.125 2009/04/25 21:31:14 joerg Exp $ */ | 1 | /* $NetBSD: version.h,v 1.126 2009/05/02 16:14:37 reed Exp $ */ | |
2 | 2 | |||
3 | /* | 3 | /* | |
4 | * Copyright (c) 2001 Thomas Klausner. All rights reserved. | 4 | * Copyright (c) 2001 Thomas Klausner. All rights reserved. | |
5 | * | 5 | * | |
6 | * Redistribution and use in source and binary forms, with or without | 6 | * Redistribution and use in source and binary forms, with or without | |
7 | * modification, are permitted provided that the following conditions | 7 | * modification, are permitted provided that the following conditions | |
8 | * are met: | 8 | * are met: | |
9 | * 1. Redistributions of source code must retain the above copyright | 9 | * 1. Redistributions of source code must retain the above copyright | |
10 | * notice, this list of conditions and the following disclaimer. | 10 | * notice, this list of conditions and the following disclaimer. | |
11 | * 2. Redistributions in binary form must reproduce the above copyright | 11 | * 2. Redistributions in binary form must reproduce the above copyright | |
12 | * notice, this list of conditions and the following disclaimer in the | 12 | * notice, this list of conditions and the following disclaimer in the | |
13 | * documentation and/or other materials provided with the distribution. | 13 | * documentation and/or other materials provided with the distribution. | |
14 | * | 14 | * | |
@@ -17,16 +17,16 @@ | @@ -17,16 +17,16 @@ | |||
17 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | 17 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | |
18 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | 18 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, | |
19 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | 19 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT | |
20 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | 20 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, | |
21 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | 21 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY | |
22 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | 22 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT | |
23 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | 23 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF | |
24 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | 24 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | |
25 | */ | 25 | */ | |
26 | 26 | |||
27 | #ifndef _INST_LIB_VERSION_H_ | 27 | #ifndef _INST_LIB_VERSION_H_ | |
28 | #define _INST_LIB_VERSION_H_ | 28 | #define _INST_LIB_VERSION_H_ | |
29 | 29 | |||
30 | #define PKGTOOLS_VERSION "20090425" | 30 | #define PKGTOOLS_VERSION "20090502" | |
31 | 31 | |||
32 | #endif /* _INST_LIB_VERSION_H_ */ | 32 | #endif /* _INST_LIB_VERSION_H_ */ |