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

[Brian Inglis]

On 2025-01-12 10:58, Jon Turney wrote:
> On 11/01/2025 00:01, Brian Inglis wrote:
>> Add POSIX new additions available with din entries
>> or interfaces in headers and packages.
> 
> What does 'din' mean in this context?

POSIX entries which exist as exported symbols in cygwin.din but not mentioned 
elsewhere in posix.xml, so supported but not yet documented as any Unix interface.

Suggestions for better phrasings of these welcome.

$ sed '/\s\+(din)$/!d;s!!!;s!^\s\+!!' posix.xml | xargs apropos -m man,linux
getentropy (3)       - fill a buffer with random bytes
getlocalename_l:	nothing appropriate.
in6addr_any:		nothing appropriate.
in6addr_loopback:	nothing appropriate.
posix_getdents:		nothing appropriate.
timespec_get:		nothing appropriate.

Also is anyone aware of a good html to man page converter to generate Cygwin or 
POSIX man pages from HTML sources available, and are cpp-reference GPL-3 
allowed, or should we prefix the function source with the man doc and generate 
it in newlib?

Looks like getlocalename_l doc needs updated to POSIX.1-2024, added to 
locale/Makefile.inc LIBC_CHEWOUT_FILES, and locale.h feature test to 202405L?

Could CHEW doc be added to cygwin/**/*.cc or elsewhere?

-- 
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retrancher  but when there is no more to cut
                                 -- Antoine de Saint-Exupéry