git: 9a62cdc01327 - main - intro.2 as errno.2: Use the name macro for errno

From: Warner Losh <imp_at_FreeBSD.org>
Date: Sat, 04 May 2024 14:58:18 UTC
The branch main has been updated by imp:

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

commit 9a62cdc0132720c439313707b5e339dc348b0d45
Author:     Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-05-04 14:54:21 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2024-05-04 14:56:10 +0000

    intro.2 as errno.2: Use the name macro for errno
    
    Reviewed by: imp
    Pull Request:   https://github.com/freebsd/freebsd-src/pull/1192
---
 lib/libsys/intro.2 | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/lib/libsys/intro.2 b/lib/libsys/intro.2
index f10312c1962a..008936b278ae 100644
--- a/lib/libsys/intro.2
+++ b/lib/libsys/intro.2
@@ -32,8 +32,9 @@
 .Dt INTRO 2
 .Os
 .Sh NAME
-.Nm intro
-.Nd introduction to system calls and error numbers
+.Nm intro ,
+.Nm errno
+.Nd introduction to system calls and their error numbers
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
@@ -333,7 +334,7 @@ Table of currently available system calls.
 .Sh ERRORS
 Nearly all of the system calls provide an error number referenced via
 the external identifier
-.Va errno .
+.Nm errno .
 This identifier is defined in
 .In sys/errno.h
 as:
@@ -349,7 +350,7 @@ For the initial thread and
 non-threaded processes,
 .Va __error()
 returns a pointer to a global
-.Va errno
+.Nm errno
 variable that is compatible with the previous definition.
 .Pp
 When a system call detects an error,
@@ -357,12 +358,12 @@ it returns an integer value
 indicating failure
 .Pq usually -1
 and sets the variable
-.Va errno
+.Nm errno
 accordingly.
 This allows interpretation of the failure on receiving
 -1 and to take action accordingly.
 Successful calls never set
-.Va errno ;
+.Nm errno ;
 once set, it remains until another error occurs.
 It should only be examined after an error.
 Note that a number of system calls overload the meanings of these