[PATCH v6 2/8] Cygwin: winsup/doc/posix.xml: SUS V5 POSIX 2024 new additions available

[Corinna Vinschen]

On Jan 16 15:18, Brian Inglis wrote:
> On 2025-01-16 11:40, Corinna Vinschen wrote:
> > On Jan 15 12:39, Brian Inglis wrote:
> > > diff --git a/winsup/doc/posix.xml b/winsup/doc/posix.xml
> > > index 949333b0c36c..0b23a2251028 100644
> > > --- a/winsup/doc/posix.xml
> > > +++ b/winsup/doc/posix.xml
> > > @@ -16,6 +16,9 @@ ISO/IEC DIS 9945 Information technology
> > >   - Issue 8.</para>
> > >   <screen>
> > > +    CMPLX			(available in "complex.h" header)
> > > +    CMPLXF			(available in "complex.h" header)
> > > +    CMPLXL			(available in "complex.h" header)
> 
> Missing from 3.5 - only available with 3.6 - and no docs, info, man.

The patches will go into the main branch only anyway.  There's really
no good reason to mention the headers here.

> > > +    bind_textdomain_codeset	(available in external gettext "libintl" library)
> > > +    bindtextdomain		(available in external gettext "libintl" library)
> > > [...]
> > 
> > Either "gettext" or "libintl", not both.
> 
> Which do you think most useful?

libintl, along the lines of the existing entries

  dbm_clearerr		(available in external "libgdbm" library)
  iconv			(available in external "libiconv" library)
  xdr_array		(available in external "libtirpc" library)

There's a bug in crypt/encrypt/setkey/crypt_r, which should be
changed to

  crypt                 (available in external "libcrypt" library)

I'll fix them separately.

> > > +    getentropy		(Cygwin DLL)
> > > +    getlocalename_l		(Cygwin DLL)
> > > +    in6addr_any		(Cygwin DLL)
> > > +    in6addr_loopback	(Cygwin DLL)
> > > +    posix_getdents		(Cygwin DLL)
> > > +    timespec_get		(Cygwin DLL)
> 
> Lack of docs, info, man - except getentropy_r is in libc/reent/, should be
> included with others from reent.tex, added to CHEW doc, and getentropy
> implementation and doc could be added?

The lack of docs doesn't mean it's necessary to mention in the list of
implemented functions that those are implemented in Cygwin.  This is
implied by them showing up in the list, right?


Corinna