| @@ -1,112 +1,112 @@ | | | @@ -1,112 +1,112 @@ |
1 | .\" $NetBSD: revbump.1,v 1.12 2012/10/02 13:59:02 wiz Exp $ | | 1 | .\" $NetBSD: revbump.1,v 1.13 2012/10/02 17:10:10 wiz Exp $ |
2 | .\" | | 2 | .\" |
3 | .\" Copyright (c) 2003, 2004, 2005, 2006, 2010, 2012 The NetBSD Foundation, Inc. | | 3 | .\" Copyright (c) 2003, 2004, 2005, 2006, 2010, 2012 The NetBSD Foundation, Inc. |
4 | .\" | | 4 | .\" |
5 | .\" This code was originally contributed to the NetBSD Foundation, Inc. | | 5 | .\" This code was originally contributed to the NetBSD Foundation, Inc. |
6 | .\" by Julio Merino <jmmv@NetBSD.org> and Thomas Klausner <wiz@NetBSD.org>. | | 6 | .\" by Julio Merino <jmmv@NetBSD.org> and Thomas Klausner <wiz@NetBSD.org>. |
7 | .\" | | 7 | .\" |
8 | .\" Redistribution and use in source and binary forms, with or without | | 8 | .\" Redistribution and use in source and binary forms, with or without |
9 | .\" modification, are permitted provided that the following conditions | | 9 | .\" modification, are permitted provided that the following conditions |
10 | .\" are met: | | 10 | .\" are met: |
11 | .\" 1. Redistributions of source code must retain the above copyright | | 11 | .\" 1. Redistributions of source code must retain the above copyright |
12 | .\" notice, this list of conditions and the following disclaimer. | | 12 | .\" notice, this list of conditions and the following disclaimer. |
13 | .\" 2. Redistributions in binary form must reproduce the above copyright | | 13 | .\" 2. Redistributions in binary form must reproduce the above copyright |
14 | .\" notice, this list of conditions and the following disclaimer in | | 14 | .\" notice, this list of conditions and the following disclaimer in |
15 | .\" the documentation and/or other materials provided with the | | 15 | .\" the documentation and/or other materials provided with the |
16 | .\" distribution. | | 16 | .\" distribution. |
17 | .\" 3. Neither the name of author nor the names of its contributors may | | 17 | .\" 3. Neither the name of author nor the names of its contributors may |
18 | .\" be used to endorse or promote products derived from this software | | 18 | .\" be used to endorse or promote products derived from this software |
19 | .\" without specific prior written permission. | | 19 | .\" without specific prior written permission. |
20 | .\" | | 20 | .\" |
21 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND | | 21 | .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND |
22 | .\" CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, | | 22 | .\" CONTRIBUTORS ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, |
23 | .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF | | 23 | .\" INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF |
24 | .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. | | 24 | .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. |
25 | .\" IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY | | 25 | .\" IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS BE LIABLE FOR ANY |
26 | .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | | 26 | .\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL |
27 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE | | 27 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE |
28 | .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS | | 28 | .\" GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS |
29 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER | | 29 | .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER |
30 | .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR | | 30 | .\" IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR |
31 | .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN | | 31 | .\" OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN |
32 | .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. | | 32 | .\" IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
33 | .\" | | 33 | .\" |
34 | .Dd October 2, 2012 | | 34 | .Dd October 2, 2012 |
35 | .Dt REVBUMP 1 | | 35 | .Dt REVBUMP 1 |
36 | .Os | | 36 | .Os |
37 | .Sh NAME | | 37 | .Sh NAME |
38 | .Nm revbump | | 38 | .Nm revbump |
39 | .Nd tool to help bump PKGREVISIONs automatically | | 39 | .Nd tool to help bump PKGREVISIONs automatically |
40 | .Sh SYNOPSIS | | 40 | .Sh SYNOPSIS |
41 | .Nm | | 41 | .Nm |
42 | .Op Fl h | | 42 | .Op Fl h |
43 | .Op Fl p Ar pkgsrcdir | | 43 | .Op Fl p Ar pkgsrcdir |
44 | .Op cat1/pkg1 ... catN/pkgN | | 44 | .Op cat1/pkg1 ... catN/pkgN |
45 | .Sh DESCRIPTION | | 45 | .Sh DESCRIPTION |
46 | .Nm | | 46 | .Nm |
47 | is a perl script for pkgsrc developers that simplifies bumping | | 47 | is a perl script for pkgsrc developers that simplifies bumping |
48 | PKGREVISIONs automatically. | | 48 | PKGREVISIONs automatically. |
49 | Given a package (in | | 49 | Given a package (in |
50 | .Ar category/package | | 50 | .Ar category/package |
51 | format) on the command line or stdin, it will try to increase | | 51 | format) on the command line or stdin, it will try to increase |
52 | the PKGREVISION for that package automatically. | | 52 | the PKGREVISION for that package automatically. |
53 | .Pp | | 53 | .Pp |
54 | .Nm Fl h | | 54 | .Nm Fl h |
55 | displays a short usage. | | 55 | displays a short usage. |
56 | .Pp | | 56 | .Pp |
57 | If | | 57 | If |
58 | .Fl p | | 58 | .Fl p |
59 | is given, | | 59 | is given, |
60 | .Ar pkgsrcdir | | 60 | .Ar pkgsrcdir |
61 | is used instead of the default | | 61 | is used instead of the default |
62 | .Pa /usr/pkgsrc . | | 62 | .Pa /usr/pkgsrc . |
63 | .Pp | | 63 | .Pp |
64 | .Nm | | 64 | .Nm |
65 | reports successful updates on stdout, and prints the package name | | 65 | reports successful updates on stdout, and prints the package name |
66 | (in | | 66 | (in |
67 | .Ar category/package | | 67 | .Ar category/package |
68 | form) on stdout for each package where it failed. | | 68 | form) on stdout for each package where it failed. |
69 | .Sh EXAMPLES | | 69 | .Sh EXAMPLES |
70 | .Dl revbump devel/gmake x11/glib2 | | 70 | .Dl revbump devel/gmake x11/glib2 |
71 | .Pp | | 71 | .Pp |
72 | would bump the PKGREVISIONs of gmake and glib2, as would | | 72 | would bump the PKGREVISIONs of gmake and glib2, as would |
73 | .Bd -literal -offset indent | | 73 | .Bd -literal -offset indent |
74 | revbump \*[Lt]\*[Lt] EOF | | 74 | revbump \*[Lt]\*[Lt] EOF |
75 | devel/gmake | | 75 | devel/gmake |
76 | x11/glib2 | | 76 | x11/glib2 |
77 | EOF | | 77 | EOF |
78 | .Ed | | 78 | .Ed |
79 | .Pp | | 79 | .Pp |
80 | The complete procedure for a recursive dependency bump for | | 80 | The complete procedure for a recursive dependency bump for |
81 | the openssl package using | | 81 | the openssl package using |
82 | .Nm | | 82 | .Nm |
83 | and | | 83 | and |
84 | .Xr blbump 1 | | 84 | .Xr blbump 1 |
85 | would be: | | 85 | would be: |
86 | .Bd -literal -offset indent | | 86 | .Bd -literal -offset indent |
87 | cd /usr/pkgsrc | | 87 | cd /usr/pkgsrc |
88 | finddepends category/package \*[Gt] allbump | | 88 | finddepends category/package \*[Gt] allbump |
89 | grep buildlink3.mk allbump | sed 's/.buildlink3.mk//' \*[Gt] bl3bump | | 89 | grep buildlink3.mk allbump | sed 's/.buildlink3.mk//' \*[Gt] bl3bump |
90 | grep Makefile.common allbump > commonbump | | 90 | grep Makefile.common allbump > commonbump |
91 | [read commonbump and replace entries with all packages including the | | 91 | [read commonbump and replace entries with all packages including the |
92 | corresponding Makefile.common file] | | 92 | corresponding Makefile.common file] |
93 | cat allbump commonbump | sed 's,/[^/]*$,,' | sort -u \*[Gt] makebump | | 93 | cat allbump commonbump | sed 's,/[^/]*$,,' | sort -u \*[Gt] makebump |
94 | revbump \*[Lt] makebump \*[Gt] makebump.manual | | 94 | revbump \*[Lt] makebump \*[Gt] makebump.manual |
95 | [if a package is listed in makebump.manual outside a line | | 95 | [if a package is listed in makebump.manual outside a line |
96 | "Updated ... from ... to ...", handle the PKGREVISION bump manually] | | 96 | "Updated ... from ... to ...", handle the PKGREVISION bump manually] |
97 | blbump \*[Lt] bl3bump \*[Gt] bl3bump.manual | | 97 | blbump \*[Lt] bl3bump \*[Gt] bl3bump.manual |
98 | [handle the *ABI_DEPENDS* bumps in bl3bump.manual manually, usually none] | | 98 | [handle the *ABI_DEPENDS* bumps in bl3bump.manual manually, usually none] |
99 | cvs diff `cat makebump` | | 99 | cvs diff `cat makebump` |
100 | [look for PYPKGPREFIX -\*[Gt] py27 | | 100 | [look for PYPKGPREFIX -\*[Gt] py27 |
101 | and RUBY_PKGPREFIX -\*[Gt] ruby19 expansions | | 101 | and RUBY_PKGPREFIX -\*[Gt] ruby19 expansions |
102 | in buildlink files and any unrelated diffs you have in your | | 102 | in buildlink files and any unrelated diffs you have in your |
103 | local tree, and fix them] | | 103 | local tree, and fix them] |
104 | lintpkgsrc -d | | 104 | lintpkgsrc -d |
105 | [fix broken dependencies noted by this (usually subversion)] | | 105 | [fix broken dependencies noted by this (usually subversion)] |
106 | cvs diff `cat makebump` | | 106 | cvs diff `cat bl3bump makebump` |
107 | cvs commit `cat makebump` | | 107 | cvs commit `cat bl3bump makebump` |
108 | rm allbump bl3bump* makebump* commonbump | | 108 | rm allbump bl3bump* makebump* commonbump |
109 | .Ed | | 109 | .Ed |
110 | .Sh SEE ALSO | | 110 | .Sh SEE ALSO |
111 | .Xr blbump 1 , | | 111 | .Xr blbump 1 , |
112 | .Xr finddepends 1 | | 112 | .Xr finddepends 1 |