Hi Jorge, [Please keep the mailing list in CC] > Date: 2026-11-18 10:16:51+0000 > From: Jorge Almeida > > On Wed, 18 Nov 2026 at 00:45, Alejandro Colomar > wrote: > > > > > > > > commit 7b4329e4945b1506f75c67c18730ad0191e09fb0 > > Author: Alejandro Colomar > > Date: 2026-11-18 01:38:13 +0100 > > > > man/man3/opendir.3: fdopendir(): Use wording mirroring that of fdopen(3) > > > > The old documentation didn't clarify whether the position indicator was > > reset or was that of the existing file descriptor. Let's use wording > > mirroring fdopen(3), which already made this clear. This makes the > > pages more consistent. > > > > Reported-by: Jorge Almeida > > Message-ID: > > Signed-off-by: Alejandro Colomar > > > > diff --git a/man/man3/opendir.3 b/man/man3/opendir.3 > > index 443ea8f3dd0a..8184844893b9 100644 > > --- a/man/man3/opendir.3 > > +++ b/man/man3/opendir.3 > > @@ -43,16 +43,16 @@ .SH DESCRIPTION > > The > > .BR fdopendir () > > function > > -is like > > -.BR opendir (), > > -but returns a directory stream for the directory referred > > -to by the open file descriptor > > +associates a directory stream > > +with the existing directory file descriptor, > > .IR fd . > > -After a successful call to > > -.BR fdopendir (), > > -.I fd > > -is used internally by the implementation, > > -and should not otherwise be used by the application. > > +The stream position indicator of the new directory stream > > +is set to that belonging to > > +.IR fd . > > +The file descriptor is not dup'ed, > > +and will be closed when the directory stream created by > > +.BR fdopendir () > > +is closed. > > .SH RETURN VALUE > > The > > .BR opendir () > > > > Let me know if you'd apply any changes after this patch. > > > > > > Cheers, > > Alex > > > > Clear enough. Thanks! > However, "with the existing directory file descriptor" > misses the "open". I believe O_PATH is not enough! Indeed, I was also concerned that we were removing that. But fdopen(3) didn't say "open", so I copied it from there. Now we should add "open" to both pages. Would you mind sending a patch? Even without being comfortable with man(7), it should be trivial. :) Have a lovely day! Alex > > Cheers > > Jorge --