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

Authored by gbe on Sep 10 2022, 12:21 PM.

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?

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

Path

Size

usr.bin/

uname/

uname.1

7 lines

usr.sbin/

freebsd-update/

freebsd-update.8

4 lines

Diff 110538

View Options

usr.bin/uname/uname.1