git: f5a37f8dd319 - main - open(2): mandoc -T lint

From: Konstantin Belousov <kib_at_FreeBSD.org>
Date: Tue, 27 Aug 2024 22:09:53 UTC
The branch main has been updated by kib:

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

commit f5a37f8dd319e3007b126b77376e61ad96f44d8b
Author:     Jose Luis Duran <jlduran@gmail.com>
AuthorDate: 2024-08-27 03:48:09 +0000
Commit:     Konstantin Belousov <kib@FreeBSD.org>
CommitDate: 2024-08-27 22:09:33 +0000

    open(2): mandoc -T lint
    
    Lint the manual, addressing almost all requests.
    
    Differential revision:  https://reviews.freebsd.org/D46450
    MFC after:   1 week
---
 lib/libsys/open.2 | 15 +++++++++------
 1 file changed, 9 insertions(+), 6 deletions(-)

diff --git a/lib/libsys/open.2 b/lib/libsys/open.2
index be164aae1834..220561cc5683 100644
--- a/lib/libsys/open.2
+++ b/lib/libsys/open.2
@@ -252,7 +252,7 @@ controlling terminal when it opens a tty device.
 This is the default on
 .Fx ,
 but is present for
-.Tn POSIX
+POSIX
 compatibility.
 The
 .Fn open
@@ -265,7 +265,7 @@ initially opening a TTY.
 This is the default on
 .Fx ,
 but is present for
-.Tn POSIX
+POSIX
 compatibility.
 The initial call to
 .Fn open
@@ -384,7 +384,7 @@ The file pointer used to mark the current position within the
 file is set to the beginning of the file.
 .Pp
 If a sleeping open of a device node from
-.Xr devfs 4
+.Xr devfs 5
 is interrupted by a signal, the call always fails with
 .Er EINTR ,
 even if the
@@ -487,7 +487,7 @@ The system file table is full.
 .It Bq Er EMLINK
 .Dv O_NOFOLLOW
 was specified and the target is a symbolic link.
-.Tn POSIX
+POSIX
 specifies a different error for this case; see the note in
 .Sx STANDARDS
 below.
@@ -661,7 +661,7 @@ to
 .Er EMLINK instead of
 .Er ELOOP
 as specified by
-.Tn POSIX
+POSIX
 when
 .Dv O_NOFOLLOW
 is set in flags and the final component of pathname is a symbolic link
@@ -679,7 +679,10 @@ permits searches.
 The present implementation of the
 .Fa openat
 system call is believed to be compatible with
-.St -p1003.1-2017 ,
+.\" .St -p1003.1-2017 ,
+.\" XXX: This should be replaced in the future when an appropriate argument to
+.\" the St macro is available: -p1003.1-2017
+.No IEEE Std 1003.1-2008, 2017 Edition (\\(LqPOSIX.1\\(Rq) ,
 which specifies that behavior for
 .Dv O_SEARCH ,
 in the absence of the flag the implementation checks the current