From: Josh Grosse <josh@jggimi.net>
Subject: pkg_add.1: improve clarity for -U
To: tech@openbsd.org
Date: Thu, 1 May 2025 21:56:43 -0400

For consideration.
diff --git usr.sbin/pkg_add/pkg_add.1 usr.sbin/pkg_add/pkg_add.1
index 67be4b80179..17b3fc12687 100644
--- usr.sbin/pkg_add/pkg_add.1
+++ usr.sbin/pkg_add/pkg_add.1
@@ -109,7 +109,9 @@ with
 .Fl u
 whenever possible, but
 .Fl U
-can be much faster.
+can be much faster, and is intended for use when running -current, if
+a new package needs to be added without conducting a full update of all
+packages.
 .It
 Replace existing packages with explicit other versions, using option
 .Fl r .