timeout.1: Add a STANDARDS section
Needs ReviewPublic
Actions

Authored by gbe on Jun 22 2024, 8:23 AM.

Details

Reviewers

bapt
bcr

Group Reviewers

manpages

Commits

rG6b151ad1c83a: timeout(1): Update STANDARDS section
rG044f94adff55: timeout(1): Update STANDARDS section

Summary

timeout(1) is now defined in IEEE Std 1003.1-2024 ("POSIX.1")
and is complaint with the specification.

Since our mandoc version is lacking the new specification,
add it to it.

Obtained from: OpenBSD
MFC after: 1 week

Test Plan

build world following 'mandoc -Tlint checks' and mandoc output review

Diff Detail

Repository

rG FreeBSD src repository

Lint

Lint Not Applicable

Unit

Tests Not Applicable

Event Timeline

gbe created this revision.Jun 22 2024, 8:23 AM

Herald added a subscriber: imp. · View Herald TranscriptJun 22 2024, 8:23 AM

gbe requested review of this revision.Jun 22 2024, 8:23 AM

Harbormaster completed remote builds in B58301: Diff 140102.Jun 22 2024, 8:23 AM

I like this. Please 40m42.

Edit: for st.c, sorry!

Looks good to me, thanks!

This revision is now accepted and ready to land.Jun 27 2024, 6:56 PM

imp added inline comments.Jun 27 2024, 7:13 PM

bin/timeout/timeout.1
201	Don't we need the more vague "is expected to comply with the" since we've not even run the certification tests on it yet, let alone gone for the Open Source cert program?

bapt accepted this revision.Jun 28 2024, 7:14 AM

Closed by commit rG044f94adff55: timeout(1): Update STANDARDS section (authored by gbe). · Explain WhySep 24 2024, 4:43 PM

This revision was automatically updated to reflect the committed changes.

gbe added a commit: rG044f94adff55: timeout(1): Update STANDARDS section.

gbe added a commit: rG6b151ad1c83a: timeout(1): Update STANDARDS section.Oct 18 2024, 6:57 AM

Hello.

Well, you cannot just declare timeout(1) is compliant with (or even is expected to conform to) the POSIX.1-2024 Standard without actually updating it.
Actually, the current version has several behaviors (e.g., signal catching, signal propagation) that don't comply with the Standard.

So I've put quite some efforts into making timeout(1) to conform to the Standard, and I've just pushed the code in the DragonFly BSD codebase. See commits from c9f09d1fdc1a39eec5047998927cf09ee14e5251 to 694b470d432b40a430fa1f075b0c4a40ac1df553.
Please take a look and hope it's helpful.

Standard spec: https://pubs.opengroup.org/onlinepubs/9799919799/utilities/timeout.html