freebsd-src icon indicating copy to clipboard operation
freebsd-src copied to clipboard

sysexits: tidy deprecated header and manual

Open concussious opened this issue 1 year ago • 5 comments

I was originally intending to rewrite intro.1 but then I thought it really needs to go in sysexits.{3/h}. Is my syntax for the commit log correct? Some of these sentences are verbatim not mine.

Thank you so much for going out of your way to include me in this game, it's really enriching my life and very meaningful to me.

concussious avatar Apr 24 '24 15:04 concussious

Sorry for the false start (I'm going to ask you to undo a couple of this, for which I apologize).

No need to apologize, seriously, thank you.

How's this latest one?

concussious avatar Apr 24 '24 23:04 concussious

I'll review this in the morning

bsdimp avatar Apr 25 '24 05:04 bsdimp

Related: https://reviews.freebsd.org/D27176

0mp avatar Apr 26 '24 12:04 0mp

I don't know how to proceed from here since this is basically a duplicate of what's already being worked on.

In the differential thread, jilles mentioned some other common exit codes. I think they should be noted in the system manual somewhere, and this seems like the place even though it's describing the sysexits interface.

From what I've been able to find (which may not be exhaustive), there's only errno(2) for syscalls and sysexits(3) for programs, so... this seems like the place?

concussious avatar Apr 26 '24 20:04 concussious

Proposed changes to intro(1) exit status reverted. Even though it's part of this idea, I'm thinking it should be its own discussion. The changes here don't make any of it incorrect.

Edit: but I did put an altered line from intro(1) (that otherBSDs trimmed) into the first sentance of sysexits(3).

Attempting to preserve the brevity we've arrived at, while still explaining what the manual page is about.

concussious avatar Apr 29 '24 18:04 concussious

I'm landing this in preference to the alternatives.

bsdimp avatar May 10 '24 02:05 bsdimp