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

From: Yuri Pankov <yuri_at_aetern.org>
Date: Tue, 27 Aug 2024 22:12:48 UTC
Konstantin Belousov wrote:
> 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

This looks wrong, we now have fs man pages in section 4.

>  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
>