Bug 293519

Summary:	shutdown -r now (instead of reboot)
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Open ---
Severity:	Affects Some People	CC:	des, vladlen, ziaee
Priority:	---	Keywords:	needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/22313159f103d297235c222c53b0ad06c069650e/documentation/content/en/books/handbook/geom/_index.adoc?plain=1#L666

Description Graham Perrin 2026-03-01 03:26:43 UTC

<https://docs.freebsd.org/en/books/handbook/geom/#gmirror-troubleshooting> and <https://docs.freebsd.org/en/books/handbook/virtualization/#qemu-grab> show: 

> # reboot

Better (less blunt): 

> # shutdown -r now


grahamperrin@mowa219-gjp4 ~/d/f/doc (main)> rg -il '# reboot' . --sort=path | grep -v -e .po -e announce -e events -e news -e -press-rel -e releases | grep /en/
./documentation/content/en/books/handbook/geom/_index.adoc
./documentation/content/en/books/handbook/virtualization/_index.adoc
grahamperrin@mowa219-gjp4 ~/d/f/doc (main)> 


See base 4453ec5b8716

Comment 1 Vladlen Popolitov freebsd_committer

2026-03-04 10:54:20 UTC

and
# /sbin/reboot
in documentation/content/en/articles/new-users/_index.adoc

Comment 2 Alexander Ziaee freebsd_committer

2026-03-27 02:04:50 UTC

The reboot command was improved last year to conform to these expectations.

https://cgit.freebsd.org/src/commit/?id=4453ec5b8716bc465ff5192986099dc75d1f2ce7

Comment 3 Graham Perrin 2026-03-28 11:35:03 UTC

Comment 0 already stated "See base 4453ec5b8716".

The FreeBSD Handbook is supposed to cover RELEASE versions of FreeBSD. 

I made this bug report partly because the 2025-12-10 changes to main are not in any active stable branch. 

<https://github.com/freebsd/freebsd-src/commits/stable/13/sbin/reboot/reboot.c>
<https://github.com/freebsd/freebsd-src/commits/stable/14/sbin/reboot/reboot.c>
<https://github.com/freebsd/freebsd-src/commits/stable/15/sbin/reboot/reboot.c>

<https://github.com/freebsd/freebsd-src/commits/stable/13/sbin/reboot/reboot.8>
<https://github.com/freebsd/freebsd-src/commits/stable/14/sbin/reboot/reboot.8>
<https://github.com/freebsd/freebsd-src/commits/stable/15/sbin/reboot/reboot.8>

Comment 4 Dag-Erling Smørgrav freebsd_committer

2026-03-28 18:51:57 UTC

The change has only been made in 16 and will not be merged back to 15, 14, and 13.  Hence it probably a good idea to standardize on `shutdown -r` throughout our documentation.

Comment 5 Alexander Ziaee freebsd_committer

2026-03-28 20:07:40 UTC

(In reply to Dag-Erling Smørgrav from comment #4)

Ah, thanks. I didn't notice because there was an MFC tag.

Comment 6 Alexander Ziaee freebsd_committer

2026-03-28 20:10:31 UTC

Someone did post an AI generated patch for this, but idk if I should take it. All the author's patches to other places have a Claude tag, and they don't reply to feedback (here or elsewhere).

https://github.com/freebsd/freebsd-doc/pull/634