explicitly document some common pkg_add features that also make sense

for pkg_info, and are automatically pulled in

1 files changed, 53 insertions, 2 deletions

diff --git a/usr.sbin/pkg_add/pkg_info.1 b/usr.sbin/pkg_add/pkg_info.1
index 3f66ae87b73..054f5ae666c 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.57 2017/09/18 14:10:11 espie Exp $
+.\"	$OpenBSD: pkg_info.1,v 1.58 2018/07/02 12:23:41 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: September 18 2017 $
+.Dd $Mdocdate: July 2 2018 $
 .Dt PKG_INFO 1
 .Os
 .Sh NAME
@@ -25,6 +25,7 @@
 .Nm pkg_info
 .Bk -words
 .Op Fl AaCcdfIKLMmPqRSstUvz
+.Op Fl D Ar name Ns Op = Ns Ar value
 .Op Fl E Ar filename
 .Op Fl e Ar pkg-name
 .Op Fl l Ar str
@@ -72,6 +73,38 @@ Show information for all currently installed packages.
 Show certificate information for signed packages.
 .It Fl c
 Show the one-line comment field for each package.
+.It Fl D Ar name Ns Op = Ns Ar value
+Enforce extra options as given by
+.Ar name ,
+similarly to
+.Xr pkg_add 1 .
+.Pp
+.Bl -tag -width "updatedependsXX" -compact
+.It Cm SIGNER
+List of trusted signers, separated by commas.
+Corresponds to list of public keys under
+.Pa /etc/signify
+we want to trust.
+Defaults to any key matching
+.Sq *pkg
+for packages, and any key matching
+.Sq *fw
+for firmware.
+.It Cm snap
+Force
+.Sq %c
+and
+.Sq %m
+to expand to
+.Sq snapshots ,
+even on a release kernel.
+.It Cm unsigned
+Allow opening unsigned packages without warnings/errors
+(necessary for
+.Xr ports 7 ,
+automatically set by the build infrastructure).
+.El
+.Pp
 .It Fl d
 Show the long-description field for each package.
 .It Fl E Ar filename
@@ -215,9 +248,27 @@ is automatically appended to the
 whereas searching in the current directory uses
 .Ar pkg-name
 literally.
+Each entry consists of a directory name.
+URL schemes such as FTP, HTTP, HTTPS, or SCP are also appropriate.
+The current directory may be indicated
+implicitly by an empty directory name, or explicitly by a single
+period
+.Pq Ql \&./ .
+Special sequences
+.Sq %a ,
+.Sq %c ,
+.Sq %m ,
+.Sq %v
+will be expanded.
 .It Ev PKG_TMPDIR
 Temporary area where package information files will be extracted, instead of
 .Pa /var/tmp .
+.It Ev TRUSTED_PKG_PATH
+Same semantics as
+.Ev PKG_PATH ,
+but it is searched before
+.Ev PKG_PATH
+and waives any kind of signature checking.
 .El
 .Sh TECHNICAL DETAILS
 Package info is either extracted from package files named on the