From d62f3bdc69145384b28a9411533f1dae1c1eb2f9 Mon Sep 17 00:00:00 2001
From: schwarze <schwarze@openbsd.org>
Date: Mon, 9 Oct 2023 19:32:51 +0000
Subject: [PATCH] Mention that the strings are OS-specific. In part based on
 input from deraadt@, OK millert@.

---
 lib/libc/gen/uname.3 | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3
index 1c161d7291f..03d2476584a 100644
--- a/lib/libc/gen/uname.3
+++ b/lib/libc/gen/uname.3
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: uname.3,v 1.18 2022/09/11 06:38:10 jmc Exp $
+.\"	$OpenBSD: uname.3,v 1.19 2023/10/09 19:32:51 schwarze Exp $
 .\"
 .\" Copyright (c) 1994
 .\"	The Regents of the University of California.  All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: September 11 2022 $
+.Dd $Mdocdate: October 9 2023 $
 .Dt UNAME 3
 .Os
 .Sh NAME
@@ -62,6 +62,13 @@ Version level of the operating system.
 .It Fa machine
 Machine hardware platform.
 .El
+.Pp
+These are the same strings that can be displayed with
+.Xr uname 1 .
+Because their format and meaning depends on the operating system,
+trying to parse or interpret them is discouraged in portable code.
+The only reasonable way an application program can use them
+is for displaying them to the user.
 .Sh RETURN VALUES
 The
 .Fn uname
-- 
2.20.1