Page MenuHomeFreeBSD

services.5: Clarify the formatting of a service line
Needs RevisionPublic

Authored by 0mp on Jun 13 2026, 7:23 PM.
Tags
None
Referenced Files
F164116920: D57564.id179687.diff
Tue, Jul 28, 9:32 PM
Unknown Object (File)
Sat, Jul 25, 8:31 AM
Unknown Object (File)
Fri, Jul 24, 8:36 PM
Unknown Object (File)
Thu, Jul 23, 9:06 AM
Unknown Object (File)
Thu, Jul 23, 1:22 AM
Unknown Object (File)
Tue, Jul 21, 3:36 AM
Unknown Object (File)
Sat, Jul 4, 12:11 PM
Unknown Object (File)
Thu, Jul 2, 1:32 AM
Subscribers

Details

Reviewers
ziaee
Summary

While here:

  • Fix a typo in Nd.
  • Link to the RFC 6335.
  • Link to Service Name and Transport Protocol Port Number Registry.

MFC after: 1 week

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 73854
Build 70737: arc lint + arc unit

Event Timeline

0mp requested review of this revision.Jun 13 2026, 7:23 PM
ziaee requested changes to this revision.Jun 14 2026, 12:45 AM
ziaee added inline comments.
share/man/man5/services.5
36

(no change requested here)
It seems like we capitalize Internet slightly more often than not, but for context, this one is highly contested, The tl;dr is that FAANG, NIST, AP, APA, and Chicago manual of style say it shouldn't be capitalized, while MLA, IETF, and ISOC say it should be. There is even a Wikipedia article on it:

https://en.wikipedia.org/wiki/Capitalization_of_Internet

58
  1. you wrote yourself in style.mdoc that we do not markup commands inside a literal block.
  2. delimiters are not command modifiers, as we have been discussing in the other review.
  3. i think the ... is optional.
114

(no change requested here, just commentary)

We cite RFCs wildly differently across different manpages, I wish we could figure out what is the actual correct way. I could send a mail to mandoc and ask what they think? Alternatively, i heard a rumor that the original mandoc author is coming to bsdcan, maybe we could ask him together?

This revision now requires changes to proceed.Jun 14 2026, 12:45 AM