Bug 268632

Summary:	The menu route (2) to single user mode
Product:	Documentation	Reporter:	Graham Perrin <grahamperrin>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Some People	CC:	bcr
Priority:	---	Keywords:	needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-doc/blob/main/documentation/content/en/books/handbook/boot/_index.adoc#241-single-user-mode
See Also:	https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=207902
Bug Depends on:
Bug Blocks:	263315

Description Graham Perrin freebsd_committer

2022-12-29 04:03:59 UTC

Neither <https://docs.freebsd.org/en/books/faq/#forgot-root-pw> nor <https://docs.freebsd.org/en/books/handbook/book/#boot-singleuser> mentions what's probably the most user-friendly approach to single user mode: 

* the menu

– pictured at <https://byte-sized.de/linux-unix/freebsd-password-reset-fuer-root/>.

At <https://docs.freebsd.org/en/books/handbook/book/#bsdinstall-view-probe>, one of these two must be a misnomer: 

> FreeBSD Boot Menu

> FreeBSD Boot Loader Menu

– be consistent.

Comment 1 Graham Perrin freebsd_committer

2022-12-29 04:24:23 UTC

Side note
---------

<https://klarasystems.com/articles/the-freebsd-boot-process/> mentions 

> … the iconic “Beastie Menu”, …

Modern systems default to the orb icon (part of the FreeBSD Project logo); not the BSD daemon a.k.a. beastie. 

<https://freebsdfoundation.org/about-us/about-the-foundation/project/>

<https://github.com/freebsd/freebsd-src/commit/c807217cf2ff03a8f31087ddadb68be1045b3815>

<https://new.reddit.com/gallery/rk4ktm>

<https://www.mckusick.com/beastie/index.html>

Comment 2 commit-hook freebsd_committer

2024-05-31 15:34:14 UTC

A commit in branch main references this bug:

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

commit a3ed3390dae1bc8a89748b1f5169682ebdcee72b
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2024-05-31 15:32:00 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2024-05-31 15:32:00 +0000

    Consistency between section title and image caption

    Be consistent when labeling the boot loader screen. The title said "Boot
    Menu" but the caption of the image below reads "Boot Loader Menu". Add
    the "Loader" part to the title as well.

    PR:         268632

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

Comment 3 Benedict Reuschling freebsd_committer

2024-05-31 15:35:50 UTC

A patch was committed to address the inconsistencies.

PR closed.