Re: git: f5a37f8dd319 - main - open(2): mandoc -T lint
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 >