Page MenuHomeFreeBSD

sysexits.3: Enable apropos by error number
Needs ReviewPublic

Authored by ziaee on Thu, Jan 23, 1:51 PM.
Tags
None
Referenced Files
Unknown Object (File)
Thu, Jan 30, 4:17 AM
Unknown Object (File)
Wed, Jan 29, 10:33 PM
Unknown Object (File)
Wed, Jan 29, 10:05 PM
Unknown Object (File)
Wed, Jan 29, 7:35 PM
Unknown Object (File)
Wed, Jan 29, 6:39 PM
Unknown Object (File)
Wed, Jan 29, 3:30 PM
Unknown Object (File)
Sat, Jan 25, 6:13 PM
Unknown Object (File)
Sat, Jan 25, 4:04 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.Thu, Jan 23, 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.