freebsd-update: Document -v verbosity flag

PR:		276099
MFC after:	3 days
Reported by:	michaelo
Co-authored-by:	Alexander Ziaee <ziaee@FreeBSD.org>

2 files changed, 13 insertions, 1 deletions

diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8
index 7524087cb95b..cdb4915f7bfd 100644
--- a/usr.sbin/freebsd-update/freebsd-update.8
+++ b/usr.sbin/freebsd-update/freebsd-update.8
@@ -23,7 +23,7 @@
 .\" IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 2, 2024
+.Dd March 9, 2026
 .Dt FREEBSD-UPDATE 8
 .Os
 .Sh NAME
@@ -42,6 +42,7 @@
 .Op Fl r Ar newrelease
 .Op Fl s Ar server
 .Op Fl t Ar address
+.Op Fl v Ar level
 .Ar command ...
 .Sh DESCRIPTION
 The
@@ -135,6 +136,16 @@ Mail output of
 command, if any, to
 .Ar address .
 (default: root, or as given in the configuration file.)
+.It Fl v Ar level
+Set output verbosity.
+.Ar level
+must be one of
+.Cm stats
+(show progress statistics while fetching files; the default),
+.Cm nostats
+(suppress progress statistics), or
+.Cm debug
+(show all output from internal utilities).
 .It Fl -not-running-from-cron
 Force
 .Nm Cm fetch
diff --git a/usr.sbin/freebsd-update/freebsd-update.sh b/usr.sbin/freebsd-update/freebsd-update.sh
index a58b50e9ca2e..b23ada60e8aa 100644
--- a/usr.sbin/freebsd-update/freebsd-update.sh
+++ b/usr.sbin/freebsd-update/freebsd-update.sh
@@ -52,6 +52,7 @@ Options:
                   (default: update.FreeBSD.org)
   -t address   -- Mail output of cron command, if any, to address
                   (default: root)
+  -v level     -- Set output verbosity to stats, nostats, or debug
   --not-running-from-cron
                -- Run without a tty, for use by automated tools
   --currently-running release