git: e267c40181bf - stable/13 - uname.1: Clarify the -r option

From: Gordon Bergling <gbe_at_FreeBSD.org>
Date: Sat, 24 Sep 2022 07:57:55 UTC
The branch stable/13 has been updated by gbe (doc committer):

URL: https://cgit.FreeBSD.org/src/commit/?id=e267c40181bf71927bd9df8ee6f3019e8ffd8743

commit e267c40181bf71927bd9df8ee6f3019e8ffd8743
Author:     Gordon Bergling <gbe@FreeBSD.org>
AuthorDate: 2022-09-16 11:27:54 +0000
Commit:     Gordon Bergling <gbe@FreeBSD.org>
CommitDate: 2022-09-24 07:57:44 +0000

    uname.1: Clarify the -r option
    
    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
    Reviewed by:    gbe, imp
    Differential Revision:  https://reviews.freebsd.org/D36516
    
    (cherry picked from commit 8f98a937ed726399b89e87e95769a9adc809281a)
---
 usr.bin/uname/uname.1                    | 7 +++++--
 usr.sbin/freebsd-update/freebsd-update.8 | 4 +++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/usr.bin/uname/uname.1 b/usr.bin/uname/uname.1
index a29e7ec2d8af..ff1b3ec5f3f2 100644
--- a/usr.bin/uname/uname.1
+++ b/usr.bin/uname/uname.1
@@ -28,7 +28,7 @@
 .\"	@(#)uname.1	8.3 (Berkeley) 4/8/94
 .\" $FreeBSD$
 .\"
-.Dd November 13, 2020
+.Dd September 14, 2022
 .Dt UNAME 1
 .Os
 .Sh NAME
@@ -82,8 +82,10 @@ uses it to set the
 variable.
 .Pc
 .It Fl r
-Write the current release level of the operating system
+Write the current release level of the kernel
 to standard output.
+.Xr freebsd-version 1
+can be used to print the release level of the userland.
 .It Fl s
 Write the name of the operating system implementation to standard output.
 .It Fl U
@@ -138,6 +140,7 @@ and
 would return
 .Va powerpc64 .
 .Sh SEE ALSO
+.Xr freebsd-version 1 ,
 .Xr feature_present 3 ,
 .Xr getosreldate 3 ,
 .Xr sysctl 3 ,
diff --git a/usr.sbin/freebsd-update/freebsd-update.8 b/usr.sbin/freebsd-update/freebsd-update.8
index 6d7fc792c6f1..3b56d64660a2 100644
--- a/usr.sbin/freebsd-update/freebsd-update.8
+++ b/usr.sbin/freebsd-update/freebsd-update.8
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd April 22, 2022
+.Dd September 10, 2022
 .Dt FREEBSD-UPDATE 8
 .Os
 .Sh NAME
@@ -256,6 +256,8 @@ Default location where
 stores temporary files and downloaded updates.
 .El
 .Sh SEE ALSO
+.Xr freebsd-version 1 ,
+.Xr uname 1 ,
 .Xr freebsd-update.conf 5 ,
 .Xr nextboot 8
 .Sh AUTHORS