[Bug 291048] FAQs 6.3 gives incorrect instructions for booting into single user mode

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=291048

--- Comment #4 from B.S. <bigsneaky@duck.com> ---
Separate to the single-user issue but worth considering in any rewrite:

> Run `passwd root` to change the `root` password
> then run man:exit[1] to continue booting.

Is there a reason to recommend typing `passwd root` rather than just `passwd`?
Specifying user is optional here, see passwd(1):

https://man.freebsd.org/cgi/man.cgi?query=passwd&sektion=1

Perhaps `passwd root` is better "defensive documentation" in that it makes it
very clear to the reader which password is being changed. There's likely a
non-zero number of readers arriving here via search engine after forgetting
their *regular* user password and only skim-reading the section for commands to
type...

Also, would "man:exit[1]" be better as "`exit`"? The latter formatting is more
consistent with the previous commands and makes it more obvious `exit` needs to
be typed. There's nothing obviously relevant for the reader in the man page for
shell built-ins that the former links to, while the more relevant passwd(1) and
mount(8) were not linked:

https://man.freebsd.org/cgi/man.cgi?query=exit&sektion=1

-- 
You are receiving this mail because:
You are the assignee for the bug.