Page MenuHomeFreeBSD
Differential D36516

uname(1): Clarify the -r option
ClosedPublic
Actions

Authored by gbe on Sep 10 2022, 12:21 PM.
Tags
None
Referenced Files
F122157531: D36516.diff
Wed, Jul 2, 7:32 PM
F122155958: D36516.id110629.diff
Wed, Jul 2, 7:11 PM
Unknown Object (File)
Wed, Jul 2, 11:15 AM
Unknown Object (File)
Mon, Jun 30, 7:42 AM
Unknown Object (File)
Sat, Jun 21, 6:01 PM
Unknown Object (File)
Sat, Jun 21, 6:14 AM
Unknown Object (File)
Wed, Jun 18, 9:19 AM
Unknown Object (File)
Mon, Jun 16, 1:55 AM
View All 82 Files
Subscribers
grahamperrin
imp

Details

Reviewers
rwatson
gbe
Group Reviewers
manpages
Commits
rG893f51161718: uname.1: Clarify the -r option
rGe267c40181bf: uname.1: Clarify the -r option
rG8f98a937ed72: uname.1: Clarify the -r option
Summary

It is some times hard to understand the difference between
kernel version and userland version. So clarify the -r option
of uname(1) in terms of a printed kernel version.

While here, add some cross references:

  • cross reference freebsd-version(1) in uname(1)
  • cross reference freebsd-version(1) and uname(1) in freebsd-update(8)

PR: 265594
Reported by: rwatson
MFC after: 1 week

Test Plan

mandoc output review and 'mandoc -Tlint' checks

Diff Detail

Repository
rG FreeBSD src repository
Lint
Lint Passed
Unit
No Test Coverage
Build Status
Buildable 47374
Build 44261: arc lint + arc unit

Event Timeline

gbe created this revision.Sep 10 2022, 12:21 PM
Herald added a subscriber: imp. · View Herald TranscriptSep 10 2022, 12:21 PM
gbe requested review of this revision.Sep 10 2022, 12:21 PM
Harbormaster completed remote builds in B47320: Diff 110423.Sep 10 2022, 12:21 PM
grahamperrin added a subscriber: grahamperrin.Sep 10 2022, 2:35 PM
imp added inline comments.Sep 11 2022, 11:17 PM
usr.bin/uname/uname.1
85–89

Why not just s/operating system/the kernel/ in the prior sentence and not insert the first of these two sentences?

gbe updated this revision to Diff 110538.Sep 14 2022, 8:01 AM
  • Condense the description of the -r flag
Harbormaster completed remote builds in B47374: Diff 110538.Sep 14 2022, 8:01 AM
gbe marked an inline comment as done.Sep 14 2022, 8:01 AM
gbe accepted this revision.Sep 16 2022, 11:18 AM
This revision is now accepted and ready to land.Sep 16 2022, 11:18 AM
Closed by commit rG8f98a937ed72: uname.1: Clarify the -r option (authored by gbe). · Explain WhySep 16 2022, 11:30 AM
This revision was automatically updated to reflect the committed changes.
gbe added a commit: rG8f98a937ed72: uname.1: Clarify the -r option.
gbe added a commit: rGe267c40181bf: uname.1: Clarify the -r option.Sep 24 2022, 7:59 AM
gbe added a commit: rG893f51161718: uname.1: Clarify the -r option.
egypcio mentioned this in D36241: freebsd-update(8): add new command to 'check' for available updates only.Sep 27 2022, 9:45 AM

Revision Contents
Changeset List

PathSize
usr.bin/
uname/
7 lines
usr.sbin/
freebsd-update/
4 lines

Diff 110538

View Options

usr.bin/uname/uname.1

Loading...
View Options

usr.sbin/freebsd-update/freebsd-update.8

Loading...