Bug 293517 - Cease recommending 'freebsd-update fetch install'
Summary: Cease recommending 'freebsd-update fetch install'
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: Alexander Ziaee
URL: https://github.com/freebsd/freebsd-do...
Keywords:
Depends on:
Blocks:
 
Reported: 2026-03-01 02:22 UTC by devnull
Modified: 2026-03-27 22:51 UTC (History)
2 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description devnull freebsd_committer freebsd_triage 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 devnull freebsd_committer freebsd_triage 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 freebsd_triage 2026-03-27 02:14:52 UTC 
This is true. Thanks graham.
Comment 3 commit-hook freebsd_committer freebsd_triage 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(-)