document DEBUG_PKG_CACHE

1 files changed, 17 insertions, 2 deletions

diff --git a/usr.sbin/pkg_add/pkg_add.1 b/usr.sbin/pkg_add/pkg_add.1
index b1f597fdcb8..d4a98258d34 100644
--- a/usr.sbin/pkg_add/pkg_add.1
+++ b/usr.sbin/pkg_add/pkg_add.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: pkg_add.1,v 1.160 2019/08/19 12:25:40 espie Exp $
+.\"	$OpenBSD: pkg_add.1,v 1.161 2019/12/04 10:53:27 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: August 19 2019 $
+.Dd $Mdocdate: December 4 2019 $
 .Dt PKG_ADD 1
 .Os
 .Sh NAME
@@ -257,6 +257,18 @@ If the environment variable
 is set to a directory name, every package retrieved from a distant location
 will also be copied here.
 .Pp
+If the environment variable
+.Ev DEBUG_PKG_CACHE
+is set to a directory name, debug packages matching installed/updated packages
+will be downloaded to that directory
+.Po
+this is to avoid
+.Sq shearing ,
+as later on, you might wish to debug software, but the snapshots will have
+moved on and the debug packages no longer match your installation
+.Pc .
+This only applies to debug packages that are not currently installed/updated.
+.Pp
 Some packages may depend on other packages.
 When resolving dependencies
 .Nm
@@ -750,6 +762,9 @@ will update the package.
 .El
 .Sh ENVIRONMENT
 .Bl -tag -width PKG_CHECKSUM
+.It Ev DEBUG_PKG_CACHE
+If set, debug packages matching installed/updated packages will be downloaded
+to that directory as well.
 .It Ev FTPMODE
 Specifies whether
 .Xr ftp 1