On 2025-01-15 05:18, Corinna Vinschen wrote:
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.
Add note (Cygwin DLL) to remind us there are no docs yet.
Add availability notes for others, for example:
+ be64toh (available in "endian.h" header)
bind
+ bind_textdomain_codeset (available in external gettext "libintl"
library)
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
They are not going to make the original man-pages-posix sources available,
except under licence to a maintainer, similar to their current online HTML and
PDF offerings, which are for fair (FYI quotes), personal, or research use only.
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/
I am maintainer of that Cygwin package since the last update to POSIX 2017a in
2021 from kernel.org.
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"...
Fedora RPMs gone but still in F34 spec and on Repology under RPM Fusion Fedora
(below) and OpenSuSE!
%changelog
* Tue Aug 09 2022 Nikola Forró <nfo...@redhat.com> - 5.12-3
- Remove POSIX man pages due to disallowed license resolves: #2116859
https://download1.rpmfusion.org/nonfree/fedora/development/rawhide/Everything/source/SRPMS//m/man-pages-posix-2017a-4.fc41.src.rpm
and linux-man maintainer is inactive but participating.
I assume (i.e. hope) he or she will update to 2024 at one point?
Alex resigned due to lacks of ???, but still posting, so unlikely.
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.
Working on it, also sources for others above.
I have for a tendency to prefer info over man pages when available, possibly due
to xrefs and links.
Please consider applying the revised v6 initial patches 1-5, as I have
discovered the limitations of interactive cherry-picking only selecting *MOST*
hunks, and I can not get that final abbreviation patch 8/8 changes out of my
current branch tree, no matter what I reset to from the log or branch reflog.
I may just have to reset hard and patch! ;^>
Please also have a look at revised v6 patches 6-7, where I have combined entries
from the same man page, for most cases where it makes sense, and possible
without too long lines in posix.xml.
If you just leave the entries in ASCII order, per Jon's feedback, c'est la vie.
--
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
