Page MenuHomeFreeBSD

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

Authored by 0mp on Sat, Jun 13, 7:23 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Jun 23, 12:38 PM
Unknown Object (File)
Thu, Jun 18, 10:38 PM
Unknown Object (File)
Wed, Jun 17, 11:30 PM
Unknown Object (File)
Wed, Jun 17, 7:19 PM
Unknown Object (File)
Tue, Jun 16, 7:18 PM
Unknown Object (File)
Tue, Jun 16, 7:18 PM
Unknown Object (File)
Sun, Jun 14, 6:24 PM
Unknown Object (File)
Sat, Jun 13, 9:06 PM
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.Sat, Jun 13, 7:23 PM
ziaee requested changes to this revision.Sun, Jun 14, 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.Sun, Jun 14, 12:45 AM