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
F164791453: D36516.diff
Tue, Aug 4, 1:57 AM
Unknown Object (File)
Wed, Jul 22, 4:40 AM
Unknown Object (File)
Tue, Jul 21, 11:46 AM
Unknown Object (File)
Sun, Jul 19, 6:51 PM
Unknown Object (File)
Sat, Jul 18, 9:03 AM
Unknown Object (File)
Jul 4 2026, 2:39 PM
Unknown Object (File)
Jun 17 2026, 11:10 AM
Unknown Object (File)
Jun 10 2026, 5:04 AM
View All 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...