1.\" $OpenBSD: portbump.1,v 1.1 2018/06/26 05:38:49 espie Exp $ 2.\" 3.\" Copyright (c) 2014 Vadim Zhukov 4.\" 5.\" Permission to use, copy, modify, and distribute this software for any 6.\" purpose with or without fee is hereby granted, provided that the above 7.\" copyright notice and this permission notice appear in all copies. 8.\" 9.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16.\" 17.Dd $Mdocdate: June 26 2018 $ 18.Dt PORTBUMP 1 19.Os 20.Sh NAME 21.Nm portbump 22.Nd tweaks port revisions and library versions 23.Sh SYNOPSIS 24.Nm 25.Op Fl lMmnrv 26.Op Fl W Ar wlib 27.Op Fl w Ar wlib 28.Op Ar portref ... 29.Pp 30.Nm 31.Fl o Ar file 32.Op Fl lMmnrv 33.Op Fl W Ar addlib 34.Op Fl w Ar rmlib 35.Op Ar portref ... 36.Sh DESCRIPTION 37.Nm 38is used to increase ('bump') 39.Ev REVISION 40and 41.Ev SHARED_LIBS 42values in 43.Ox 44ports. 45It also can remove 46.Ev REVISION 47marks and add, update or remove 48.Ev WANTLIB 49items. 50.Pp 51.Ar portref 52has the same syntax as 53.Ev FULLPKGPATH 54port variable, see 55.Xr bsd.port.mk 5 . 56Actually, you can feed a list of pkgpaths as parameters; flavor 57information will be ignored. 58.Nm 59doesn't care about actual subdirectory portion of 60.Ar portref , 61so you can freely pass 62.Pa \&. , 63.Pa ../foo 64or anything else like this. 65.Pp 66If subpackage is not specified in port reference, then all subpackages 67of a port will be processed. 68If no port references are given, the port in current directory will 69be processed. 70.Pp 71Default mode of operation is increasing 72.Ev REVISION 73mark values ( 74.Fl r ) . 75Operations on 76.Ev REVISION 77marks and on 78.Ev SHARED_LIBS 79could be combined by explicit specifying corresponding flags, see below. 80.Pp 81The following options are available: 82.Bl -tag -width Ds 83.It Fl d 84Delete all 85.Ev REVISION 86marks in 87.Pa Makefile . 88Mutually exclusive with 89.Fl r . 90.It Fl l 91Recreate all 92.Ev WANTLIB 93items based on output of 94.Sq make port-lib-depends-check . 95If used twice or more, the 96.Sq make lib-depends-check 97will be used instead. 98The 99.Fl l 100mode is incompatible with 101.Fl W 102and 103.Fl w . 104.It Fl M 105Increment by one major component of all 106.Ev SHARED_LIBS , 107resetting minor one to zero if needed. 108Mutually exclusive with 109.Fl m . 110.It Fl m 111Increment by one minor component of all 112.Ev SHARED_LIBS . 113Mutually exclusive with 114.Fl M . 115.It Fl n 116Do not replace 117.Pa Makefile 118but save modified version in the 119.Pa Makefile.bump 120instead. 121.It Fl o Ar file 122Send modified Makefile contents to a given file instead of creating 123.Pa Makefile.bump 124in port's directory. 125This could be only used if not more than one port is specified; 126multiple subpackages of a single port could be specified, though. 127.It Fl r 128Increment 129.Ev REVISION 130values for all subpackages, or only for given ones. 131Mutually exclusive with 132.Fl d . 133.It Fl W Ar wlib 134.It Fl w Ar wlib 135Adds or updates (the 136.Fl W 137flag) or removes (the 138.Fl w 139flag) 140.Ev WANTLIB 141items in whole port, or in particular subpackages, if given. 142Both options could be specified multiple times, accumulating 143corresponding lists. 144The 145.Ev WANTLIB 146entries will be fully re-generated based on previous contents. 147Those modes are incompatible with 148.Fl l . 149.It Fl v 150Enable printing of diagnostic messages to standard error output. 151.El 152.Sh HISTORY 153.Nm 154first appeared in 155.Ox 5.6 . 156