<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.freebsd.org/bugzilla/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4.1"
          urlbase="https://bugs.freebsd.org/bugzilla/"
          
          maintainer="bugmeister@FreeBSD.org"
>

    <bug>
          <bug_id>293517</bug_id>
          
          <creation_ts>2026-03-01 02:22:26 +0000</creation_ts>
          <short_desc>Cease recommending &apos;freebsd-update fetch install&apos;</short_desc>
          <delta_ts>2026-03-27 22:51:49 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>Documentation</product>
          <component>Books &amp; Articles</component>
          <version>Latest</version>
          <rep_platform>Any</rep_platform>
          <op_sys>Any</op_sys>
          <bug_status>Closed</bug_status>
          <resolution>FIXED</resolution>
          
          <see_also>https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=258918</see_also>
          <bug_file_loc>https://github.com/freebsd/freebsd-doc/blob/22313159f103d297235c222c53b0ad06c069650e/documentation/content/en/books/handbook/virtualization/_index.adoc?plain=1#L738-L739</bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>---</priority>
          <bug_severity>Affects Some People</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Graham Perrin">grahamperrin</reporter>
          <assigned_to name="Alexander Ziaee">ziaee</assigned_to>
          <cc>dnpowers</cc>
    
    <cc>ziaee</cc>
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>1409410</commentid>
    <comment_count>0</comment_count>
    <who name="Graham Perrin">grahamperrin</who>
    <bug_when>2026-03-01 02:22:26 +0000</bug_when>
    <thetext>Combined use of the fetch and install commands is no longer recommended. 

&lt;https://docs.freebsd.org/en/books/handbook/virtualization/#qemu-grab&gt; should be updated. 

grahamperrin@mowa219-gjp4 ~&gt; cd dev/freebsd/doc/
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)&gt; git pull --ff-only
Already up-to-date.
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)&gt; rg -il &apos;freebsd-update fetch install&apos; .
./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)&gt;</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1409413</commentid>
    <comment_count>1</comment_count>
    <who name="Graham Perrin">grahamperrin</who>
    <bug_when>2026-03-01 02:35:03 +0000</bug_when>
    <thetext>Examples of correct usage include doc 1fcf388d7d2f and &lt;https://www.freebsd.org/releases/15.0R/installation/#upgrade-binary&gt;.

----

Also, a possible bug report for the src tree: 

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

&lt;https://man.freebsd.org/cgi/man.cgi?query=freebsd-update&amp;sektion=8&amp;manpath=freebsd-current#SYNOPSIS&gt; ends with: 

&gt; command ...</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1414225</commentid>
    <comment_count>2</comment_count>
    <who name="Alexander Ziaee">ziaee</who>
    <bug_when>2026-03-27 02:14:52 +0000</bug_when>
    <thetext>This is true. Thanks graham.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>1414226</commentid>
    <comment_count>3</comment_count>
    <who name="">commit-hook</who>
    <bug_when>2026-03-27 02:33:26 +0000</bug_when>
    <thetext>A commit in branch main references this bug:

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

commit 80003f7fe77af1313aa7ece6836f05da49db25f6
Author:     Kit Dallege &lt;xaum.io@gmail.com&gt;
AuthorDate: 2026-03-27 02:00:37 +0000
Commit:     Alexander Ziaee &lt;ziaee@FreeBSD.org&gt;
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 &lt;xaum.io@gmail.com&gt;
    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(-)</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>