Page MenuHomeFreeBSD

style.mdoc: HARDWARE generates Release Notes
AcceptedPublic

Authored by ziaee on Jan 6 2025, 8:52 PM.
Tags
None
Referenced Files
F109736558: D48343.id148836.diff
Sat, Feb 8, 10:00 PM
F109731322: D48343.id148832.diff
Sat, Feb 8, 8:37 PM
Unknown Object (File)
Mon, Feb 3, 9:03 PM
Unknown Object (File)
Tue, Jan 14, 5:57 PM
Unknown Object (File)
Sun, Jan 12, 12:45 AM
Unknown Object (File)
Sat, Jan 11, 11:45 AM
Unknown Object (File)
Jan 10 2025, 7:36 AM
Unknown Object (File)
Jan 10 2025, 6:28 AM

Details

Reviewers
mhorne
carlavilla
imp
Group Reviewers
manpages
doceng
docs
Summary

FreeBSD Release Infrastructure has been building the Hardware
Release Notes from these subsections in the Kernel Interfaces Manual.
Standardize this behavior in the FreeBSD Manual page style guide with
everything we learned in the 14.2-RELEASE.

To me, this is an enormously exciting discovery, and I believe that
over the next 5 years, this can transform the supported hardware UX,
without reinventing the wheel, by doubling down on our ways instead
of reinventing them.

Reported by: bz (special thanks)
MFC after: 3 days

Diff Detail

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

Event Timeline

ziaee requested review of this revision.Jan 6 2025, 8:52 PM
rpokala added inline comments.
share/man/man5/style.mdoc.5
85
ziaee marked an inline comment as done.Jan 6 2025, 9:11 PM
pauamma_gundo.com added inline comments.
share/man/man5/style.mdoc.5
97

Fix acquire typo, thanks @pauamma!

ziaee marked an inline comment as done.Jan 6 2025, 9:20 PM
ziaee edited subscribers, added: bz; removed: imp.

Also cc'ing bz

This revision is now accepted and ready to land.Jan 6 2025, 10:53 PM

We need a new driver integration checklist. And this item in the man page section should be on it.