dag-erling · Oct 29, 2026
diff --git a/docs/Makefile.in b/docs/Makefile.in
@@ -42,6 +42,7 @@ MAN8=	pkg-add.8 \
 	pkg-unregister.8 \
 	pkg-update.8 \
 	pkg-updating.8 \
+	pkg-upgradable.8 \
 	pkg-upgrade.8 \
 	pkg-version.8 \
 	pkg-which.8 \

diff --git a/docs/pkg-add.8 b/docs/pkg-add.8
@@ -168,6 +168,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-alias.8 b/docs/pkg-alias.8
@@ -106,6 +106,7 @@ for alias
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-annotate.8 b/docs/pkg-annotate.8
@@ -226,6 +226,7 @@ Show all packages with the foo annotation:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-audit.8 b/docs/pkg-audit.8
@@ -164,6 +164,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-autoremove.8 b/docs/pkg-autoremove.8
@@ -109,6 +109,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-check.8 b/docs/pkg-check.8
@@ -190,6 +190,7 @@ pkg install -f <package-name>
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-checksum.8 b/docs/pkg-checksum.8
@@ -166,6 +166,7 @@ $ pkg checksum -c '2$ybndr...' /usr/local/bin/curl
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-clean.8 b/docs/pkg-clean.8
@@ -120,6 +120,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-config.8 b/docs/pkg-config.8
@@ -83,6 +83,7 @@ Getting the directories where the repositories configuration are read:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-create.8 b/docs/pkg-create.8
@@ -576,6 +576,7 @@ Create package file for pkg:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-delete.8 b/docs/pkg-delete.8
@@ -220,6 +220,7 @@ Delete all packages except base and pkg packages:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-fetch.8 b/docs/pkg-fetch.8
@@ -204,6 +204,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-help.8 b/docs/pkg-help.8
@@ -101,6 +101,7 @@ Display all available commands:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-info.8 b/docs/pkg-info.8
@@ -221,6 +221,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-install.8 b/docs/pkg-install.8
@@ -300,6 +300,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-key.8 b/docs/pkg-key.8
@@ -254,6 +254,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-keywords.5 b/docs/pkg-keywords.5
@@ -209,6 +209,7 @@ being in the example case,
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-lock.8 b/docs/pkg-lock.8
@@ -189,6 +189,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-lua-script.5 b/docs/pkg-lua-script.5
@@ -289,6 +289,7 @@ and an error message if the directory cannot be opened.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-plugins.8 b/docs/pkg-plugins.8
@@ -110,6 +110,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-query.8 b/docs/pkg-query.8
@@ -575,6 +575,7 @@ List all options of a package in key=value format:
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-register.8 b/docs/pkg-register.8
@@ -218,6 +218,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-repo.8 b/docs/pkg-repo.8
@@ -321,6 +321,7 @@ filename.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8

diff --git a/docs/pkg-repositories.8 b/docs/pkg-repositories.8
@@ -178,6 +178,7 @@ Remove the override (revert to configuration):
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-repository.5 b/docs/pkg-repository.5
@@ -481,6 +481,7 @@ in
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-rquery.8 b/docs/pkg-rquery.8
@@ -387,6 +387,7 @@ for example usage.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-rwhich.8 b/docs/pkg-rwhich.8
@@ -189,6 +189,7 @@ will not search it.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-script.5 b/docs/pkg-script.5
@@ -137,6 +137,7 @@ This variable is set when a script is run in the context of an upgrade of a pack
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-search.8 b/docs/pkg-search.8
@@ -519,6 +519,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-set.8 b/docs/pkg-set.8
@@ -203,6 +203,7 @@ for further description.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-shell.8 b/docs/pkg-shell.8
@@ -95,6 +95,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-shlib.8 b/docs/pkg-shlib.8
@@ -116,6 +116,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-ssh.8 b/docs/pkg-ssh.8
@@ -93,6 +93,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-stats.8 b/docs/pkg-stats.8
@@ -98,6 +98,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-triggers.5 b/docs/pkg-triggers.5
@@ -208,6 +208,7 @@ for a fresh installation or a standalone removal.
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-triggers.8 b/docs/pkg-triggers.8
@@ -86,6 +86,7 @@ See
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-unregister.8 b/docs/pkg-unregister.8
@@ -185,6 +185,7 @@ See
 .Xr pkg-triggers 8 ,
 .Xr pkg-update 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-update.8 b/docs/pkg-update.8
@@ -144,6 +144,7 @@ See
 .Xr pkg-triggers 8 ,
 .Xr pkg-unregister 8 ,
 .Xr pkg-updating 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8
diff --git a/docs/pkg-updating.8 b/docs/pkg-updating.8
@@ -131,6 +131,7 @@ installed ports:
 .Xr pkg-triggers 8 ,
 .Xr pkg-unregister 8 ,
 .Xr pkg-update 8 ,
+.Xr pkg-upgradable 8 ,
 .Xr pkg-upgrade 8 ,
 .Xr pkg-version 8 ,
 .Xr pkg-which 8