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

Authored by vangyzen on May 31 2016, 7:02 PM.

Details

Reviewers

kib
jilles

Group Reviewers

manpages

Commits

rS301274: Improve errno documentation in pthread_create(3) and thr_new(2)

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 Passed

Unit

No Test Coverage

Build Status

Buildable 4088
Build 4131: arc lint + arc unit

Event Timeline

vangyzen updated this revision to Diff 17158.May 31 2016, 7:02 PM

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.

Herald added a reviewer: manpages. · View Herald TranscriptMay 31 2016, 7:02 PM

Herald added a subscriber: imp. · View Herald Transcript

kib added inline comments.May 31 2016, 7:08 PM

share/man/man3/pthread_create.3
108	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.