Bug 292221 - sh(1) manpage formatting error in "Built-in commands" section
Summary: sh(1) manpage formatting error in "Built-in commands" section
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Alexander Ziaee
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-01-06 17:13 UTC by Dan
Modified: 2026-02-05 22:38 UTC (History)
3 users (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Dan 2026-01-06 17:13:41 UTC
The online sh(1) man page formatting is broken in 15.0, resulting in built-in command names not being displayed. This seems not to affect the man pages on a FreeBSD install, just the freebsd.org version. Eyeballing the mdoc source for sh.1, it's not obvious to me why one should be different from the other.

Scroll to the getopts section and compare to 14.3, note that indentation and command names are wrong starting with the hash builtin:
https://man.freebsd.org/cgi/man.cgi?query=sh&apropos=0&sektion=1&manpath=FreeBSD+15.0-RELEASE
https://man.freebsd.org/cgi/man.cgi?query=sh&apropos=0&sektion=1&manpath=FreeBSD+14.3-RELEASE
Comment 1 commit-hook freebsd_committer freebsd_triage 2026-01-06 17:33:05 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=2962dc76877538508944a441fd1570322e969380

commit 2962dc76877538508944a441fd1570322e969380
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-01-06 17:25:26 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-01-06 17:31:32 +0000

    sh.1: Restore missing builtin commands

    PR:             292221
    Fixes:          2980318b2747 (sh.1: extend the section about getopts)
    MFC after:      3 days

 bin/sh/sh.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Comment 2 commit-hook freebsd_committer freebsd_triage 2026-02-05 21:51:41 UTC
A commit in branch stable/15 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=f807836f38faeff7b627dd346c1df9c3c66f2268

commit f807836f38faeff7b627dd346c1df9c3c66f2268
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-01-06 17:25:26 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-02-05 21:49:53 +0000

    sh.1: Restore missing builtin commands

    PR:             292221
    Fixes:          2980318b2747 (sh.1: extend the section about getopts)
    MFC after:      3 days

    (cherry picked from commit 2962dc76877538508944a441fd1570322e969380)

 bin/sh/sh.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
Comment 3 Alexander Ziaee freebsd_committer freebsd_triage 2026-02-05 22:38:10 UTC
Thanks Dan!