Page MenuHomeFreeBSD

Improve errno documentation in pthread_create(3) and thr_new(2)
ClosedPublic

Authored by vangyzen on May 31 2016, 7:02 PM.
Tags
None
Referenced Files
Unknown Object (File)
Wed, Jun 26, 8:59 PM
Unknown Object (File)
Mon, Jun 24, 11:06 PM
Unknown Object (File)
Sat, Jun 22, 1:03 AM
Unknown Object (File)
Sat, Jun 15, 9:09 AM
Unknown Object (File)
Sat, Jun 15, 8:55 AM
Unknown Object (File)
Apr 27 2024, 5:12 PM
Unknown Object (File)
Apr 27 2024, 5:11 PM
Unknown Object (File)
Apr 27 2024, 5:09 PM
Subscribers

Details

Summary

Add some missing errno values to thr_new(2) and pthread_create(3). In particular,
EDEADLK was not documented in the latter. While I'm here, improve some English and cross-references.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

vangyzen retitled this revision from to Improve errno documentation in pthread_create(3) and thr_new(2).
vangyzen updated this object.
vangyzen edited the test plan for this revision. (Show Details)
vangyzen added reviewers: kib, jilles.
share/man/man3/pthread_create.3
108 ↗(On Diff #17158)

I do not like a reference to thr_new(2) in the pthrread_create(3), for the basic information about the function behaviour. I.e., I would be fine with .Xr thr_new as a note about implementation. But I think that it is wrong to refer to the implementation man page when describing behavior of the standard-mandated function. This removes the layer of implementation from the reader perception.

Please, list the missed errno values there explicitely.

vangyzen edited edge metadata.

List errno values directly in pthread_create(3) instead of referring
to the implementation's man pages.

vangyzen added inline comments.
share/man/man3/pthread_create.3
108 ↗(On Diff #17158)

This makes sense.

vangyzen edited edge metadata.
kib edited edge metadata.
This revision is now accepted and ready to land.Jun 3 2016, 12:00 AM
This revision was automatically updated to reflect the committed changes.
vangyzen marked an inline comment as done.