Bug 293517

Summary:	Cease recommending 'freebsd-update fetch install'
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	Alexander Ziaee <ziaee>
Status:	Closed FIXED
Severity:	Affects Some People	CC:	dnpowers, ziaee
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/22313159f103d297235c222c53b0ad06c069650e/documentation/content/en/books/handbook/virtualization/_index.adoc?plain=1#L738-L739
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=258918

Description Graham Perrin 2026-03-01 02:22:26 UTC

Combined use of the fetch and install commands is no longer recommended. 

<https://docs.freebsd.org/en/books/handbook/virtualization/#qemu-grab> should be updated. 

grahamperrin@mowa219-gjp4 ~> cd dev/freebsd/doc/
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)> git pull --ff-only
Already up-to-date.
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)> rg -il 'freebsd-update fetch install' .
./documentation/content/ru/books/handbook/virtualization/_index.adoc
./documentation/content/ru/books/handbook/virtualization/_index.po
./documentation/content/en/books/handbook/virtualization/_index.adoc
./documentation/content/en/books/handbook/virtualization/_index.po
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)>

Comment 1 Graham Perrin freebsd_committer

2026-03-01 02:35:03 UTC

Examples of correct usage include doc 1fcf388d7d2f and <https://www.freebsd.org/releases/15.0R/installation/#upgrade-binary>.

----

Also, a possible bug report for the src tree: 

<https://man.freebsd.org/cgi/man.cgi?query=freebsd-update&sektion=8&manpath=freebsd-current#COMMANDS> "any one" (not more than one), is that consistent with the synopsis? 

<https://man.freebsd.org/cgi/man.cgi?query=freebsd-update&sektion=8&manpath=freebsd-current#SYNOPSIS> ends with: 

> command ...

Comment 2 Alexander Ziaee freebsd_committer

2026-03-27 02:14:52 UTC

This is true. Thanks graham.

Comment 3 commit-hook freebsd_committer

2026-03-27 02:33:26 UTC

A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/doc/commit/?id=80003f7fe77af1313aa7ece6836f05da49db25f6

commit 80003f7fe77af1313aa7ece6836f05da49db25f6
Author:     Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 02:00:37 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-03-27 02:31:46 +0000

    handbook/virtualization: Fix freebsd-update syntax

    Split freebsd-update fetch and install into two subcommands. If running
    an EoL FreeBSD, running the two in one command can fail to perform the
    install. This matches what was done elsewhere in the tree.

    PR:             293517
    Reported by:    Graham Perrin
    Signed-off-by:  Kit Dallege <xaum.io@gmail.com>
    Closes:         https://github.com/freebsd/freebsd-doc/pull/632

 documentation/content/en/books/handbook/virtualization/_index.adoc | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)