document @version

3 files changed, 29 insertions, 7 deletions

diff --git a/usr.sbin/pkg_add/package.5 b/usr.sbin/pkg_add/package.5
index a17cb1f563a..2968b31f7e3 100644
--- a/usr.sbin/pkg_add/package.5
+++ b/usr.sbin/pkg_add/package.5
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: package.5,v 1.25 2016/10/05 14:59:19 espie Exp $
+.\"	$OpenBSD: package.5,v 1.26 2017/09/18 14:10:11 espie Exp $
 .\" Copyright (c) 2005-2006 Marc Espie <espie@openbsd.org>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
@@ -12,7 +12,7 @@
 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-.Dd $Mdocdate: October 5 2016 $
+.Dd $Mdocdate: September 18 2017 $
 .Dt PACKAGE 5
 .Os
 .Sh NAME
@@ -221,6 +221,14 @@ Starting with
 will migrate timestamps from the tarball meta-info to the packing-list
 to better create unchanging archive chunks.
 .Pp
+.It Cm @version Ar number
+Record a global (system) version number for the package.
+This is built adding together
+.Fl V
+options from
+.Xr pkg_create 1 ,
+and triggers updates when it changes.
+.Pp
 .It Cm @wantlib Ar libspec
 Record a library requirement declared using the option
 .Fl W
diff --git a/usr.sbin/pkg_add/pkg_create.1 b/usr.sbin/pkg_add/pkg_create.1
index defb1b33eab..69234e5d272 100644
--- a/usr.sbin/pkg_add/pkg_create.1
+++ b/usr.sbin/pkg_add/pkg_create.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_create.1,v 1.106 2017/03/11 18:24:55 schwarze Exp $
+.\"	$OpenBSD: pkg_create.1,v 1.107 2017/09/18 14:10:11 espie Exp $
 .\"
 .\" Documentation and design originally from FreeBSD. All the code has
 .\" been rewritten since. We keep the documentation's notice:
@@ -21,7 +21,7 @@
 .\" [jkh] Took John's changes back and made some additional extensions for
 .\" better integration with FreeBSD's new ports collection.
 .\"
-.Dd $Mdocdate: March 11 2017 $
+.Dd $Mdocdate: September 18 2017 $
 .Dt PKG_CREATE 1
 .Os
 .Sh NAME
@@ -38,6 +38,7 @@
 .Op Fl M Ar displayfile
 .Op Fl P Ar pkgpath : Ns Ar pkgspec : Ns Ar default
 .Op Fl U Ar undisplayfile
+.Op Fl V Ar n
 .Op Fl W Ar libspec
 .Fl d Ar desc
 .Fl D Ar COMMENT Ns = Ns Ar value
@@ -224,6 +225,18 @@ Display the file (using
 .Xr more 1 )
 when deinstalling the package.
 Useful for reminders about stuff to clean up.
+.It Fl V Ar n
+Adds
+.Ar n
+to the
+.Sq global system version
+of the package
+.Po see
+.Xr package 5
+.Pc .
+The default value of 0 is not recorded, thus packages without
+.Cm @version
+have an implicit version of 0.
 .It Fl v
 Turn on verbose output.
 .It Fl W Ar libspec
diff --git a/usr.sbin/pkg_add/pkg_info.1 b/usr.sbin/pkg_add/pkg_info.1
index 73c14246525..3f66ae87b73 100644
--- a/usr.sbin/pkg_add/pkg_info.1
+++ b/usr.sbin/pkg_add/pkg_info.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_info.1,v 1.56 2017/02/27 21:53:11 rpe Exp $
+.\"	$OpenBSD: pkg_info.1,v 1.57 2017/09/18 14:10:11 espie Exp $
 .\"
 .\" Documentation and design originally from FreeBSD. All the code has
 .\" been rewritten since. We keep the documentation's notice:
@@ -15,7 +15,7 @@
 .\" Jordan K. Hubbard
 .\"
 .\"
-.Dd $Mdocdate: February 27 2017 $
+.Dd $Mdocdate: September 18 2017 $
 .Dt PKG_INFO 1
 .Os
 .Sh NAME
@@ -169,7 +169,8 @@ Exit status will be augmented by 2 if none of the packages do match.
 Show the update signature for each package.
 The
 .Sq update signature
-is a unique tag showing the package name, and the version number
+is a unique tag showing the package name, a global version number,
+and the version number
 of every run time dependency and shared library used to build this package.
 .It Fl s
 Show an estimate of the total size of each package.