Bug 293517 - Cease recommending 'freebsd-update fetch install'
Summary: Cease recommending 'freebsd-update fetch install'
Status: Open
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL: https://github.com/freebsd/freebsd-do...
Keywords: needs-patch
Depends on:
Blocks:
 
Reported: 2026-03-01 02:22 UTC by Graham Perrin
Modified: 2026-03-01 03:17 UTC (History)
1 user (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 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 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 ...