Bug 274233

Summary:	shells(5) is unnecessarily obtuse and lacks examples
Product:	Documentation	Reporter:	Mina Galić <freebsd>
Component:	Manual Pages	Assignee:	freebsd-bugs (Nobody) <bugs>
Status:	Open ---
Severity:	Affects Some People	CC:	doc
Priority:	---	Keywords:	easy, needs-patch
Version:	Latest
Hardware:	Any
OS:	Any
URL:	https://github.com/freebsd/freebsd-src/blob/main/share/man/man5/shells.5

Description Mina Galić freebsd_triage

2023-10-03 09:06:55 UTC

"consisting of the shell's path, relative to root."

we could make this easier to understand by saying:

"consisting of the shell's absolute path."

in addition, an Example would say more than a thousand words.

Comment 1 Graham Perrin 2023-10-03 19:45:59 UTC

<https://man.freebsd.org/cgi/man.cgi?query=shells&sektion=5&manpath=freebsd-release>

Maybe a candidate for a simple pull request; <https://github.com/freebsd/freebsd-src/blob/main/CONTRIBUTING.md#contribution-guidelines-for-github>.