Page MenuHomeFreeBSD

mdoc: SYNOPISIS should not have prose
Needs ReviewPublic

Authored by ziaee on Jan 7 2026, 8:42 PM.
Tags
None
Referenced Files
F145224858: D54586.diff
Tue, Feb 17, 7:16 AM
F145218166: D54586.diff
Tue, Feb 17, 5:34 AM
Unknown Object (File)
Sun, Jan 25, 1:39 PM
Unknown Object (File)
Sun, Jan 25, 9:40 AM
Unknown Object (File)
Tue, Jan 20, 9:06 PM
Unknown Object (File)
Tue, Jan 20, 7:55 PM
Unknown Object (File)
Jan 15 2026, 12:42 PM
Unknown Object (File)
Jan 12 2026, 2:32 PM
Subscribers
This revision needs review, but there are no reviewers specified.

Details

Reviewers
None
Summary

To be discussed on arch@ and with upstream, improved commit message
coming later.

MFC after: no

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 70431
Build 67314: arc lint + arc unit

Event Timeline

ziaee requested review of this revision.Jan 7 2026, 8:42 PM

make mdoc(7) a bit clearer

jlduran added inline comments.
contrib/mandoc/mdoc.7
1187

FreeBSD -> .Fx

+ demonstrate some pages use optional values in synopsis
+ use the freebsd macro instead of typing freebsd