On Jan 13 11:57, Brian Inglis wrote: > On 2025-01-13 05:38, Corinna Vinschen wrote: > > On Jan 12 12:56, Brian Inglis wrote: > > > 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?
Good enough. > Mark din entries as Cygwin DLL and others as Cygwin PKG...? Sorry, I don't understand this question. Can you make a two-line example what you mean? > > > 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. They would have to be provided by the man-pages-posix package at one point. > Also aware that Austin Group want to keep nroff sources from being > distributed ??? I'm not even aware where I could get the original nroff sources from the Open Group. Since 2015, we have an official permission from the Open Group to distribute the POSIX man pages with Cygwin, but for the nroff sources I was just relying on the Linux version of that package from https://www.kernel.org/pub/linux/docs/man-pages/man-pages-posix/ Seems like the package has been pulled from Fedora, though. I'm sure I installed it once, and the files are still under my /usr/share/man/man3p directory on my Fedora, but the files are not owned by any package. I vaguely remember there was "something"... > and linux-man maintainer is inactive but participating. I assume (i.e. hope) he or she will update to 2024 at one point? Otherwise, yeah, would be great being able to generate man pages from > 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? I'm not deep in this documentation creation thingy. If something's amiss there, feel free to provide patches. Corinna
