Details
- Reviewers
- None
- Group Reviewers
manpages - Commits
- rGb3ee318b79d5: domains: rewrite documentation to describe present state
Diff Detail
- Repository
- rG FreeBSD src repository
- Lint
Lint Skipped - Unit
Tests Skipped - Build Status
Buildable 47382 Build 44269: arc lint + arc unit
Event Timeline
| share/man/man9/domain.9 | ||
|---|---|---|
| 36 | This can be word-smithed, I think. | |
| 55 | A bit of word-smithing here too, might need to reflow the entire paragraph as a result. | |
| 59 | Missing particle here. | |
| 65 | There's a non-specific reference here, and I think the sentence can benefit from being rewritten but without understanding the reference I'm not having much luck coming up with something. | |
| 121 | Missing particle here, paragraph might need to be reflowed. | |
| 216 | I'd suggest using existing "X first appeared in N", as that's common across a wide variety of manual pages. | |
Partial review, will resume when brain and keyboard both cooperate.
| share/man/man9/domain.9 | ||
|---|---|---|
| 36 | Is that about kernel implementation of sockets for use by userland, or a kernel-internal API? | |
| 55 | Alternative rewording | |
| 59 | 2 missing articles, not 1. I'm undecided about "an application", "the application", or "applications".11 | |
| 61–67 | What I think this likely means, clarified and copyedited. | |
| 65 | See my guess below. | |
| 68–70 | There aren't 3 "protocol" argument, only one (which is 3rd in the argument list) | |
| 72 | "shall" as a future imperative modal is pretty much extinct. | |
| share/man/man9/domain.9 | ||
|---|---|---|
| 166 | .Xr SYSINIT 9 You might add it to SEE ALSO as well/instead. | |