git: 02fd9fa29527 - main - freebsd-update: Document -v verbosity flag

From: Alexander Ziaee <ziaee_at_FreeBSD.org>
Date: Mon, 09 Mar 2026 13:55:07 UTC
The branch main has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=02fd9fa2952705ea0ed142061dd86aad7e01f8db

commit 02fd9fa2952705ea0ed142061dd86aad7e01f8db
Author:     Paarth Shirsat <paarthshirsat123@gmail.com>
AuthorDate: 2026-03-09 13:49:51 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-03-09 13:54:23 +0000

    freebsd-update: Document -v verbosity flag
    
    PR:             276099
    MFC after:      3 days
    Reported by:    michaelo
    Co-authored-by: Alexander Ziaee <ziaee@FreeBSD.org>
---
 usr.sbin/freebsd-update/freebsd-update.8  | 13 ++++++++++++-
 usr.sbin/freebsd-update/freebsd-update.sh |  1 +
 2 files changed, 13 insertions(+), 1 deletion(-)

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