Page MenuHomeFreeBSD

sysexits.3: Enable apropos by error number
AbandonedPublic

Authored by ziaee on Jan 23 2025, 1:51 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mon, Feb 23, 3:30 AM
Unknown Object (File)
Sat, Feb 21, 6:53 AM
Unknown Object (File)
Sat, Feb 21, 6:52 AM
Unknown Object (File)
Wed, Feb 18, 12:51 PM
Unknown Object (File)
Tue, Feb 3, 11:15 AM
Unknown Object (File)
Sat, Jan 31, 8:41 PM
Unknown Object (File)
Dec 31 2025, 6:08 AM
Unknown Object (File)
Dec 12 2025, 9:22 PM
Subscribers

Details

Reviewers
carlavilla
mhorne
Group Reviewers
manpages
Summary

Markup exit status codes as defined variables. This produces no change
in rendered output, however enables this workflow:

$ apropos Dv=67
sysexits(3) - legacy exit status codes for system programs

MFC after: 3 days

Diff Detail

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

Event Timeline

ziaee requested review of this revision.Jan 23 2025, 1:51 PM

We can quickly enter bikeshed territory debating something like this, but I must ask, is this workflow real or imagined?

It is somewhat of a stretch to declare numeric literals as Dv, that is "defined variable or preprocessor constant"; pedantically they are neither. Of course I favor practicality over pedantics.

Why does the change not add Dv markup for the names of the constants? Is the user any more or less likely to search apropos Dv=EX_USAGE?

I can mostly grasp the rationale of the change, but I think you could do a little more to convince the reader of its value.

I think what I tried to do here would be awesome, but we just don't have a mechanism for it, and abusing Dv further is probably not going in the right direction either. Sorry to leave this open so long.