Alexander Ziaee

#manpages, bugmeister

I'm working on the system reference manual. I'm especially interested in hearing about what is working and not working in the manual, undocumented diagnostic messages and sysctls, patterns for manual title search optimization, new drivers and improving release hardware notes.

Feel free to message me on EFNet, send me a mail, cc me on a list, tag me in a review, or file a bug.

Drafts: (testing notes)

Outdated docs list for pkgbase

mtw(4) : feedback

builtin(1) : feedback

Handbook/x11 : feedback

setxkbmap(1) : feedback

build(7) + development(7) : feedback

Aspirations:

• please protect BSD look and feel
• protect our indexed problem report database
• disambiguate mdoc(7) semantic markup
• improve mandoc(1) pdf generation
• teach apropos 'Li=' to search examples (Ql, Dl, Bd -literal)
• hardware release notes should not insert a '/' before '_'
• improve base two byte unit and notation consistency
• reserve "FreeBSD" in titles for system topic overview manuals
• seek compromises to reduce fragmentation
• reduce documentation proliferation
• low-complexity .sh_history merging

Presentations:

Increasing Consistency in man(4), BSDCan 2025