On 2025-01-13 05:38, Corinna Vinschen wrote:
On Jan 12 12:56, Brian Inglis wrote:
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.
"Add POSIX new additions available as symbols exported from the Cygwin
DLL, as header macros and inline functions, or exported from external
Cygwin distro libs."
Forgot about making distinction between newlib and Cygwin functions:
Add POSIX new additions available as header macros and inline functions,
or exported by Cygwin distro DLL or library packages?
Mark din entries as Cygwin DLL and others as Cygwin PKG...?
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?
What man pages are you looking for? We have the man-pages-posix package
and we only have it because we have the official permission to do so.
Keep in mind that all man pages not part of the newlib-cygwin dir are
potentially copyrighted.
Latter four above - Cygwin only: very aware of sources and permissions.
Also aware that Austin Group want to keep nroff sources from being distributed
and linux-man maintainer is inactive but participating.
Only getentropy_r is documented in:
/usr/src/newlib-cygwin/newlib/libc/reent/getentropyr.c
and it is in CHEW files in:
/usr/src/newlib-cygwin/newlib/libc/reent/Makefile.inc
but not included in list of functions in:
/usr/src/newlib-cygwin/newlib/libc/reent/reent.tex
and nor are any of the CHEW outputs in libc.info?
Looks like getlocalename_l doc needs updated to POSIX.1-2024, added to
locale/Makefile.inc LIBC_CHEWOUT_FILES
Thanks, done.
and locale.h feature test to
202405L?
That's already fixed since ca31784fef301 ("Fix POSIX guards for
POSIX.1-2024 extensions")
Could CHEW doc be added to cygwin/**/*.cc or elsewhere?
Elsewhere, yes. Inline might be a problem. Newlib has only very few
exported symbols per file, so a single file usually matches with a
single doc. I don't want to imagine adding docs inline to syscalls.cc :}
The latter are only relevant to Cygwin and could be added to each .cc file if
they could be CHEWed and combined, or in doc only CHEW inputs 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
