Mention that the strings are OS-specific.

In part based on input from deraadt@, OK millert@.

diff --git a/lib/libc/gen/uname.3 b/lib/libc/gen/uname.3
index 1c161d7..03d2476 100644 (file)
--- 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